Header Animations
Allow placing header animations and header images on site sections and content
Project Description
Header Animation add-on product (plone.app.headeranimation package) provides a way to add site section specific Flash animations or big images to the web page header.
The indented audience is site integrators and theme developers.
Content editors can upload animations and images from new Header tab which appears on all content. The header may set to be effective just for a single page or all child content.
Requirements
- Plone 3.x
- BLOB support for your buildout.cfg (see below)
- Skill to deal with complex component version configuration issues
Installation
Add to your buildout.cfg:
eggs = plone.app.headeranimation zcml = plone.app.headeranimation
You also need to set up plone.namedfile BLOB support in your buildout.cfg:
[instance] ... # Path relative to buildout root where uploaded files will be stored blob-storage = blobs
Warning: Due to young nature of plone.behavior complex component version pindowns must be done. A complex set of good known version configuration is provided. When Plone 4 is released, managing the good known set is expected to be easier. Please see attached docs/example_buildout.cfg to hints to how to pin down versions.
The good known version set is based one provided for plone.dexterity.
Integration
There are three methods of integrating plone.app.headeranimation to your theme. Note that header animations may look poor on full-width layout themes, like the Plone 3.x default theme.
- # Use the provided plone.app.headeranimation viewlet and put it to a meaningful place
- in your viewlet stack
# Call HeaderAnimationRenderer (view) from your custom viewlet
# Call HeaderAnimationRenderer (view) from your template directly
Components
Components used - just to make sure you know what you are dealing with
- plone.behavior
- plone.namedfile
- plone.app.z3cform
Other
Currently (version 0.1) the product is indented to be used with Archetypes content. The product is configured to register header animation to all content implementing IContentish interface. However, the product is not tested with non-Archetypes (Dexterity based) content.
Plone 3.x actions machinery is used to register the header tab. Dexterity provides its own mechanism for this. Dexterity mechanism is not supported yet. Dummy HeaderAnimationBehaviorAssignable policy is used to force header animation behavior on every content object.
Currently header animation data is stored in zope.annotations. Extra database BTree look up must be to fetch the header data. This slows down opening the page. It is possible to further develop the product to work around this limitations (using prefixed names with attribute storage).
History
A prototype version of the product is used on plonetheme.twinapex. It is based on archetypes.schemaextender instead of plone.behavior.
See also collective.contentleadimage which inspirated this work.
Author
Twinapex Team - Python and Plone professionals for hire.
Current Release
No stable release available yet.
If you are interested in getting the source code of this project, you can get it from the Code repository .
All Releases
| Version | Released | Description | Compatibility | Licenses | Status |
|---|
