Skip to content

utdrwiki/PortableInfobox

 
 

Repository files navigation

PortableInfobox

Port of FANDOM's https://github.com/Wikia/app/tree/dev/extensions/wikia/PortableInfobox extension to MediaWiki 1.43.0+ (1.36-1.42 are available in release branches)

Installation

Grab the latest release from GitHub and unpack it into extensions\PortableInfobox directory in your MediaWiki installation or clone this repository, by using these commands:

cd extensions
git clone https://github.com/Universal-Omega/PortableInfobox.git --depth=1

and add the following code at the bottom of LocalSettings.php:

wfLoadExtension( 'PortableInfobox' );

Configuration

You can use several variables to modify extension's behaviour:

  • $wgAllInfoboxesExcludedSubpages (array) - list of subpages in template namespace to omit by AllInfoboxes query. (default: [ "doc", "draft", "test" ])
  • $wgPortableInfoboxCacheRenderers (bool) - cache internal infobox renderers. (default: true)
  • $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 incompatibilities with other extensions. (default: true)
  • $wgPortableInfoboxUseTidy (bool) - use RemexHtml for validating HTML in infoboxes (default: true)
  • $wgPortableInfoboxResponsiblyOpenCollapsed (bool) - open collapsed groups when the screen is narrow. (default: true)
  • $wgPortableInfoboxUseFileDescriptionPage (bool) - control whether or not embedded images in the infobox will link to their file description page instead of directly to the file. (default: false)

Parsoid

PortableInfobox has support for displaying infoboxes when rendering an article using Parsoid. This has been tested against MediaWiki 1.45 and is not guaranteed to work in earlier versions.

There are still some issues, and the implementation is not bug free, however it should display most infoboxes - infoboxes will also display in the VisualEditor.

When using PortableInfoboxes and Parsoid, you must set $wgPortableInfoboxUseHeadings = false otherwise Parsoid will wrap the headings in the infobox in section tags which will break formatting and styling.

Usage

See: https://community.fandom.com/wiki/Help:Infoboxes

<media /> tag

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

  • <default>
  • <caption>

Aliases

  • <audio /> - variation of <media /> tag that allows only audio files
  • <image /> - variation of <media /> tag that allows only images and videos (for backwards compatibilty, can be disabled with video="false")
  • <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.
  • 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 except floating and collapsing group features are disabled by default. Set $wgPortableInfoboxResponsiblyOpenCollapsed to false if you need collapsing group on mobile.
  • It may be a little more buggy :)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • PHP 85.3%
  • JavaScript 7.8%
  • Less 4.5%
  • Handlebars 2.4%