Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Viewlet displaying user-editable links on portal or folder level

Project Description


This package provides a viewlet that lets you enter in a list of local and external links on plonesite level and on subfolders. Usually these links get displayed in the footer, but the viewlet can be placed anywhere.

After installation the viewlet displays a Manage links button for users with the corresponding permission (granted to managers by default). Users can set the links for a context that implements ICanDefineLinks (plonesite or folders by default) by inserting them in a textfield like this:


Links defined on the portal get displayed in subfolders too, as long as they do not define their own links.

See the package README for a test describing this package’s functionality in detail.

A screenshot of how links can be added and how they are displayed can be found on the product page on


To use this package in a plone buildout add to the eggs section and to the zcml slug for the zope instance:

recipe = plone.recipe.zope2instance
eggs =
zcml =

Since collective.viewlet.links requires the buildout is a little more complicating. See the developer buildout for an example.

  • use plone.recipe.zope2install >= 3.0 (default fake-eggs)
  • use same skip-fake-eggs


Please submit bugs or feature requests to the issue tracker on the product page.

If you want to contribute to collective.viewlet.links, you can use the developer buildout.

See the README there for instructions on how to setup an instance and run the tests.


Liz Dahlstrom (lizz-y)
Initial idea and implementation
Harald Friessnegger (fRiSi)
added support for custom links for content objects, unittests, devbuildout and made links be stored in an annotation


2009/12/11 0.2rc1

Improved validation allows internal links and displays errors so users know which links did not validate.

  • validation allows internal links again [Liz]
  • include so validation errors are displayed nicely [fRiSi]
  • added reference to product page and a screenshot to the README. [fRiSi]
  • added i18n infrastructure and german translations (see developer buildout README for information how to add new translations [fRiSi]
  • fixed GS version number so it won’t get confused with package version ( [fRiSi]

2009/03/31 0.1rc2

  • using safe_unicode in i18n messagefactories to make them work with non ascii characters too. (viewlet raised an error when used on folders with umlauts in their title) [fRiSi]

2009/03/30 0.1rc1

initial release

  • validator that checks for correct syntax and valid urls [Liz]

  • css for formatting links similar to portal colophon links [fRiSi]

  • @@manage-links is able to edit links instead of needing to insert all of them again [fRiSi]

  • cleanup package: removed configlet, widget and other stuff that’s not needed for a functioning product yet. all the stuff is still available for lizzy in [fRiSi]

  • added custom permission for managing links [fRiSi]

  • using List(value_type=Object(schema=ILink)) for storing links [fRiSi]

  • enabled storing links on any folder as annotation

  • added README with basic functional test that ensures defining links and displaying them in viewlet works [fRiSi]

  • fixed tests for plone 3.1 and plone.z3cform 0.3

    (see nouri’s comment “Updated to work with 0.3 plone.z3cform and” on [fRiSi]

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
collective.viewlet.links-0.2rc1.tar.gz (21.7 kB) Copy SHA256 Checksum SHA256 Source Dec 11, 2009

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting