PortableInfobox/README.md

32 lines
1.8 KiB
Markdown
Raw Normal View History

2018-07-23 18:57:51 +00:00
# mediawiki-PortableInfobox
Port of FANDOM's https://github.com/Wikia/app/tree/dev/extensions/wikia/PortableInfobox extension to the MediaWiki 1.31+
## Installation
Grab the latest release from [GitHub](https://github.com/Luqgreg/mediawiki-PortableInfobox/releases/latest) and unpack it into `extensions\PortableInfobox` directory in your MediaWiki installation or clone this repository, by using these commands:
```bash
cd extensions
git clone https://github.com/Luqgreg/mediawiki-PortableInfobox.git --branch master --depth=1
```
and add the following code at the bottom of [LocalSettings.php](https://www.mediawiki.org/wiki/Manual:LocalSettings.php):
```php
wfLoadExtension( 'PortableInfobox' );
```
## Configuration
You can use several variables to modify extension's behaviour:
- `$wgAllInfoboxesMiserMode` (bool) - force AllInfoboxes query to be cached, even if `$wgMiserMode` is disabled. (default: true)
- `$wgAllInfoboxesSubpagesBlacklist` (array) - list of subpages in template namespace to omit by AllInfoboxes query. (default: [ "doc", "draft", "test" ])
- `$wgPortableInfoboxCustomImageWidth` (int) - size of image thumbnails used in infoboxes. (default: 300)
## Usage
See: https://community.wikia.com/wiki/Help:Infoboxes
## User-facing differences from the original version
- Europa theme was removed.
- `.pi-theme-default` class is applied instead of `.pi-theme-wikia` to the infobox, when no theme is specified.
- When a `<gallery>` tag is passed to the infobox with images without captions, file name is used instead of not showing the image.
- When embedding a video in the infobox additional class `.pi-video` is added to the `<figure>` tag.
- Videos use `<video>` tags instead of showing video in a modal after clicking a thumbnail.
- Mobile skin doesn't get separate styling.
- It may be *a little* more buggy :)