collective.plonetruegallery 0.9.1rc2

Introduction
============
collective.plonetruegallery is a Plone product that implements a very customizable and sophisticated gallery. It allows you to add regular Plone Galleries,
Picasa Web
Albums or even Flickr sets. It also allows the user to display the gallery in 3 different sizes, choose between two different javascript gallery display types
and customize
transitions, effects, and timing. This project aims to be everything you need for a Gallery in Plone.

How It Works
------------
All you need to do is select the ``Gallery View`` from the ``Display`` drop down item for any Folder or Collection content type. Once that is done, a
``Gallery
Settings`` tab is enabled for the type. With this, you can customize the various settings for the Gallery.


Features
--------
* Flickr and Picasa Support!
* Customize gallery size, transition(limited transitions right now), timed and other settings
* Can use nested galleries
* Slideshow 2(with transition types), Highslide JS and Fancybox display types
* Pre-fetches gallery images
* Gallery portlet(limiting with how it handles image sizes)


Flickr and Picasa Web Album Support
-----------------------------------
* these packages are no longer a dependency of this package
* to add support for these type of galleries you must install additional packages
* install flickrapi version 1.2 or higher for flickr support
* install gdata version 1.2.3 or higher for Picasa Web Album Support
* these can just be added to your buildout or installed with easy_install or you can add the package to your egg section like::

collective.plonetruegallery[picasa] # for picasa support
collective.plonetruegallery[flickr] # for flickr support
collective.plonetruegallery[all] # for both flickr and picasa support


Upgrading
---------
The upgrade to version 0.8* is an important and large update. Basically, it gets rid of the Gallery type, replaces it with the regular Folder type along with a
new view
applied to the folder, namely the "Gallery View."

Also, when you install the new product, your galleries will *NOT* work until you've run the upgrade step.

One more thing, upgrading will also mean that the ``classic`` display type is no longer supported. Your gallery will be gracefully migrated, so no worries
on that end.
Also, the new gallery display types are much more appealing in many ways. It is just that you may not like the change in look of the gallery.


Installation
------------
Since this product depends on plone.app.z3cform, you'll need to add a few overrides for products versions in your buildout. Good news is that is you're
using any other
product that uses plone.app.z3cform, you'll already be good to go.

Basically, you'll need to add these to your buildout versions section.

For Plone 3::

[versions]
z3c.form = 1.9.0
plone.app.z3cform = 0.4.8
plone.z3cform = 0.5.10
zope.i18n = 3.4.0
zope.testing = 3.4.0
zope.component = 3.4.0
zope.securitypolicy = 3.4.0
zope.app.zcmlfiles = 3.4.3


and for Plone 4::

[versions]
z3c.form = 2.3.2
plone.app.z3cform = 0.5.0
plone.z3cform = 0.6.0


You might also have to pin zope.schema to version 3.6.

Then once you run buildout with this configuration, install collective.plonetruegallery via the the add-on product configuration. Also, make sure Plone
z3cform support is
installed too.

collective.plonetruegallery is compatible with Plone 3 and 4.


Uninstall
---------
First uninstall the collective.plonetruegallery product just like you would any other product. Then, go to ``portal_setup`` in the zmi and click on the
``Import`` tab.
Once there, select the ``collective.plonetruegallery Uninstall Profile`` profile and run all the steps. Once that is done, you can remove the egg from your
buildout.


Tested On
---------
* Firefox 3
* Safari 4
* Opera 9/10
* Google Chrome


Fetching of Images Explained
----------------------------
* When rendering a picasa or flickr gallery, it checks if the images have been fetched within a day. If they have not, then it re-fetches the images for the
gallery.
* You can also force a specific gallery to be re-fetched by appending ``@@refresh`` to the gallery url
* You can manually refresh all galleries on the site by typing in a url like ``mysite.com/@@refresh_all_galleries`` This means you can also setup a cron-
like job to
refresh all the galleries whenever you want to, just so it isn't done while a user is trying to render a page.


License Notes
-------------
This Plone product is under the GLP license; however, the Highslide JS display type uses the `Creative Commons Attribution-NonCommercial 2.5 License
<http://creativecommons.org/licenses/by-nc/2.5/>`_ and is only for non-commercial use unless you have purchased a commercial license from the
`Highslide
<http://www.highslide.com/>`_ website.


