Skip to content

Commit

Permalink
Update README and bump version to 0.3 馃帀
Browse files Browse the repository at this point in the history
  • Loading branch information
lkucharczyk committed Oct 19, 2018
1 parent 3c95bc4 commit bd34f7b
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 5 deletions.
12 changes: 8 additions & 4 deletions README.md
@@ -1,5 +1,5 @@
# mediawiki-PortableInfobox
Port of FANDOM's https://github.com/Wikia/app/tree/dev/extensions/wikia/PortableInfobox extension to the MediaWiki 1.31+
Port of FANDOM's https://github.com/Wikia/app/tree/dev/extensions/wikia/PortableInfobox extension to the MediaWiki 1.27+

## 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:
Expand All @@ -17,12 +17,14 @@ wfLoadExtension( 'PortableInfobox' );
You can use several variables to modify extension's behaviour:
- `$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)
- `$wgPortableInfoboxUseHeadings` (bool) - use heading tags for infobox titles and group headers, it may cause [incompatibilites](https://github.com/Luqgreg/mediawiki-PortableInfobox/issues/15) with other extensions. (default: true)
- `$wgPortableInfoboxUseTidy` (bool) - use [RemexHtml](https://www.mediawiki.org/wiki/RemexHtml) for validating HTML in infoboxes (default: true)

## Usage
See: https://community.wikia.com/wiki/Help:Infoboxes

### `<media />` tag
In the dev version, the `<media/>` tag was introduced in favor of `<image/>`, which still works (see (#aliases)). It allows users to embed images, videos, and audio files in the infobox, in the same way as `<image />` tag does in the original version.
In the 0.3 version, the `<media/>` tag was introduced in favor of `<image/>`, which still works (see Aliases). It allows users to embed images, videos, and audio files in the infobox, in the same way as `<image />` tag does in the original version.

#### Attributes
- `source` - name of the parameter
Expand All @@ -40,13 +42,15 @@ In the dev version, the `<media/>` tag was introduced in favor of `<image/>`, wh
- `<video />` - variation of `<media />` tag that allows only videos

## User-facing differences from the original version
- It's based on Wikia/app@b9fcbe5d6db928e318d64ad0568ec2d09a3f406e and there might be some features, that were introduced in the original version at a later date, but they're absent here
- It's based on [Wikia/app@b9fcbe5d6db928e318d64ad0568ec2d09a3f406e](https://github.com/Wikia/app/tree/b9fcbe5d6db928e318d64ad0568ec2d09a3f406e/extensions/wikia/PortableInfobox) and there might be some features, that were introduced in the original version at a later date, but they're absent here.
- 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.
- `.pi-image` class is no longer present in the `<figure>` tag with a video, instead `.pi-media` class is applied to **all** media elements.
- `.pi-image-collection` classes were changed to `.pi-media-collection`.
- `accent-color-*` attributes allow more color formats.
- More HTML tags are allowed in captions.
- Mobile skin doesn't get separate styling.
- It may be *a little* more buggy :)
- It may be *a little* more buggy :)
2 changes: 1 addition & 1 deletion extension.json
Expand Up @@ -6,7 +6,7 @@
],
"url": "https://github.com/Luqgreg/mediawiki-PortableInfobox",
"descriptionmsg": "portable-infobox-desc",
"version": "0.3-dev",
"version": "0.3",
"type": "parserhook",
"license-name": "GPL-3.0-or-later",
"requires": {
Expand Down

0 comments on commit bd34f7b

Please sign in to comment.