Differences

This shows you the differences between two versions of the page.

--- plugin:photogallery [2017-03-29 22:02] – [External images are not Resized] 93.71.58.40
+++ plugin:photogallery [2023-06-25 23:51] (current) – version upped andi
@@ Line 1: / Line 1: @@
-FIXME The plugin is under development and syntax and documentation are subjected to changes without notice.\\
-**Development state: 80%**
 ====== PhotoGallery Plugin ======
 ---- plugin ----
 description: This Syntax Plugin allows you to embed an automatically created image gallery into a page.
-author     : Marco Nolletti
+author     : Anna Dabrowska, Marco Nolletti
-email      : mnolletti@gmail.com
+email      : dokuwiki@cosmocode.de
 type       : syntax
-lastupdate : 2017-03-22
+lastupdate : 2023-06-25
-compatible : Frusterick Manners, Detritus, Elenor Of Tsort.
+compatible : Greebo, Hogfather, Igor
 depends    :
 conflicts  :
@@ Line 14: / Line 12: @@
 tags       : media, images, gallery, namespace, feed, embed, listing, slideshow, photo
-downloadurl: https://gitlab.com/dokuwiki/PhotoGallery_plugin/repository/archive.zip?ref=master
+downloadurl: https://github.com/cosmocode/dokuwiki-plugin-photogallery/zipball/master
-sourcerepo : https://gitlab.com/dokuwiki/PhotoGallery_plugin
+sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-photogallery
-bugtracker : https://gitlab.com/dokuwiki/PhotoGallery_plugin/issues
+bugtracker : https://github.com/cosmocode/dokuwiki-plugin-photogallery/issues
-donationurl:
 screenshot_img: http://www.nolletti.org/images/DokuWiki/PhotoGallery_Screenshot.jpg