Credits
=======

Coding Contributions
--------------------
* Patrick Gerken - huge help with 0.8 release

Translations
------------
* French - Sylvain Boureliou
* Norwegian - Espen Moe-Nilssen
* Brazilian Portuguese - Diego Rubert
* Finnish - Ilja Everila
* German - Jens W. Klein
* Italian - Mirto Silvio Busico


SDG


Changelog
=========

0.9.1rc2
--------

* changed added large plone folder view to code since in Plone 4 it is no longer available.
fixes http://plone.org/products/plone-true-gallery/issues/33
[vangheem]

0.9.1rc1
--------

* Update to fancybox 1.3.1--should fix http://plone.org/products/plone-true-gallery/issues/19
from showing up any longer
[vangheem]

* added easing and scrolling plugins to fancybox so it's nicer now.
[vangheem]



0.9.0b1
-------

* use getAllowedSizes from plone.app.imaging.utils instead
[vangheem]

* fixed plone.app.imaging incompatibility with patches
it uses--fixes http://plone.org/products/plone-true-gallery/issues/23
[vangheem]

* fixed fancy box not showing correctly occasionally
[vangheem]

* restructured display type code to be a little more compatible with templating.
It was a little messy the way it was done before so it is now slightly
less customizable for the sake of being more compatible and modular. If any
gallery types were defined in the old fashion, they may no longer work without
slight modification. That is what this is now tagged as a 0.9 release.
[vangheem]

* compatible with cmf.pt now--Chameleon.
[vangheem]

* gallery portlet now forces the height of the image so it doesn't flicker if
for some reason the image hasn't finished loading yet.
fixes http://plone.org/products/plone-true-gallery/issues/24
[vangheem]

* added plone.app.z3cform as dependency profile
fixes http://plone.org/products/plone-true-gallery/issues/25
[vangheem]

* fixed css on gallery portlet to show title properly
[vangheem]


0.8.2b4 ~ March 16
------------------

* annoying extra release since the previous one included extra
"._" po files...
[vangheem]


0.8.2b3 ~ March 10
------------------

* fixed gallery portlet js to work with Plone 4
http://plone.org/products/plone-true-gallery/issues/18
[vangheem]

* fixed max-width screwing up slideshow transition
with some css
[vangheem]

* gallery is now plone.app.imaging aware, reflecting
sizes specified there.
[vangheem]

* fixed translations not being added correctly
[vangheem]

0.8.2b2 ~ February 10, 2010
---------------------------

* fixed page template traversal issue with plone 4 described here
http://plone.org/products/plone-true-gallery/issues/17
[vangheem]


0.8.2b1 ~ February 4, 2010
--------------------------

* Make compatible with Plone 4--fixes page template rendering and css issues
[vangheem]


0.8.1b2 ~ January 27, 2010
--------------------------

* Adapting BasicImageInformationRetriever to IObjectManager does not work
in Plone4 anymore. Use IBaseFolder instead which is also generic for
ATFolder and ATBTreeFolder.
[thet]

* Added Italian translation
[Mirto Silvio Busico]

* Added z3c.autoinclude support--no more zcml entry in buildout on newer
versions of plone.
[vangheem]

* Override button apply method instead of __call__ method to set the status
for user warning and to set setting changes. This fixes issue with
newer version of plone.z3cform not showing updated status message.
[vangheem]

* Added hashlib to list of install requires for picasa since some versions
of gdata fail without it.
[vangheem]


0.8.1b1 ~ December 17, 2009
---------------------------

* add german translation
[jensens]

* add extra requires to setup.py: Now one can set as dependency
"collective.plonetruegallery[flickr], collective.plonetruegallery[picasa]" or
collective.plonetruegallery[all] --
[jensens]

* removed logging statement in porltet js code
[vangheem]

* fixed bug with upgrading older versions during version check
[vangheem]

* fixed unicode decode error with picasa albums that have none-standard
letters in them.
[vangheem]


0.8.1a3 ~ December 3, 2009
--------------------------

* added gallery portlet
[vangheem]


0.8a2
-----

