Photoswipe provides a jQuery-based photo gallery offering good mobile
browsing features, in particular swiping to the next picture.
This module is a port to Backdrop of the Drupal module, v7.x-2.0
beta 6 (Sept 2020).
Dependencies
It depends on the third party PhotoSwipe library described at
https://photoswipe.com.
The library is now included in this module and was copied from the
repository at https://github.com/dimsemenov/PhotoSwipe
Installation
Install this module using the official Backdrop CMS instructions at
https://backdropcms.org/guide/modules.
Usage
Multiple images in nodes
Within 'Manage Displays' for a content type that includes images,
select 'Photoswipe' for the format of an image field. Then choose
the settings for the node images and the photoswipe images.
Multiple images will then be displayed as a gallery. An additional
setting is provided that, if unchecked, prevents the gallery action
but allows the 'lightbox' type of display as for single images.
Single image in node
Photoswipe can be used similarly for fields for single images within
a content type. In such cases Photoswipe provides a 'lightbox' type
of display of the image but not, of course, a gallery.
Multiple images in Views
Choose the option 'Photoswipe' as the 'Formatter' for the image field.
Choose a predefined style for your node images (i.e. the thumbnails)
and a larger style (or the original image) for your Photoswipe image.
If the 'lightbox' type display is required but not the gallery action
uncheck the 'Gallery action' setting.
Image captions
Photoswipe includes an option to use the alt or title values of an
image as a caption. Activate this by first enabling the alt or title
options within the image field settings for the relevant content type.
Then in the display options for the image field select the required
option for the 'Photoswipe image caption' setting.
It is also possible to add a text field to the node type and set
Photoswipe to use this as a caption, though this is a per-node value
and is not perhaps suitable when using multiple images in a node.
License
This project is GPL v2 software. See the LICENSE.txt file in
this directory for the complete text.
Maintainer
Graham Oliver (github.com/Graham-72/)
Credits
Porting to Backdrop
Graham Oliver with the assistance of the Coder Upgrade module
and Pavel Goloviy (@korontari).
Maintainers for Drupal module:
- Julian Pustkuchen (Anybody)
- Paris Liakos (ParisLiakos)
Acknowledgement
This port to Backdrop would not, of course, be possible without all
the work done by the developers and maintainers of the Drupal module,
and the provider (Dmitry Semenov) of the PhotoSwipe library.
About the underlying Photoswipe script
The script was created by Code Computerlove, a digital agency in
Manchester. In March 2014, it passed on development to Dmitry Semenov.
Read more at https://photoswipe.com.
The script is free to use for personal and commercial projects.
It falls under the MIT license.