Skip to main content

Add-on displaying manager defined messages in a viewlet

Project description

https://travis-ci.org/collective/collective.messagesviewlet.svg?branch=master https://coveralls.io/repos/collective/collective.messagesviewlet/badge.svg?branch=master

collective.messagesviewlet

Add-on displaying manager defined messages in a viewlet

The three message types.

Features

Messages are defined in control panel.

Multiple messages can be displayed together in the viewlet.

A message contains the following configuration attributes:

  • text : displayed text in the viewlet

  • message type : info, warning, important (different layout in the viewlet)

  • can hide : if checked, the user can hide the message (mark as read)

  • start date : displaying start date (optional)

  • end date : displaying end date (optional)

  • required roles : user must have one of the required roles (optional)

  • use local roles : message displayed for users having Reader local role on message (optional)

  • location : full site or homepage only

The collective.behavior.talcondition is enabled, providing 2 attributes.

  • tal condition : optional tal expression evaluated on viewlet context

  • bypassing roles : optional roles bypassing the tal condition

The management interface.

A workflow is provided with the following states:

  • inactive : not displayed

  • activated : displayed

The hiding functionality uses a cookie. It is necessary to deactivate a message to “reset” the cookie. When activating again, the message will be displayed again even for users that hide it.

The optional ‘messages’ profile adds some usefull examples that can be activated when needed:

  • message for scheduled maintenance (limited to Member)

  • message for imminent or current maintenance : (given to anonymous)

  • message for staging site

Improvements

  • Modify hidden_uid when some fields are changed: end when gone, can_hide (to unchecked), start when end is gone

  • Message definition from file system

  • Message definition from rss feed

Translations

This product has been translated into

  • English

  • French

Installation

Install collective.messagesviewlet by adding it to your buildout:

[buildout]

 ...

 eggs =
     collective.messagesviewlet

and then running “bin/buildout”

Contribute

Support

If you are having issues, please let us know.

License

The project is licensed under the GPLv2.

Contributors

Changelog

0.9 (2016-03-30)

  • Increased coverage by using vocabulary methods instead of redefining it in tests. [gbastien]

  • Added new example message: bad browser (not Firefox) warning [sgeulette]

  • Use plone.formwidget.datetime to have hour at 0 by default. [sgeulette]

  • CSS fix : display ‘cursor: pointer;’ when hovering the close button. [gbastien]

  • Added ‘MessagesConfig’ to site_properties.types_not_searched. [gbastien]

0.8 (2016-01-18)

  • Added parameter ‘activate’ to utils.add_message that makes it possible to create an ‘activated’ message directly. [gbastien]

  • Adapted tests to use utils.add_message instead of duplicating this code. [gbastien]

0.7 (2015-11-17)

  • Do not pass a default ‘context’ in utils._ to avoid strange ConnectionStateError. [gbastien]

  • Give context to translate method. [sgeulette]

  • Corrected and added icon type images. [sgeulette]

0.6 (2015-09-18)

  • Simplify workflow. Only one activated state. Unrestricted search results before filtering. Added ‘use local role’ boolean attribute. [sgeulette]

  • Updated default messages [sgeulette]

  • Added local roles test [sgeulette]

  • Renamed bad transition name [sgeulette]

0.5 (2015-09-14)

  • Removed useless dependency on z3c.jbot. [gbastien]

  • Corrected rst in readme. [sgeulette]

0.4 (2015-09-10)

  • Use full url for readme images to display correctly on pypi. [sgeulette]

0.3 (2015-09-10)

  • Translate title configuration folder. [sgeulette]

0.2 (2015-09-09)

  • Added utils method to create message. Added example profile to add some messages. [sgeulette]

0.1 (2015-09-08)

  • Initial release. [sgeulette, anuyens, DieKatze, boulch]

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

collective.messagesviewlet-0.9.tar.gz (196.5 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