plone.gallery

============= plone.gallery

.. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features. If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html This text does not appear on pypi or github. It is a comment.

.. image:: https://github.com/plone/plone.gallery/actions/workflows/plone-package.yml/badge.svg :target: https://github.com/plone/plone.gallery/actions/workflows/plone-package.yml

.. image:: https://coveralls.io/repos/github/plone/plone.gallery/badge.svg?branch=master :target: https://coveralls.io/github/plone/plone.gallery?branch=master :alt: Coveralls

.. image:: https://img.shields.io/pypi/v/plone.gallery.svg :target: https://pypi.python.org/pypi/plone.gallery/ :alt: Latest Version

.. image:: https://img.shields.io/pypi/status/plone.gallery.svg :target: https://pypi.python.org/pypi/plone.gallery :alt: Egg Status

.. image:: https://img.shields.io/pypi/pyversions/plone.gallery.svg?style=plastic :alt: Supported - Python Versions

.. image:: https://img.shields.io/pypi/l/plone.gallery.svg :target: https://pypi.python.org/pypi/plone.gallery/ :alt: License

A photo gallery view for Plone CMS.

Features

• Shows photos of different sizes nicely and responsive
• Allows to zoom and browse thru the photos
• Has a white and blackmode
• Fullscreen and Autoplay mode
• Flexible setting of grid image scale and zoom image scale in gallery control panel
• works for folders and collections
• comes with TinyMCE templates for adding static galleries in Document,News items aso.
• come with a gallery_shortcode to use in richtext like in TinyMCE editor.

It uses the libraries spotlight <https://github.com/nextapps-de/spotlight>_ and flexbin <https://github.com/guoyunhe/flexbin>_ in combination for that.

.. image:: https://raw.githubusercontent.com/plone/plone.gallery/master/docs/plone-gallery.gif

Works from Phone to Big screen

.. image:: https://raw.githubusercontent.com/plone/plone.gallery/master/docs/screenshot-gallerie-grid.jpg

TinyMCE templates

Also usable in TinyMCE with templates.

.. image:: https://raw.githubusercontent.com/plone/plone.gallery/master/docs/screenshot-gallerie-grid-richtext.jpg

To enable the templates, add these lines to the templates field in TinyMCE control panel.

.. code-block:: json

[
  {"title": "3 pictures as gallery", "description": "Photo gallery: 4 photos", "url": "++plone++plone.gallery/tinymce-templates/gallery-grid-3.html"},
  {"title": "4 pictures as gallery", "description": "Photo gallery: 4 photos", "url": "++plone++plone.gallery/tinymce-templates/gallery-grid-4.html"},
  {"title": "6 pictures as gallery", "description": "Photo gallery: 6 photos", "url": "++plone++plone.gallery/tinymce-templates/gallery-grid-6.html"},
  {"title": "8 pictures as gallery", "description": "Photo gallery: 8 photos", "url": "++plone++plone.gallery/tinymce-templates/gallery-grid-8.html"}
]

Gallery shortcode

You can use the gallery_shortcode as follows in TinyMCE.

Somewhere in the text place this placeholder: [gallery_shortcode]

.. code-block:: html

<p>Tempor eu labore sint occaecat et esse. Irure nisi incididunt commodo exercitation aliqua. Ullamco quis quis sunt velit duis consectetur dolor aute cupidatat deserunt amet. Velit sunt eiusmod nulla proident consequat eu. Irure eiusmod aute reprehenderit occaecat laboris fugiat exercitation consectetur laboris nisi. Non ullamco commodo enim aute ex mollit est amet nostrud eu dolor. Mollit quis esse commodo irure duis veniam velit adipisicing.</p>

[gallery_shortcode]

<p>Tempor eu labore sint occaecat et esse. Irure nisi incididunt commodo exercitation aliqua. Ullamco quis quis sunt velit duis consectetur dolor aute cupidatat deserunt amet. Velit sunt eiusmod nulla proident consequat eu. Irure eiusmod aute reprehenderit occaecat laboris fugiat exercitation consectetur laboris nisi. Non ullamco commodo enim aute ex mollit est amet nostrud eu dolor. Mollit quis esse commodo irure duis veniam velit adipisicing.</p>

The outputfilter will now render all photos in referenced under related photos or contained in the context as a gallery.

You can either reference photos with the related photos field or place them into the current page if you have a folderish page.

Translations

This product has been translated into

• German (MrTango)

Installation

Install plone.gallery by adding it to your buildout::

[buildout]

...

eggs =
    plone.gallery

and then running bin/buildout

Usage

Please make sure that you have reasonable image sizes set in your portal. Something as follow should be good.

large 1400:1400
preview 600:600
mini 400:400
thumb 200:200

The large size is used for the zoom and mini for the preview grid view. Changing the other too just make sense if you change something.

After you have the correct sizes, you can just change the view on every Folder or Collection in Plone to "Photo gallery".

TODO

• make flexbin-row-height and flexbin-space configureable

Contribute

• Issue Tracker: https://github.com/plone/plone.gallery/issues
• Source Code: https://github.com/plone/plone.gallery

License

The project is licensed under the GPLv2.

Contributors

• Maik Derstappen, [e-mail]

Changelog

1.1.6 (2023-04-04)

• Fix serious bug in GalleryList view, which could slow down the website a lot. [MrTango]

1.1.5 (2023-03-22)

• prevent outputfilter from running when addon is not enabled [MrTango]

1.1.4 (2023-03-22)

• deactivate tinyMCE templates in config, to prevent overriding existing config. [MrTango]

1.1.3 (2023-03-20)

• prevent error when related_photos attribute is None [MrTango]

1.1.2 (2023-02-24)

• Extend related photo list with photos from context, not override them [MrTango]

1.1.1 (2023-02-24)

• Add gallery gallery_shortcode feature to be used in RichText. Photos are coming from the new related photos behavior or are contained if it is a folderish type. [MrTango]

1.1.0 (2023-02-22)

• Add TinyMCE templates with galleries and therefor always enable flexbin and spotlight resources [MrTango]

• Fix traceback for missing cmf.ManagePortal permission (#12) [laulaz]

1.0.6 (2022-11-23)

• Just improving the PyPi description [MrTango]

1.0.5 (2022-11-22)

• Declare Plone 6 support and update CI [MrTango]

1.0.4 (2022-07-26)

• Fix gally view for collections [MrTango]

1.0.3 (2022-07-26)

• Fix missing plone.app.contentmenu zcml dependency for plone_displayviews menu [laulaz]

• Add gallery control panel to allow setting grid_image_scale and zoom_image_scale [MrTango]

1.0.2 (2021-09-29)

• fix python_requires definition in setup.py MrTango

• general cleanup and add an uninstall profile MrTango

1.0.1 (2020-07-07)

• Fix scale size in gallery grid view [MrTango]

1.0 (2020-07-07)

• Cleanup, fixed travis setup and isort version in tox setup [MrTango]

1.0a4 (2020-06-12)

• render img tag manually, to avoid having width and height attributes set [MrTango]

1.0a3 (2020-06-12)

• Fix flexbin image height [MrTango]

• Fix title and description in spotlight view [MrTango]

1.0a2 (2020-06-11)

• Fix resources files in released package [MrTango]

• Support also Collections not only Folders [MrTango]

1.0a1 (2020-06-11)

• Initial release. [MrTango]