imageportlet add-on provides a portlet for Plone CMS for easily add images, banners and carousels around the content on your site
Project description
Introduction
===========================
*imageportlet* add-on provides a portlet for `Plone CMS <http://plone.org>`_
for easily add images, banners and carousels around the content on your site.
The add-on is very useful for extra portlet manager add-ons like
`Products.ContentWellPortlets <http://plone.org/products/contentwellportlets>`_
to bannerize and decorate your site.
.. contents:: :local:
Features
===========================
* Inline image upload from a local computer directly into the portlet. No separate image bank folder management needed.
* Image can act as a link or simply serve as a decorative banner
* Plain text slots for heading, footer, over-the-image text (button) and ``<img>`` alt text
* Carousel images via `jQuery Cycle Lite <http://jquery.malsup.com/cycle/>`_
* Cache friendly: unique URLs after each edit allows the images cached forever in the front-end cache
.. image :: https://github.com/downloads/miohtama/imageportlet/Screen%20Shot%202012-11-15%20at%204.32.42%20PM.png
Use cases
===========================
* `Image menus and links <http://www.visitkalajoki.fi>`_
* `image buttons <http://www.visitkalajoki.fi/fi/teemat/pariskunnat>`_.
* `In-house advertisement banners <http://www.visitkalajoki.fi>`_
* `Mini image carousels <http://www.hotellilevitunturi.fi/fi/>`_.
Benefits
===========================
The benefit over static text portlet + TinyMCE uploaded images is vastly
easier user experience. You don't need to separate portlets or place to upload the image:
images are managed within the portlet.
The management is much streamlined for non-power users.
Installation
===========================
The add-on is compatible down to Plone 3.3.5.
Update buildout.
Plone 4.2 and newer: add ``imageportlet`` to eggs in buildout.cfg::
eggs =
...
imageportlet
Old releases: `With Dexterity 1.1 pindowns <http://plone.org/products/dexterity/documentation/how-to/install>`_::
# Change the number here to change the version of Plone being used
extends =
http://dist.plone.org/release/3.3.5/versions.cfg
http://good-py.appspot.com/release/dexterity/1.1?plone=3.3.5
eggs =
...
imageportlet
Run buildout.
Install the ``imageportlet`` add-on in Site Setup.
Go to any portlet manager and choose *Add new portlert... Image Portlet*.
Limitations
===========================
IE6, IE7 cannot do over-the-image text correclty and those portlets are hidden.
Troubleshooting
===========================
Traceback::
Traceback (innermost last):
Module ZPublisher.Publish, line 119, in publish
Module ZPublisher.mapply, line 88, in mapply
Module ZPublisher.Publish, line 42, in call_object
Module imageportlet.z3cformhelper, line 66, in __call__
Module z3c.form.form, line 215, in __call__
Module z3c.form.form, line 208, in update
Module plone.z3cform.patch, line 21, in BaseForm_update
Module z3c.form.form, line 149, in update
Module z3c.form.form, line 128, in updateWidgets
Module zope.component._api, line 103, in getMultiAdapter
ComponentLookupError: ((<Products.Five.metaclass.AddForm object at 0x1137edfd0>, <HTTPRequest, URL=http://localhost:9888/test/++contextportlets++plone.rightcolumn/+/imageportlet.ImagePortlet>, <+ at /test/++contextportlets++plone.rightcolumn/+>), <InterfaceClass z3c.form.interfaces.IWidgets>, u'')
Reason: Make sure *Plone z3c.form support* is installed on the site.
Source code and issue tracker
======================================================
* https://github.com/miohtama/imageportlet
Similar add-ons
=================
* `redomino.tabsandslides <http://pypi.python.org/pypi/redomino.tabsandslides/>`_
* `collective.tabr <https://github.com/collective/collective.tabr>´_
Author
===========================
`Mikko Ohtamaa <http://opensourcehacker.com>`_
Changelog for imageportlet
--------------------------
1.1 (2013-05-04)
----------------
- Plone 4.3 compatibility / grok.CodeView issue [miohtama]
1.0 (2012-11-15)
----------------
- Initial release [miohtama]
===========================
*imageportlet* add-on provides a portlet for `Plone CMS <http://plone.org>`_
for easily add images, banners and carousels around the content on your site.
The add-on is very useful for extra portlet manager add-ons like
`Products.ContentWellPortlets <http://plone.org/products/contentwellportlets>`_
to bannerize and decorate your site.
.. contents:: :local:
Features
===========================
* Inline image upload from a local computer directly into the portlet. No separate image bank folder management needed.
* Image can act as a link or simply serve as a decorative banner
* Plain text slots for heading, footer, over-the-image text (button) and ``<img>`` alt text
* Carousel images via `jQuery Cycle Lite <http://jquery.malsup.com/cycle/>`_
* Cache friendly: unique URLs after each edit allows the images cached forever in the front-end cache
.. image :: https://github.com/downloads/miohtama/imageportlet/Screen%20Shot%202012-11-15%20at%204.32.42%20PM.png
Use cases
===========================
* `Image menus and links <http://www.visitkalajoki.fi>`_
* `image buttons <http://www.visitkalajoki.fi/fi/teemat/pariskunnat>`_.
* `In-house advertisement banners <http://www.visitkalajoki.fi>`_
* `Mini image carousels <http://www.hotellilevitunturi.fi/fi/>`_.
Benefits
===========================
The benefit over static text portlet + TinyMCE uploaded images is vastly
easier user experience. You don't need to separate portlets or place to upload the image:
images are managed within the portlet.
The management is much streamlined for non-power users.
Installation
===========================
The add-on is compatible down to Plone 3.3.5.
Update buildout.
Plone 4.2 and newer: add ``imageportlet`` to eggs in buildout.cfg::
eggs =
...
imageportlet
Old releases: `With Dexterity 1.1 pindowns <http://plone.org/products/dexterity/documentation/how-to/install>`_::
# Change the number here to change the version of Plone being used
extends =
http://dist.plone.org/release/3.3.5/versions.cfg
http://good-py.appspot.com/release/dexterity/1.1?plone=3.3.5
eggs =
...
imageportlet
Run buildout.
Install the ``imageportlet`` add-on in Site Setup.
Go to any portlet manager and choose *Add new portlert... Image Portlet*.
Limitations
===========================
IE6, IE7 cannot do over-the-image text correclty and those portlets are hidden.
Troubleshooting
===========================
Traceback::
Traceback (innermost last):
Module ZPublisher.Publish, line 119, in publish
Module ZPublisher.mapply, line 88, in mapply
Module ZPublisher.Publish, line 42, in call_object
Module imageportlet.z3cformhelper, line 66, in __call__
Module z3c.form.form, line 215, in __call__
Module z3c.form.form, line 208, in update
Module plone.z3cform.patch, line 21, in BaseForm_update
Module z3c.form.form, line 149, in update
Module z3c.form.form, line 128, in updateWidgets
Module zope.component._api, line 103, in getMultiAdapter
ComponentLookupError: ((<Products.Five.metaclass.AddForm object at 0x1137edfd0>, <HTTPRequest, URL=http://localhost:9888/test/++contextportlets++plone.rightcolumn/+/imageportlet.ImagePortlet>, <+ at /test/++contextportlets++plone.rightcolumn/+>), <InterfaceClass z3c.form.interfaces.IWidgets>, u'')
Reason: Make sure *Plone z3c.form support* is installed on the site.
Source code and issue tracker
======================================================
* https://github.com/miohtama/imageportlet
Similar add-ons
=================
* `redomino.tabsandslides <http://pypi.python.org/pypi/redomino.tabsandslides/>`_
* `collective.tabr <https://github.com/collective/collective.tabr>´_
Author
===========================
`Mikko Ohtamaa <http://opensourcehacker.com>`_
Changelog for imageportlet
--------------------------
1.1 (2013-05-04)
----------------
- Plone 4.3 compatibility / grok.CodeView issue [miohtama]
1.0 (2012-11-15)
----------------
- Initial release [miohtama]
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
imageportlet-1.1.zip
(27.2 kB
view hashes)