collective.gallery 1.0b4

Notes: gdata 2.0.10 doesn't work properly: http://code.google.com/p/gdata-python-client/issues/detail?id=367#c1
please pin the version to 2.0.9

Introduction
============

Gallery is an add-on full of features with a design that make it easy to customize.

It is tested with: Plone 3.3.X and Plone 4

It use Galleriffic_ plugin with jquery.history embed in the package.

Plone integration of galleriffic use example1_ . An other example can be find
on http://goo.gl/yqNi

Goals
=====

* Have a simple to customize gallery product for plone.
* Use very ligth weight resources
* Don't embed display configuration inside data

Features
========

* 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.
* I18N: english and french are available
* tested

picasaweb_
----------

* It's free to use
* Web albums, synchronised with picasa software
* Share your albums
* Add geo-tags to your photos
* Automatically organize your photos based on the people in them
* Display in a slideshow (flash)

In Plone, just paste the share link provided by picasaweb inside a Link content type
and display your link content with the view gallery available in the drop down display menu.

flickr_
-------

* It's free to use
* Share your photos
* Upload and organize
* Add geo-tags to your photos
* Display in a slideshow (flash)

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.

Galleriffic_
============

* Smart image preloading after the page is loaded
* Thumbnail navigation (with pagination)
* jQuery.history plugin integration to support bookmark-friendly URLs per-image
* Slideshow (with optional auto-updating url bookmarks)
* Keyboard navigation
* Events that allow for adding your own custom transition effects
* API for controlling the gallery with custom controls
* Support for image captions
* Flexible configuration
* Graceful degradation when javascript is not available
* Support for multiple galleries per page


Components
==========

collective.gallery use zope.components to provide as much reusable as possible components.

First we have photo resources. Plone already manage this for you:

* Folder and Large Plone Folder can contains Image
* Topic can be criterized to list only Image
* Link can be sources of photos throw picasaweb.google.com and flickr.com services.

Next you have the business component: IGallery. This interface is implemented at two levels:

* As named adapter over IATLink to get photos from picasaweb or flickr.
* As browserview to control the resource (@@gallery)

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.

Roadmap
=======

* [1.0] finish the css
* [1.1] exif integration
* [2.0] add photos
* [2.0] search photos
* [2.0] collective.harlequin as an extra dependency

Credits
=======

Companies
---------

|makinacom|_

* `Planet Makina Corpus <http://www.makina-corpus.org>`_
* `Contact us <mailto:python@makina-corpus.org>`_


Authors

- JeanMichel FRANCOIS aka toutpt <toutpt@gmail.com>

Contributors

.. |makinacom| image:: http://depot.makina-corpus.org/public/logo.gif
.. _makinacom: http://www.makina-corpus.com
.. _Galleriffic: http://www.twospy.com/galleriffic/
.. _flickr: http://www.flickr.com
.. _picasaweb: http://picasaweb.google.com

Changelog
=========

1.0b4 (2010-10-25)
------------------

- Remove Large Plone Folder from default profile. Now install well on plone4
[toutpt]
- Move galleriffic integration into skin directory.
[toutpt]
- BrowserView are now used has controller: template is replaced by allowed_interface
[toutpt]
- Switch back galleriffic plone integration to example1
[toutpt]

1.0b3 (2010-05-31)
------------------

- Fix a KeyError on exif data with folder implementation (topic and folder)
[toutpt]

1.0b2 (2010-05-26)
------------------

- Add uninstall profile + Extensions/Install script to be used by quickinstaller
[toutpt]
- Move templates in browser/templates folder
[toutpt]
- Move javascript resources in browser/resources folder
[toutpt]
- Add 'en' locale
[toutpt]
- Add z3c.autoinclude target plone in entry points
[toutpt]

1.0b1 - (2010/05/21)
--------------------

- remove harlequin and z3cform integration (too soon) [toutpt]
- rename IImage to IPhoto and imgs() to photos() [toutpt]
- Add rebuild i18n script as usual [toutpt]
- Use collective.testcaselayer for tests [toutpt]
- Add interfaces IImage and IExif on results returned by every services [toutpt]
- Use jquery.galleriffic jquery plugin (example 1) [toutpt]
- Add flickr support [toupt]
- Add cache support with plone.memoize.ram [toutpt]
- Add picasa private album support on both slideshow and link browserview [toutpt]
- Add tests on picasa components [toutpt]

0.1.1 - 2009/12/29
------------------

- Add picasa slideshow flash gallery view on link content type [toutpt]
- Add integration tests [toutpt]

0.1 - 2009/12/28
----------------

- Initial release