* fixed slideshow gallery css so that the green bar does not get covered
up by the gallery when logged in.
[vangheem]

* fixed sub-gallery css issues
[vangheem]

* fixed ordering of images in gallery--now gallery images reorder
when they are reordered in the container.
[vangheem]

* links now point to the view view of images if a user is logged in
[vangheem]

* fixed ?start_image parameter to work with batching.
[vangheem]

* highslide and fancybox slideshow will start slideshow automatically only if
number of images fits in one batch page
[do3cc]

* highslide image slides now have a title that consists of the image title
and link to the image
[do3cc]


0.8a1
-----
* removed Gallery content type
* allows you to display gallery for Folder, Large Folder, and Collections
* moved to using plone.app.z3cforms
* remove event subscriptions and do not cook basic galleries
* removed classic display type--don't feel like maintaining anymore..
* added fancybox and highslide display types
* slideshow 2 now pans without zooming in on image and distorting it
* added more styling to slideshow 2's type
* fixed issue with slideshow 2 gallery type where image would show up a little blurry because of image scaling...
* updated flickr size settings
* no longer support private picasa albums(I don't want to store passwords obviously...)

0.7.1
-----
* fixed tests
* added finnish translations[Ilja Everila]
* added translatable sub-images

0.7rc1
------
* added "Refresh Gallery" button in case you change a gallery and need to re-cook the gallery images before it automatically does it for you. Especially
useful for
reordering of images in a basic gallery.
* added go to image support via url like /url/to/gallery?start_image=theTitle. Not exactly perfect, but should work most of the time. No other way to know
what image it
is since I don't keep ids on flickr and picasa galleries. make sure to url encode the title though.

0.7b2.4
-------
* because translations had .mo files, it broke some systems--removed.

0.7b2.3
-------
* added brazilian translation

0.7b2.1
-------
* updated french translation
* added norwegian translation(Espen Moe-Nilssen)
* added some message factories to places where it wasn't used

0.7b2
-----
* add css class to no images message

0.7b1
-----
* changed the small picasa gallery size to be 320x320

0.7a1.2
-------
* bug fixes
* gallery type registration changes

0.7a1.1
-------
* fixed bug that prevented subgalleries from being displayed [deo]
* made sure to always display the gallery images even when there are subgalleries in the current gallery [deo]
* removes dependency on simplejson and elementtree
* now flickrapi and gdata are optional add-ons
* added support for slideshow 2 - now gives option of what gallery type to use
* reorganization of gallery schema(simple)
* pre-fetches gallery images to speed rendering time(especially for flickr and picasa). Fetching occurs at a timed interval, can be setup to use clock server
or can manually
be fetched.
* css fixes
* better design for sub-galleries

0.6b2.4
-------
* fixed dependencies to be more flexible

0.6b2.3
-------
* fixed really dumb basic image sizing problem

0.6b2.2
-------
* added French translation(thanks to Sylvain Boureliou)

0.6b2.1
-------
* removed kss dependency
* fixed flickr issues with api version--just pinned the version number(should have done from the start)
* moved all javascript to portal_javascripts
* fixed safari bug when carousel is hidden
* packed all javascript
* even though this is beta, this is a recommended upgrade as there are many improvements and some major fixes
* implemented new timing mechanism

0.6b1.3
-------
* fixed bug with picasa galleries where it was retrieving all the galleries sometimes
* added better error handling

0.6b1.2
-------
* fixed picasa bugs

0.6b1
-----
* moved all gallery types to adapters.
* fixed opera support

0.5.3.2
-------
* plone 3.0 support fixes

0.5.2
-----
* fixed opera bug
* flickr gallery now supports name or id for user an sets

0.5b1
-----
* minor bug fixes

0.5b1
-----
* removed dependency of mooTools and smooth gallery
* dynamically grabs images
* better controls
* better cross browser support

0.4rc3
------
* added basic flickr support

0.4rc2
------
* refactored code to easily add new gallery types
* fails gracefully if gdata isn't installed
* Now you choose the gallery type

0.3 - Beta
----------
* added support for picasa web albums
* fixed a few bugs

.2beta-r67403 - Beta
--------------------
* added content type icons
* cleaned up gallery views

.1 - Initial
------------
* Initial release