Extension:PortableInfobox

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
PortableInfobox
Release status: beta
Implementation Tag
Description Port of FANDOM's PortableInfobox extension to the MediaWiki 1.27+
Author(s) Luqgreg,
Wikia, Inc (original version)
Latest version 0.3 (2018-10-19)
Compatibility policy master
MediaWiki 1.27+
Database changes No
License GNU General Public License 3.0 or later
Download
README
Parameters
  • $wgAllInfoboxesSubpagesBlacklist
  • $wgPortableInfoboxCustomImageWidth
  • $wgPortableInfoboxUseHeadings
  • $wgPortableInfoboxUseTidy
Tags
<infobox>
Hooks used
ParserFirstCallInit
ParserAfterTidy
BeforeParserrenderImageGallery
ArticlePurge
PageContentSave
wgQueryPages
Hooks provided
AllInfoboxesQueryRecached
Translate the PortableInfobox extension if it is available at translatewiki.net
Check usage and version matrix.
Issues Open issues · Report a bug

The PortableInfobox extension allows to create portable infoboxes, which can be rendered using clean semantic HTML markup on any skin or platform using easy to understand powerful XML-like markup. It is a port of FANDOM's PortableInfobox extension to the newer MediaWiki versions.

Installation[edit]

  • Download and place the file(s) in a directory called PortableInfobox in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'PortableInfobox' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration parameters[edit]

$wgAllInfoboxesSubpagesBlacklist (array)
List of subpages in template namespace to omit by API 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 with other extensions. (default: true)
$wgPortableInfoboxUseTidy (bool)
Use RemexHtml for validating HTML in infoboxes. (default: true)

Usage[edit]

See Help:Infoboxes/Tags on FANDOM

<media /> tag[edit]

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[edit]

  • source - name of the parameter
  • audio - If set to false, it ignores all audio files
  • image - If set to false, it ignores all images
  • video - If set to false, it ignores all videos

Child tags[edit]

  • <default>
  • <caption>

Aliases[edit]

  • <audio /> - variation of <media /> tag that allows only audio files
  • <image /> - variation of <media /> tag that allows only images and videos (for backwards compatibility, can be disabled with video="false")
  • <video /> - variation of <media /> tag that allows only videos

User-facing differences from the original version[edit]

  • 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.
  • 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.