MlangoViewlets (1.2)
- MlangoViewlets download link: http://plone.org/products/mlangoviewlets/releases
- Homepage of MlangoViewlets: http://plone.org/products/mlangoviewlets
- MlangoViewlets repository: http://dev.plone.org/collective/browser/MlangoViewlets/trunk/
- Description source: http://dev.plone.org/collective/browser/MlangoViewlets/trunk/README
(see: http://www.goldmund-wyldebeast-wunderliebe.com/products/mlango)
MlangoViewlets is an add on product on top of the core Mlango dashboard product.
'Mlango' is Swahili for 'gate', 'door', etc. Mlango intends to provide a modern user experience for Plone users.
Installation
Dependencies:
- Archetypes
- InstallUtils
- Mlango
- MimetypesRegistry
- PortalTransforms
Viewlets
Viewlets are configured in the viewlet registry. Some examples are distributed with the core Mlango products as well as with the MlangoViewlets product. The registry is held by the Mlango tool. A viewlet configuration consists of the following fields used by the rendering framework
Name |
Required |
Description |
id | y | Unique id for this viewlet. The id should contain no
spaces! |
title | y |
Title to show in top bar |
icon | n | Icon to show in viewlet toolbox |
macro | y | Macro needed to render the viewlet |
help | n | Help text. If given, a help icon will be rendered in the viewlet's toolbar. |
properties | n | A map of properties. If provided an edit icon will be rendered in the viewlet's toolbar. |
properties_form | n | Required in combination with properties. Defines the
form used for changing properties. |
fixed | n | Defaults to -1. If set to a number larger than that, it will be placed in that column. No drag and no remove will be allowed. |
Apart from that, any other fields may be added, to be used by for instance the viewlet macro. So if you wish to use an RSS source form instance, add a field rss_url. Within the macro this field will now be available as info/rss_url (or python: info['rss_url'].
Modifying viewlets
Adding viewlets:
- Create a page template in MlangoViewlets/skins/mlango_viewlets/
- Add the viewlet to VIEWLETS in MlangoViewlets/config.py