Introduction
This add-on contains core controller to build gallery addons for Plone.
The goals are:
- Have a simple photo fetchers component in one API
- Support many photos providers (picasa, flickr, ...)
- Stay as simple as possible
How to install
This addon can be installed as any other addon. Please follow the official
documentation.
Have an idea? Found a bug? Let us know by opening a support ticket
_.
.. _opening a support ticket
: https://github.com/toutpt/collective.gallery/issues
State of the current master on github by travis-ci:
.. image:: https://secure.travis-ci.org/collective/collective.gallery.png
:target: http://travis-ci.org/collective/collective.gallery
Upgrade from 1.X
Note: for those who came from 1.X this addon dont provide UX anymore.
This addon is now intended to integrator.
Please consider use collective.galleria as a great gallery viewer for Plone.
Note that Galleriffic is not maintained. This is one of the reason why I have
removed UX from this package. jQuery gallery appear and disapear every day.
To cleanup you plonesite from 1.X, you can call @@collective.gallery.zclean as
administrator or use the profile 'zclean' which remove galleriffic from your
javascript registry.
Components (Backend)
Summary:
- No custom content type, only views
- Works with lots of photos (is developed to work with +300 photos)
- Ramcache setup with a default key to one hours + modification date
- Works with Folder, Topic and Link content types
- picasaweb_ and flickr_ support.
- facebook support.
- I18N: english, french, german and italian are available
collective.gallery use zope.components to provide as much reusable components
as possible.
First we have photo resources. Plone already manage this for you:
- Folder can contains Image
- Topic can be criterized to list only Image content type
- Link can be sources of photos throw picasaweb.google.com and flickr.com services.
Next you have the main component: IGallery.
This interface is implemented at two levels:
- As named adapter over IATLink to get photos from picasaweb or flickr or facebook.
- As browserview to control the resource (@@gallery)
Folder & Image
Folder and Image content type can be used to build a gallery. Add a folder and
then add every images in it. Once its done come up to the folder and choose
'Gallery view' in the display drop down menu and voila.
The folder gallery component query the portal_catalog and adapts brains to
IPhoto.
Topic & Image
Topic can be used to build a gallery. Add a topic and add criteria on the Type
to select only Image. Next choose the 'Gallery view' in the drop down menu and
voila.
The topic gallery component use the topic's queryCatalog method to get brains,
then they are adapted to IPhoto
Link
Link can be used to build a gallery. Add a link, set URL to one of the following
services, validate and choose the 'Gallery view' in the drop down menu and
voila.
The link gallery component get all named adapters from Link to IGallery and call
the validate method. The first validated adapter is kept as resources.
picasaweb_
In Plone, just paste the share link provided by picasaweb inside a Link content
type and display your link content with the view 'Gallery view' available in the
drop down display menu.
SIZES : 32, 48, 64, 72, 104, 144, 150, 160, 94, 110, 128, 200, 220, 288, 320,
400, 512, 576, 640, 720, 800, 912, 1024, 1152, 1280, 1440, 1600
All metadatas are supported
Link supported are:
* http://picasaweb.google.XX/userid/albumname
* https://picasaweb.google.XX/userid/albumname
* https://picasaweb.google.XX/userid/privatealbumname?authkey=AUTHKEY
flickr_
~~~~~~~
In Plone, just paste the share link provided by flickr inside a Link content
type and display your link content with the view gallery available in the drop down display menu.
Flickr service is not album centric but photo centric. Supported case:
* http://www.flickr.com/photos/autowitch/sets/107460 It is an album, no problem
* http://www.flickr.com/photos/rbpdesigner We have the username, return all photos
* http://www.flickr.com/photos/searchtags/123,456 We return the photos of a search on the comma separated list of tags
* http://www.flickr.com/photos/rbpdesigner/searchtags/123,456 We return the photos of a search on the comma separated list of tags; for that specific user
facebook_
~~~~~~~~~
In Plone as with other link you just have to paste the link inside a Link content
type.
The album must be public. Links supported are:
* http://www.facebook.com/album.php?aid=ALBUMID&id=OTHERID
* http://www.facebook.com/media/set/?set=a.ALBUMID.OTHERID.STHELSE (the url must contains 5 dots)
IPhoto.description metadata is not supported
Integrators
===========
You have some examples of addons based on this one:
* collective.galleria
* collective.galleriffic
* collective.fancyboxgallery
* collective.highslide
* collective.portlet.fancyboxgallery
Extra addons to use with collective.gallery:
* collective.quickupload
* Products.ImageEditor
You want more ?
===============
The picasaweb and flickr services let you embed a flash slideshow to display your photos.
Views are already available to use those services:
* @@gallery-picasaweb-slideshow
* @@gallery-flickr-slideshow
But they are not integrated in the Plone UI.
Credits
=======
Companies
---------
|makinacom|_
* `Planet Makina Corpus <http://www.makina-corpus.org>`_
* `Contact Makina Corpus <mailto:python@makina-corpus.org>`_
People
------
- JeanMichel FRANCOIS aka toutpt <toutpt@gmail.com>
- Mathieu Le Marec - Pasquet <kiorky@cryptelium.net>
- Jean-Philippe Camguilhem <jp.camguilhem@gmail.com>
- Johannes Raggam <raggam-nl@adm.at>
- Giacomo Spettoli
.. |makinacom| image:: http://depot.makina-corpus.org/public/logo.gif
.. _makinacom: http://www.makina-corpus.com
.. _flickr: http://www.flickr.com
.. _picasaweb: http://picasaweb.google.com
.. _jcarousel: http://sorgalla.com/jcarousel
.. _facebook: http://www.facebook.com
Changelog
=========
2.0.1 (2014-03-04)
------------------
- pep8 + tests + travis-ci integration
- feature: add support for flickr description
2.0 (2012-12-06)
----------------
- Remove portlet
- Remove galleriffic
- Remove gallery_view
- Add get_photo(index=0) to Gallery API.
- Add tags search urls for the flickr backend [kiorky]
1.1 (2012-01-03)
----------------
- add Italian translation
[giacomos]
- add new classifiers
- Fix http://plone.org/products/collective.gallery/issues/3
Flikr links on author (/photos/author) don't display
- Add https support on facebook link
- fix uninstall profile to remove component from persistent registry
1.0 (2011-11-13)
----------------
- No change from b7
1.0b7 (2011-09-23)
------------------
- Fix picasaweb url parser bug with authkey
[toutpt]
- update zcml import from Zope2.App
[toutpt]
- update facebook support (remove the need of BeautifulSoup, we now use json)
[toutpt]
1.0b6 (2011-06-29)
------------------
- Updating schema of gallery portlet.
[thet]
- Add itemview gallery portlet
[toutpt]
- Add gallery portlet.
[thet]
- Add transifex configuration
[toutpt]
- Add support for News Item
[toutpt]
- Fix https picasaweb url doesn't work
[toutpt]
1.0b5 (2011-01-06)
------------------
- fix fast navigation bug (where imgs where added one upon the other) -> Need
to position images in absolute
[sylvainb toutpt]
- German translation.
[thet]
- add a browser layer and register adapters in plone componentregistry
- fix plone3 compatibility
- add jquerytool tooltip to display title and description of each photo
- cleanup interfaces
- add upgrade from previous releases
- make gallery.js exit if no #gallerythumbs
- add metadata file to set title of gallery.html page
- fix facebook backend. Now it works with BeautifulSoup if installed (zcml condition)
- fix tests
- update translations
- remove dependency on paste.
[thet]
- add dependency on galleriffic. remove dependency on pikachoose
- add id on photo api
- improve galleriffic integration
[toutpt jchambard]
- add gallery.html view based on collective.js.galleriffic. add support for
non well sized photo (if the backend doesn't support sizes.)
1.0b4 (2010-10-25)
------------------
- Remove Large Plone Folder from default profile. Now install well on plone4
- Move galleriffic integration into skin directory.
- BrowserView are now used has controller: template is replaced by allowed_interface
- Switch back galleriffic plone integration to example1
1.0b3 (2010-05-31)
------------------
- Fix a KeyError on exif data with folder implementation (topic and folder)
1.0b2 (2010-05-26)
------------------
- Add uninstall profile + Extensions/Install script to be used by quickinstaller
- Move templates in browser/templates folder
- Move javascript resources in browser/resources folder
- Add 'en' locale
- Add z3c.autoinclude target plone in entry points
1.0b1 - (2010/05/21)
--------------------
- remove harlequin and z3cform integration (too soon)
- rename IImage to IPhoto and imgs() to photos()
- Add rebuild i18n script as usual
- Use collective.testcaselayer for tests
- Add interfaces IImage and IExif on results returned by every services
- Use jquery.galleriffic jquery plugin (example 1)
- Add flickr support [toupt]
- Add cache support with plone.memoize.ram
- Add picasa private album support on both slideshow and link browserview
- Add tests on picasa components
0.1.1 - 2009/12/29
------------------
- Add picasa slideshow flash gallery view on link content type
- Add integration tests
0.1 - 2009/12/28
----------------
- Initial release