Skip to main content

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]

Project details


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)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page