=============
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, md@derico.de
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]
Raw data
{
"_id": null,
"home_page": "https://github.com/plone/plone.gallery",
"name": "plone.gallery",
"maintainer": "",
"docs_url": null,
"requires_python": ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*",
"maintainer_email": "",
"keywords": "Python Plone Photo Gallery",
"author": "Maik Derstappen",
"author_email": "md@derico.de",
"download_url": "https://files.pythonhosted.org/packages/53/3c/ccac31bdfd1574305fd8946eabf3f05cceb33f7fe9e7defafec75bf077b2/plone.gallery-1.1.6.tar.gz",
"platform": null,
"description": "=============\nplone.gallery\n=============\n\n.. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features.\n If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html\n This text does not appear on pypi or github. It is a comment.\n\n.. image:: https://github.com/plone/plone.gallery/actions/workflows/plone-package.yml/badge.svg\n :target: https://github.com/plone/plone.gallery/actions/workflows/plone-package.yml\n\n.. image:: https://coveralls.io/repos/github/plone/plone.gallery/badge.svg?branch=master\n :target: https://coveralls.io/github/plone/plone.gallery?branch=master\n :alt: Coveralls\n\n.. image:: https://img.shields.io/pypi/v/plone.gallery.svg\n :target: https://pypi.python.org/pypi/plone.gallery/\n :alt: Latest Version\n\n.. image:: https://img.shields.io/pypi/status/plone.gallery.svg\n :target: https://pypi.python.org/pypi/plone.gallery\n :alt: Egg Status\n\n.. image:: https://img.shields.io/pypi/pyversions/plone.gallery.svg?style=plastic :alt: Supported - Python Versions\n\n.. image:: https://img.shields.io/pypi/l/plone.gallery.svg\n :target: https://pypi.python.org/pypi/plone.gallery/\n :alt: License\n\nA photo gallery view for Plone CMS.\n\nFeatures\n========\n\n- Shows photos of different sizes nicely and responsive\n- Allows to zoom and browse thru the photos\n- Has a white and blackmode\n- Fullscreen and Autoplay mode\n- Flexible setting of grid image scale and zoom image scale in gallery control panel\n- works for folders and collections\n- comes with TinyMCE templates for adding static galleries in Document,News items aso.\n- come with a gallery_shortcode to use in richtext like in TinyMCE editor.\n\nIt uses the libraries `spotlight <https://github.com/nextapps-de/spotlight>`_ and `flexbin <https://github.com/guoyunhe/flexbin>`_ in combination for that.\n\n\n.. image:: https://raw.githubusercontent.com/plone/plone.gallery/master/docs/plone-gallery.gif\n\n\nWorks from Phone to Big screen\n------------------------------\n\n.. image:: https://raw.githubusercontent.com/plone/plone.gallery/master/docs/screenshot-gallerie-grid.jpg\n\n\nTinyMCE templates\n-----------------\n\nAlso usable in TinyMCE with templates.\n\n.. image:: https://raw.githubusercontent.com/plone/plone.gallery/master/docs/screenshot-gallerie-grid-richtext.jpg\n\nTo enable the templates, add these lines to the templates field in TinyMCE control panel.\n\n.. code-block:: json\n\n [\n {\"title\": \"3 pictures as gallery\", \"description\": \"Photo gallery: 4 photos\", \"url\": \"++plone++plone.gallery/tinymce-templates/gallery-grid-3.html\"},\n {\"title\": \"4 pictures as gallery\", \"description\": \"Photo gallery: 4 photos\", \"url\": \"++plone++plone.gallery/tinymce-templates/gallery-grid-4.html\"},\n {\"title\": \"6 pictures as gallery\", \"description\": \"Photo gallery: 6 photos\", \"url\": \"++plone++plone.gallery/tinymce-templates/gallery-grid-6.html\"},\n {\"title\": \"8 pictures as gallery\", \"description\": \"Photo gallery: 8 photos\", \"url\": \"++plone++plone.gallery/tinymce-templates/gallery-grid-8.html\"}\n ]\n\n\nGallery shortcode\n-----------------\n\nYou can use the `gallery_shortcode` as follows in TinyMCE.\n\nSomewhere in the text place this placeholder: [gallery_shortcode]\n\n.. code-block:: html\n\n <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>\n\n [gallery_shortcode]\n\n <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>\n\nThe outputfilter will now render all photos in referenced under related photos or contained in the context as a gallery.\n\nYou can either reference photos with the related photos field or place them into the current page if you have a folderish page.\n\n\n\nTranslations\n============\n\nThis product has been translated into\n\n- German (MrTango)\n\n\nInstallation\n============\n\nInstall plone.gallery by adding it to your buildout::\n\n [buildout]\n\n ...\n\n eggs =\n plone.gallery\n\n\nand then running ``bin/buildout``\n\nUsage\n=====\n\nPlease make sure that you have reasonable image sizes set in your portal. Something as follow should be good.\n\n large 1400:1400\n preview 600:600\n mini 400:400\n thumb 200:200\n\nThe large size is used for the zoom and mini for the preview grid view.\nChanging the other too just make sense if you change something.\n\nAfter you have the correct sizes, you can just change the view on every Folder or Collection in Plone to \"Photo gallery\".\n\n\nTODO\n====\n\n- make flexbin-row-height and flexbin-space configureable\n\nContribute\n==========\n\n- Issue Tracker: https://github.com/plone/plone.gallery/issues\n- Source Code: https://github.com/plone/plone.gallery\n\n\nLicense\n=======\n\nThe project is licensed under the GPLv2.\n\n\nContributors\n============\n\n- Maik Derstappen, md@derico.de\n\n\nChangelog\n=========\n\n\n1.1.6 (2023-04-04)\n------------------\n\n- Fix serious bug in GalleryList view, which could slow down the website a lot.\n [MrTango]\n\n\n1.1.5 (2023-03-22)\n------------------\n\n- prevent outputfilter from running when addon is not enabled\n [MrTango]\n\n\n1.1.4 (2023-03-22)\n------------------\n\n- deactivate tinyMCE templates in config, to prevent overriding existing config.\n [MrTango]\n\n\n1.1.3 (2023-03-20)\n------------------\n\n- prevent error when related_photos attribute is None\n [MrTango]\n\n\n1.1.2 (2023-02-24)\n------------------\n\n- Extend related photo list with photos from context, not override them\n [MrTango]\n\n\n1.1.1 (2023-02-24)\n------------------\n\n- 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.\n [MrTango]\n\n\n1.1.0 (2023-02-22)\n------------------\n\n- Add TinyMCE templates with galleries and therefor always enable flexbin and spotlight resources\n [MrTango]\n\n- Fix traceback for missing cmf.ManagePortal permission (#12)\n [laulaz]\n\n\n1.0.6 (2022-11-23)\n------------------\n\n- Just improving the PyPi description\n [MrTango]\n\n\n1.0.5 (2022-11-22)\n------------------\n\n- Declare Plone 6 support and update CI\n [MrTango]\n\n\n1.0.4 (2022-07-26)\n------------------\n\n- Fix gally view for collections\n [MrTango]\n\n\n1.0.3 (2022-07-26)\n------------------\n\n- Fix missing plone.app.contentmenu zcml dependency for plone_displayviews menu\n [laulaz]\n\n- Add gallery control panel to allow setting grid_image_scale and zoom_image_scale\n [MrTango]\n\n\n1.0.2 (2021-09-29)\n------------------\n\n- fix python_requires definition in setup.py\n MrTango\n\n- general cleanup and add an uninstall profile\n MrTango\n\n\n1.0.1 (2020-07-07)\n------------------\n\n- Fix scale size in gallery grid view\n [MrTango]\n\n\n1.0 (2020-07-07)\n----------------\n\n- Cleanup, fixed travis setup and isort version in tox setup\n [MrTango]\n\n\n1.0a4 (2020-06-12)\n------------------\n\n- render img tag manually, to avoid having width and height attributes set\n [MrTango]\n\n\n1.0a3 (2020-06-12)\n------------------\n\n- Fix flexbin image height\n [MrTango]\n\n- Fix title and description in spotlight view\n [MrTango]\n\n\n1.0a2 (2020-06-11)\n------------------\n\n- Fix resources files in released package\n [MrTango]\n\n- Support also Collections not only Folders\n [MrTango]\n\n\n1.0a1 (2020-06-11)\n------------------\n\n- Initial release.\n [MrTango]\n\n\n",
"bugtrack_url": null,
"license": "GPL version 2",
"summary": "Photo gallery for Plone CMS.",
"version": "1.1.6",
"split_keywords": [
"python",
"plone",
"photo",
"gallery"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "533cccac31bdfd1574305fd8946eabf3f05cceb33f7fe9e7defafec75bf077b2",
"md5": "3018b575398b31543c06708828325745",
"sha256": "f282a991fd8dc44e374e8b63d6aa9ae48fd467f63c996b307ba426a8f4af2d57"
},
"downloads": -1,
"filename": "plone.gallery-1.1.6.tar.gz",
"has_sig": false,
"md5_digest": "3018b575398b31543c06708828325745",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*",
"size": 4469292,
"upload_time": "2023-04-04T09:18:58",
"upload_time_iso_8601": "2023-04-04T09:18:58.353613Z",
"url": "https://files.pythonhosted.org/packages/53/3c/ccac31bdfd1574305fd8946eabf3f05cceb33f7fe9e7defafec75bf077b2/plone.gallery-1.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-04 09:18:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "plone",
"github_project": "plone.gallery",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "plone.gallery"
}
JSON