@@ Line 38: / Line 35: @@
 The PhotoGallery plugin lightbox mode is based on the following included libraries:
   * [[http://sachinchoolur.github.io/lightGallery/|jQuery lightgallery]]
-  * [[http://phpthumb.sourceforge.net/|phpThumb]]
+  * [[https://github.com/JamesHeinrich/phpThumb/|phpThumb]]
 ==== Screenshots ====
@@ Line 46: / Line 43: @@
 ===== Requirements =====
-  * PHP Version >= 5.4.45
+:!: Make sure to uncheck the option [[config:defer_js]] in the wiki configuration. JavaScript in this plugin still needs to be updated.
 ===== Installation =====
-Install the plugin using the [[plugin:plugin|Plugin Manager]] or download at the URL above, which points to latest version, and install manually. Refer to [[:Plugins]] on how to install plugins manually.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 ===== Examples/Usage =====
@@ Line 117: / Line 115: @@
 ==== Image resizing ====
-By default all images are resized to fit in a box of the size specified in the plugin configuration (''image_width x image_height'').
+By default all images are resized to fit in a viewport of the size specified in the plugin configuration (''viewport_width x viewport_height'').
 **Note:** if you try to download or zoom the image with the lightbox button you will get the resized image, not the original one.
@@ Line 129: / Line 127: @@
 All parameters can be set using the gallery definition syntax. Each parameter needs to be on a different text line.
-Defaults for all parameters can be set in the config manager. If a parameter is enabled by default it can be disabled in the syntax by prefixing it with the symbol ''!'' (vertical bar). E.g. the parameter ''cache'' is usually enabled and can be disabled using the keyword ''!cache''. Below is a list of all recognized parameters
+Defaults for all parameters can be set in the config manager. If a parameter is enabled by default it can be disabled in the syntax by prefixing it with the symbol ''!'' (vertical bar). E.g. the parameter ''showinfo'' is usually enabled and can be disabled using the keyword ''!showinfo''. Below is a list of all recognized parameters
@@ Line 142: / Line 140: @@
 |                  |           | ''right''   |                                                                                                                                                                                                                                                                           |
 | ''zipfile''      |           |             | Filename of a zip archive "automagically" created in the same images folder and linked for download                                                                                                                                                                       |
+| ''zipauthlist''     |           |             | Comma separated list of users or @groups authorized to download zipped images (ACLs are always honoured)                                                                                                                                                                               |
 | ''sort''         | ''file''  | ''file''    | Sort images by filename                                                                                                                                                                                                                                                   |
-|                  |           | ''random''  | Sort images randomly. You might want to use ''nocache'' as well                                                                                                                                                                                                           |
+|                  |           | ''random''  | Sort images randomly.                                                                                           |
 |                  |           | ''mod''     | Sort images by file modification date                                                                                                                                                                                                                                     |
 |                  |           | ''date''    | Sort images by EXIF date                                                                                                                                                                                                                                                  |
 |                  |           | ''title''   | Sort images by EXIF title                                                                                                                                                                                                                                                 |
-| ''cache''        | enabled   |             | Usually the output of the created gallery is cached. When the images in your selected namespace change, you have to manually force an update of the gallery page's [[:caching|cache]]. To disable the cache for the page showing the gallery, set ''nocache'' as option.  |
 | ''limit''        | 0         |             | Limit the number of elements to the specified number                                                                                                                                                                                                                      |
 | ''offset''       | 0         |             | Shows elements starting from the specified number                                                                                                                                                                                                                         |
-| ''crop''         | disabled  |             | Make thumbnails the exact given thumbnail size big, cropping when needed.                                                                                                                                                                                                 |
+| ''crop''         | disabled  |             | Make the images exact given viewport size big, cropping when needed.                                                                                                                                                                                                 |
 | ''reverse''      | disabled  |             | Reverse the order of the displayed images                                                                                                                                                                                                                                 |
 | ''recursive''    | disabled  |             | Find images in the given namespace and all sub namespaces                                                                                                                                                                                                                 |
 | ''showtitle''    | enabled   |             | Show the EXIF tag ''Headline'' as title below thumbnails                                                                                                                                                                                                                  |
+| ''showdescription''    | disabled   |             | Show the EXIF tag ''Description'' below thumbnails                                                                                                                                                                                                                  |
+| ''showkeywords''    | disabled   |             | Show the EXIF tag ''Keywords'' below thumbnails                                                                                                                                                                                                                  |
 | ''showinfo''     | enabled   |             | Show some EXIF techical information below images                                                                                                                                                                                                                          |
 | ''showfname''    | disabled  |             | Show filename below thumbnails                                                                                                                                                                                                                                            |
-| ''fullsize''     | disabled  |             | If enabled all images are not resized in the lightbox mode                                                                                                                                                                                                                |
+| ''fullsize''     | disabled  |             | If enabled all images are not resized in the lightbox mode                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| ''downloadfullsize''      FIXME To be soon delivered| disabled  |             | If enabled images are downloaded in full size from the lightbox download button. This is meant to be used without ''fullsize'' enabled: previewed images are resized, but users can still download the original fullsize image                                                                                                                                                                                                                |
@@ Line 209: / Line 210: @@
 The gallery output is cached by default. When you add pictures later, they may not show up in the gallery: add ''&purge=true'' to the end of the URL to clear the cache. See [[:caching]] for details.
-Optionally use the ''nocache'' parameter of the plugin (not recommended).
 ==== EXIF Data Problems ====
@@ Line 242: / Line 241: @@
 ==== External images are not Resized ====
-As written above, you need to increase the [[config:fetchsize]] config option. Also make sure GDLib or ImageMagick are installed.
+As written above, you need to increase the [[config:fetchsize]] config option. Also make sure LibGD or ImageMagick are installed.
 ==== Poster image are streched ====
-This appens if DokuWiki cannot find GDLib; check if the [[config:gdlib]] config option is valid.
+This appens if DokuWiki cannot find LibGD; check if the [[config:gdlib]] config option is valid.
 ===== Discussion =====
@@ Line 258: / Line 257: @@
 Getting this error after installing your plugin (latest version as of 3/16/2017.. I downloaded the phpThumb folder directory from the github repo just to be sure)
 "PhotoGallery error: pgImg.php is not executable"
+==== Translations ====
+Really nice plugin which already seems to work great for me. Thank you very much, Marco!!
+Could you also please register it at [[https://translate.dokuwiki.org/plugin]] to enable further translations by users like me. E.g. I would love to add ''de-informal''. :-)
+ --- [[user>jFMd|jFMd]] //2017-06-28 16:21//