Jump to content

Extension:HoverGallery

From mediawiki.org
MediaWiki extensions manual
HoverGallery
Release status: beta
Implementation Tag , Skin
Description Adds ‎<hovergallery> tags that creates galleries exactly like the standard ones, except that when the mouse hovers over the thumbnails, the full-size images are displayed.
Author(s) Sophivorustalk
Latest version 1.2 (2020-10-27)
MediaWiki 1.25+
PHP 5.3+
Database changes No
License GNU General Public License 3.0
Download
Example [1]
‎<hovergallery>
Quarterly downloads 8 (Ranked 132nd)
Translate the HoverGallery extension if it is available at translatewiki.net

The HoverGallery extension adds ‎<hovergallery> tags that creates galleries exactly like the standard ones, except that when the mouse hovers over the thumbnails, the full-size images are displayed.

Installation

[edit]
  • Download and move the extracted HoverGallery folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HoverGallery
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'HoverGallery' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Usage

[edit]

The ‎<hovergallery> tags are used exactly like the <gallery> tags. To create a basic hover gallery, simply write:

<hovergallery>
Image:abc.jpg
Image:xyz.jpg
</hovergallery>

By default, when the mouse hovers over a thumbnail, the full image is shown. But the full image may sometimes be too big, so there are two optional parameters, maxhoverwidth and maxhoverheight, that limit the max width and height of the full image. An example using those parameters would be:

<hovergallery maxhoverwidth=800 maxhoverheight=800>
Image:abc.jpg
Image:xyz.jpg
</hovergallery>

All the standard gallery parameters are still available, for example:

<hovergallery mode=packed caption="This is a hover gallery">
Image:abc.jpg
Image:xyz.jpg
</hovergallery>