Skip to content

miohtama/imageportlet

Repository files navigation

Introduction

imageportlet add-on provides a portlet for Plone CMS 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 to bannerize and decorate your site.

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
  • Cache friendly: unique URLs after each edit allows the images cached forever in the front-end cache

Use cases

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:

# 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

Similar add-ons

Author

Mikko Ohtamaa