https://github.com/miohtama/imageportlet

An image portlet for Plone 4
https://github.com/miohtama/imageportlet

Last synced: 3 months ago
JSON representation

An image portlet for Plone 4

• Host: GitHub
• URL: https://github.com/miohtama/imageportlet
• Owner: miohtama
• Created: 2012-06-15T16:39:09.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2015-10-13T18:52:03.000Z (over 9 years ago)
• Last Synced: 2024-04-24T13:56:03.844Z (9 months ago)
• Language: Python
• Size: 152 KB
• Stars: 3
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.txt

Awesome Lists containing this project

README

        
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.

.. 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 ```` 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

.. image :: https://github.com/downloads/miohtama/imageportlet/Screen%20Shot%202012-11-15%20at%204.32.42%20PM.png

Use cases

===========================

* `Image menus and links `_

* `image buttons `_.

* `In-house advertisement banners `_

* `Mini image carousels `_.

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: ((, , <+ at /test/++contextportlets++plone.rightcolumn/+>), , 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 `_

* `collective.tabr ´_

Author

===========================

`Mikko Ohtamaa `_