collective.calltoaction 1.1.3

Portlet with call to action

collective.calltoaction

This shows a call to action: an overlay with an image, titel rich text. This calls the attention of a visitor to take action, usually to click a link or button.

Compatibility

Works on Plone 4.3.x, tested explicitly on Plone 4.3.8 and 4.3.11. Not yet compatible with Plone 5: the javascript and css need work.

Features

• A call to action portlet. This is basically a copy of the static text portlet with a few extra options.

• In the portlet you can set the number of milliseconds before the overlay is shown. This can be several minutes and go over multiple pages: using a cookie, we keep track of how long you have been on the site.

• When the overlay is shown, the cookie is updated so that we show the overlay only once. The cookie is specific for this portlet: a new call to action portlet will be shown once too.

• When you edit the portlet, you can use a checkbox to say that this is not a minor edit, but a new version. The previous cookie is then not valid anymore and the visitor will again see the overlay once.

• The portlet itself is never shown. Instead a viewlet looks for portlets and shows the contents after a pause. This avoids a portlet column taking up space but not showing anything when there are no other portlets.

• You can create multiple portlets if you really want to, but only one overlay is shown on a page. If there are three portlets, and the user has already seen the first one but not the others, then the second one will be shown.

• There is a control panel where you can say that the action is global across the site. This can help if parts of your site block the portlets and you still want to see the action there.

Examples

This add-on is planned to be used on https://www.arbounie.nl and http://www.zeelandia.com, who have sponsored development, but the sites may not always have a call to action configured.

Translations

This product has been translated into

• Dutch (Maurits van Rees)

Installation

Install collective.calltoaction by adding it to your buildout:

[buildout]

...

eggs =
    collective.calltoaction

and then running bin/buildout

Contribute

• Issue Tracker: https://github.com/collective/collective.calltoaction/issues

• Source Code: https://github.com/collective/collective.calltoaction

• Documentation: https://pypi.python.org/pypi/collective.calltoaction

Support

If you are having issues, please let us know by creating an issue in the tracker.

License

The project is licensed under the GPLv2.

Contributors

• Maurits van Rees, [e-mail]

• Lennard Huiskes, [e-mail]

• Jean-Paul Ladage, [e-mail]

Changelog

1.1.3 (2017-10-17)

• CSS improvements for normal display of image. [jladage]

1.1.2 (2017-10-17)

• Added option to display the image tilted or normal. Update Dutch translations. [jladage]

1.1.1 (2017-02-08)

• Fixed problem when showing viewlet with form globally. After submit, the form could then be shown twice. We had already fixed that for the normal case, but not for the case where the viewlet is globally shown. [maurits]

1.1 (2017-02-07)

• Added form field to portlet. You can select a PloneFormGen FormFolder with this. The portlet then shows this as an embedded form under the title and text. [maurits]

• Added control panel option to always show the popup. This ignores the cookie. This can be handy during development. You need to run the upgrade in the add-ons control panel. [maurits]

1.0 (2016-11-01)

• Added option to show action globally, regardless of blocked portlets. The timeout is now always the time since the first visit of a page with this portlet. [maurits]

1.0rc1 (2016-04-20)

• Set overlay fixed and center of the browser.

1.0b3 (2016-04-13)

• Except AttributeErrors only, and verify if an image is actually uploaded to a newsitem. [jladage]

1.0b2 (2016-04-13)

• Support both ATImage and ATNewsItem as providers of images. [jladage]

1.0b1 (2016-04-06)

• Initial release. [mauritsvanrees]