plugin:gallery
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:gallery [2016-12-22 12:35] – version upped andi | plugin:gallery [2024-04-15 08:05] (current) – old revision restored (2024-02-28 20:13) saggi | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Gallery Plugin ====== | ====== Gallery Plugin ====== | ||
+ | |||
---- plugin ---- | ---- plugin ---- | ||
- | description: | + | description: |
author | author | ||
email : andi@splitbrain.org | email : andi@splitbrain.org | ||
type : syntax | type : syntax | ||
- | lastupdate : 2016-12-22 | + | lastupdate : 2023-12-08 |
- | compatible : Adora Belle, Weatherwax, ponder stibbons, Hrun, Detritus, Elenor Of Tsort | + | compatible : !greebo, !hogfather, !igor, Jack Jackrum, Kaos |
depends | depends | ||
conflicts | conflicts | ||
Line 16: | Line 17: | ||
bugtracker : https:// | bugtracker : https:// | ||
donationurl: | donationurl: | ||
+ | |||
+ | screenshot_img: | ||
---- | ---- | ||
+ | |||
+ | This plugin shows a list of image thumbnails linking to larger versions of the image. | ||
+ | |||
===== Download ===== | ===== Download ===== | ||
- | Use the download link given above in the plugin | + | Search and install |
+ | |||
+ | ==== Requirements ==== | ||
+ | |||
+ | Your wiki needs to be able to resize images. Either by having the GD PHP extension installed | ||
+ | |||
+ | Additionally, | ||
==== Changes ==== | ==== Changes ==== | ||
Line 28: | Line 40: | ||
===== Syntax ===== | ===== Syntax ===== | ||
- | A basic gallery can be added by selecting a [[: | + | Images can be selected via three different sources and accept various [[# |
+ | |||
+ | |||
+ | ==== Source: Namespace/ | ||
+ | |||
+ | A gallery can be added by selecting a [[: | ||
{{gallery>: | {{gallery>: | ||
Line 34: | Line 51: | ||
All image files in the selected namespace will be added to the image gallery. Don't forget the ":" | All image files in the selected namespace will be added to the image gallery. Don't forget the ":" | ||
- | Instead of using a whole namespace of images, you can also specify a single image -- this makes more sense when combined with the lightbox mode (see below). | + | Instead of using a whole namespace of images, you can also specify a single image. |
{{gallery>: | {{gallery>: | ||
- | The created gallery can be aligned by using white space (defaults to centered): | + | [[# |
- | {{gallery> | + | {{gallery> |
- | | + | |
- | | + | ==== Source: Media Feed ==== |
Instead of a namespace, you can also give an HTTP(s) URL to any [[wp> | Instead of a namespace, you can also give an HTTP(s) URL to any [[wp> | ||
- | {{gallery> | + | {{gallery> |
- | Note: since the question mark is used to separate the parameters | + | Note: since the question mark is used to separate the [[# |
- | E.g. instead of '' | + | Again, options are added after a question mark ''?'' |
- | Additionally, | + | {{gallery> |
- | ==== Parameters | + | ==== Source: Image List ==== |
- | A number | + | A different syntax allows you to manually specify a list of images, |
- | ^ Parameter | + | < |
- | | ''//< | + | <gallery options go here> |
- | | ''//< | + | : |
- | | ''//< | + | https:// |
- | | '' | + | </ |
- | | '' | + | </ |
- | | '' | + | |
- | | '' | + | This mode allows you to optionally manually set the title and caption of images. The title is separated by a space from the image name, the caption is separated by a pipe '' |
- | | '' | + | |
- | | '' | + | < |
- | | '' | + | <gallery options go here> |
- | | '' | + | : |
- | | '' | + | https:// |
- | | '' | + | </ |
- | | '' | + | </ |
- | | '' | + | |
- | | '' | + | |
- | | '' | + | ==== Alignment ==== |
- | | '' | + | |
- | | anything containing a '' | + | The gallery can be aligned in 4 different ways: |
+ | |||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | The alignment can be set either by the above keyword in the [[# | ||
+ | |||
+ | |||
+ | {{gallery> | ||
+ | {{gallery> | ||
+ | {{gallery> | ||
+ | |||
+ | |||
+ | ==== Options ==== | ||
+ | |||
+ | A number of parameters can be set by listing them as mentioned in the source sections above. | ||
+ | |||
+ | Each parameter can be separated with a ''&'' | ||
+ | |||
+ | ^ Parameter | ||
+ | | ''//< | ||
+ | | ''//< | ||
+ | | ''//< | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | anything containing a '' | ||
+ | | '' | ||
=== Example === | === Example === | ||
- | {{gallery> | + | {{gallery> |
- | This displays all images beginning with '' | + | This displays all images beginning with '' |
=== Example === | === Example === | ||
Line 95: | Line 154: | ||
This mode will open the clicked picture inside the current browser window without leaving the current page. | This mode will open the clicked picture inside the current browser window without leaving the current page. | ||
- | You can close the picture view by clicking the X button in the upper right corner. You can move to the next or previous image by using the arrow buttons in the lower bar. You can also use the keyboard shortcuts listed below for navigation and closing. Mobile users can swipe to navigate and use the back button to close the gallery. | + | You can close the picture view by clicking the X button in the upper right corner. You can move to the next or previous image by using the arrow buttons in the lower bar. You can also use the keyboard shortcuts listed below for navigation and closing. |
+ | |||
+ | Mobile users can swipe to navigate and use the back button to close the gallery. | ||
+ | |||
+ | Shown images can be zoomed using the mousewheel or a pinch gesture on mobile phones. | ||
The following keys can be used to navigate: | The following keys can be used to navigate: | ||
Line 104: | Line 167: | ||
| '' | | '' | ||
- | ===== Manipulate EXIF Tags ===== | + | ===== On Titles and Captions |
- | If you want to show a title below the image using the parameter '' | + | |
- | If you want to adapt the image' | + | For internal images, titles and captions are read from the EXIF/IPTC tags. This is meta data within the image files. In DokuWiki this metadata is only available for JPEG images. You can edit the metadata in the [[: |
+ | |||
+ | The [[#Source: Image List]] allows you to manually set the title and caption for each listed image. | ||
- | Note that the EXIF-tags used for display can be changed. See [[: | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
===== Known Limitations and Caveats ===== | ===== Known Limitations and Caveats ===== | ||
Line 125: | Line 183: | ||
* Use the [[plugin: | * Use the [[plugin: | ||
* Upload the files manually via FTP to the '' | * Upload the files manually via FTP to the '' | ||
- | * Images previously rotated 90˚ and saved in that orientation no longer appear that way when used in dokuwiki. | ||
==== Caching ==== | ==== Caching ==== | ||
- | The gallery output is cached by default. When you add pictures later, they may not show up in the gallery: add '' | + | The gallery output is cached by default. When you add pictures later, they may not show up immediately |
- | Optionally use the '' | + | Optionally use the '' |
==== EXIF Data Problems ==== | ==== EXIF Data Problems ==== | ||
Line 138: | Line 195: | ||
Problems with accessing [[: | Problems with accessing [[: | ||
+ | Note that the EXIF parser requires XML support in your PHP for some parsing. If you get '' | ||
==== Lightbox Problems ==== | ==== Lightbox Problems ==== | ||
Line 157: | Line 215: | ||
As written above, you need to increase the [[config: | As written above, you need to increase the [[config: | ||
- | ===== Demo Installations ===== | ||
- | |||
- | Here are a few user provided examples of the gallery plugin in use: | ||
- | |||
- | * http:// | ||
- | * http:// | ||
- | * http:// | ||
- | * http:// | ||
- | * http:// | ||
- | * http:// | ||
===== Discussion ===== | ===== Discussion ===== | ||
- | Be sure to read the [[#Known Limitations and Caveats]] section first. Questions should be asked in the [[http:// | + | Be sure to read the [[#Known Limitations and Caveats]] section first. Questions should be asked in the [[https:// |
plugin/gallery.1482406506.txt.gz · Last modified: 2016-12-22 12:35 by andi