Skip to main content

A portlet that provides the links of an action category

Project description

collective.portlet.actions

By Alter Way Solutions.

https://travis-ci.org/collective/collective.portlet.actions.png

Show in a portlet of a Plone site the links and (maybe translated) titles of the actions of a selected category.

Compared with the static text portlet, action URLs are computed and links may be protected by a TALES condition and permissions, such the same portlet may provide different links to various users or in various contexts.

Requirements

collective.portlet.actions requires Plone 3.2 or greater.

With Plone 4.3 this product is obsolete. An action portlet is included in core itself with plone.app.portlets >= 2.5.0

Install

Usual install

collective.portlet.actions is a Python egg with a ZCML slug, such you just need to add these lines in your zc.buildout config file:

[instance]
recipe = plone.recipe.zope2instance
...
eggs =
  ...
  collective.portlet.actions
  ...
zcml =
  ...
  collective.portlet.actions

As of Plone 3.2, you don’t need to add collective.portlet.actions to the zcml option.

Then re-run your buildout config.

See docs/INSTALL.txt for other installation methods.

Development

Please read the comments on top of buildout.cfg that comes with the subversion checkout.

Add a portlet

Of course, if an existing actions category doesn’t fit what you need, you may add your own actions category in the portal_actions tool and add actions in it. Action titles may be translated if you provide an i18n domain.

You may add an icon directly in the action definition, as a TAL expression that provides the icon object. e.g. portal/book_icon.gif.

You may associate an icon to each action using the portal_actionicons tool too if you prefer the old way.

When done, add an ‘Actions portlet’ anywhere you want. Give a title and select the appropriate actions category.

If you choose to show action icons, you may change the default icon for actions that have no icon from their own or through the portal_actionicons tool. The value for the default icon is evaluated from the context when publishing the portlet.

You’re done.

License

This component is protected by the terms of the GPL v2 license. Please read the docs/LICENSE.\* files.

Further documentation

Please read the docs directory, as well as other specific README.txt in other places of this component.

Home page

You may find further informations, a tracker and support resources from the home page at plone.org.

Code repository

https://github.com/collective/collective.portlet.actions

Credits

Development

Translations

See collective/portlet/actions/locales/README.txt if you need to translate this component into another language.

Changelog

1.2.3.post1 (2016-06-10)

  • Pin buildout to latest Plone 4.2 [tomgross]

1.2.3 (2016-06-10)

  • Add note about inclusion of this product in Plone 4.3 [tomgross]

1.2.2 (2012-10-19)

  • Nothing changed yet.

1.2.1 (2012-10-12)

1.2.0 (2012-03-26)

  • Fix link’s background image when “Show icons” is not checked [sylvainb]

  • For Plone 4.1 we need to import CMF core permissions in configure.zcml [sylvainb]

  • Update i18n files and add missing french translations [sylvainb]

  • Add possibility to hide portlet title [jriboux]

  • Replace html table by portlet items and set action icons as backgrounds of each action link [jriboux]

  • Plone 4 : Retreive actions list in a plone 4 compatible way and update tests to work on plone 4 [jriboux]

  • Added new tests for object_buttons category [davidemoro]

  • Fixed support for object_buttons category [davidemoro]

  • Added italian translation [davidemoro]

  • Added MANIFEST.in [tom_gross]

  • Fixed compatibility Plone 3.2 - 4.2 [tom_gross]

1.1.0

  • Fixing tests and adding new tests for portal_tabs [glenfant]

  • Optims for portal_tabs rendering (same invariant stuffs were computed twice) [glenfant]

  • Special case for “portal_tabs” actions category that may rely on items available in the Plone content root. [kroman0]

1.0.1

  • 2009/05/20: fixed caching of actionLinks renderer’s method, caching is still applied but this is possible now to have more than one actions portlet with a different settings on the same page, appropriate test added [piv]

1.0.0

Initial release

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.portlet.actions-1.2.3.post1.tar.gz (25.6 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