Grav Flickr Plugin
This plugin allows you to fetch flickr photos, photosets and collections, and display them in page.
The current template make use of
featherlight, with the
gallery option enabled, to open your images in a slideshow.
If you wish to change this behaviour, please modify templates in the
Flickr data is provided via shortcodes, the
shortcode-core plugin is therefore another dependency.
First you must configure your Flickr account, getting an API key and secret.
You should register to the Flickr App Garden.
You will also need to find out your user id from your Flickr username, some services like IdGettr can get this for you.
Configure the flickr plugin (
user/config/plugins/, or even better using Grav Admin), with these values:
flickr_api_key: "<your api key>" flickr_api_secret: "<your api secret>" flickr_user_id: "<your user id>"
To test the plugin you need to find the id of the Flickr daya you want to display. Currently the plugin supports single photos, photosets (albums) and collections. The id can usually be found on the url of the resource you are currently browsing.
Each shortcode accepts additional values beside the
This is a list for each shortcode.
display-format-photo: single letter, defining the image size to be displayed. Look Flickr URL reference for all possible values.
display-format-photo-lightbox: same values as the previous parameter, but used to define image size in the lightbox popup.
photo-class: extra css classes for the main photo html tag.
photo-lightbox-class: extra css classes for the main lightbox html tag.
photoset-title-tag: HTML tag to use for the photoset title.
photoset-description-tag: HTML tag to use for the photoset description.
photoset-class: extra css classes for the main photoset html tag.
- All the parameters for flickr-photo are also accepted, to properly display child photos.
hide-empty-collections: if set to
true, skips title and description for collections without sets. Default
collection-title-tag: HTML tag to use for the collection title.
collection-description-tag: HTML tag to use for the collection description.
collection-class: extra css classes for the main collection html tag.
- All the parameters for flickr-photo and flickr-photoset are also supported to properly display child photos and photosets.