Skip to content

A masonry like gallery for Pico CMS

License

Notifications You must be signed in to change notification settings

maloja/pico-fotofolder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PicoFotofolder

A masonry like gallery for Pico CMS including a fullscreen and lazyload capabilities. It will display all images within a folder as a gallery. It is based on the two small "vanilla" JavaScripts baguetteBox and Lazyload.

Screenshot

Screenshot

Installation

Copy the files from Github https://github.com/maloja/pico-fotofolder into your Pico CMS plugins folder plugins/PicoFotofolder.

or clone directly from Github in plugins/PicoFotofolder

cd plugins
git clone https://github.com/maloja/pico-fotofolder

or, if you installed Pico CMS with composer

composer require maloja/pico-fotofolder

Usage

Add the following expression in your Markdown file:

(% fotofolder (/path/to/your/images [sort] [order]) %)

Optional arguments:

  • [sort] Can be 'date or 'name'. This will sort the images according date, which means the exif image date not the file date, or according the filename. Default is 'name'.

  • [order] Can be 'asc' or 'dsc'. Ascending or descending sort order. Default is 'dsc'

Caching

In order to increase page loading speed for PicoFotofolder, an additional subfolder /thumbnails for thumbnails is automatically created in your image folder. Therefore, make sure that write rights are granted for your image folder. A hidden file ".fotofolder.dat" is also created. This file stores meta information of your images. The subfolder /thumbnails as well as the file" .fotofolder.dat "are created automatically and can be deleted at any time if incorrect information is displayed in the gallery.

Requirements

Make sure the GD Library pgp-gd library is installed on your webserver.