Template:ImageStackPopup/doc
 | This template is a template gadget. It requires the ImageStackPopup gadget to work, which is loaded automatically when this template is used. |
Use this template to generate an image with a play button. When you click it, it shows a popup with images in a slider viewer, suitable for looking at series of medical data, such as CT or MRI scans.
See the installation instructions to get it working in your wiki.
The list parameter references a page with a fragment. E.g. Template:ImageStackPopup/list#medical, will use the image list with the id "medical" from the page Template:ImageStackPopup/list as the list of images. Keep in mind that all images should have the same size (and especially same aspect ratio). Generally the list page would have code like <gallery widths=700 heights=700 id="medical">File:first.png...</gallery> on it.
e.g.
{{ImageStackPopup
|start = 177
|list = Template:ImageStackPopup/list#medical
|caption = This is my caption
|title = Window Title
|file = [[File:Appendicitis (CT angiogram) (Radiopaedia 154713-127660 Axial 1).jpg|link=|thumb|left|upright=1.3|Try clicking play]]
}}
Show an image with a play button that pops up a dialog showing more images in a viewer with a slider that is suitable for medical scans.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| loop | loop | Should slider loop around. Set either "yes" or have no value
| Boolean | optional |
| start | start | Which image to start on
| Number | suggested |
| width | width | Override image width from list page | Number | optional |
| height | height | Override height from list page | Number | optional |
| Image list page | list | A page name and fragment to load the image list from. For example, if you put MyPage#myGallery, then it is assumed there is a <gallery id="myGallery">...</gallery> on the page MyPage which is used as the list of images
| String | required |
| noregisterimages | noregisterimages | Disable translcuding the list page. This will cause this page not to be listed on the what links here for the images used. | Boolean | optional |
| caption | caption | Caption to show in the pop-up below the image. Can include any wikitext. | Content | suggested |
| Popup title | title | Title of popup. Can only be plain text. Wikitext not supported. | String | suggested |
| file | file | The wikitext to include the image shown on the page
| Content | required |
Installation
[edit]To install this template in your wiki:
- Copy the pages Module:ImageStackPopup, Template:ImageStackPopup and Template:ImageStackPopupGallery to your wiki.
- Create MediaWiki:Gadget-ImageStackPopup.js with the following code:
/** * ImageStackPopup: Creates a popup gallery viewer suitable for medical images * Documentation: https://www.mediawiki.org/wiki/ImageStackPopup * Source code: https://www.mediawiki.org/wiki/MediaWiki:Gadget-Global-ImageStackPopup.js */ mw.loader.load( '//www.mediawiki.org/w/load.php?modules=ext.gadget.Global-ImageStackPopup' );
- Add the following gadget to MediaWiki:Gadgets-definition:
ImageStackPopup[ResourceLoader|hidden|default|categories=ImageStackPopup.js]|ImageStackPopup.js
Done! Add your template to any page to verify that the installation was successful.
Background
[edit]This was based of work originally by User:Hellerhoff and was funded by mdwiki:Wiki Project Med Foundation.
Currently live
[edit]Please add additional languages in which it is installed.
- mdwiki:Mesenteric_ischemia#Diagnosis
- commons:User:Doc_James#CT_scan_viewer
- w:en:Category:Pages using gadget ImageStackPopup