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

Adds the ability to tweak portlet ordering by giving each portlet a weight.

Project Description

Introduction

The Plone portlets system gives site managers a powerful system for assigning portlets to different sections, content types, and groups. However, there is a predefined order in which portlets coming from these sources are displayed. So there is no built-in way to, for instance, specify that one contextual portlet should appear above any inherited portlets and another one should appear below them.

This product addresses that limitation by adding to each portlet assignment a “weight” field on the portlet management pages, where an integer can be specified (it defaults to 50). The full list of portlets will be retrieved in their standard order; then a final sort based on the weight will be applied before the portlets are displayed. Portlets with a lower weight will be sorted to the top, while portlets with a higher weight will be sorted to the bottom.

So, for example, if I wanted to display one contextual portlet above all inherited portlets and one contextual portlet below all inherited portlets, I could set their weights to 40 and 60 respectively.

Note that adjustments to the portlet order are saved via an AJAX request; you don’t have to press a button and reload the page to save the new weights.

Import and export of portlet assignment weights via GenericSetup is also supported.

Installation

Add the collective.weightedportlets egg to your buildout. If using Plone 3.1 or 3.2, make sure you add its ZCML as well. The ZCML should be loaded automatically in Plone >= 3.3.

Start Zope and install “Weighted Portlet Ordering” via the Add/Remove Products panel in Site Setup.

Compatibility

This product requires Plone 3.1 or greater.

This product operates by overriding the following parts of the portlet machinery. You may run into problems if using other products or custom code that also overrides these components:

  • the template macros used to render the portlet management UI
  • the IPortletRetriever adapter
  • the IPortletAssignmentExportImportHandler adapter

Self-certification

  • [X] Internationalized
  • [X] Unit tests
  • [X] End-user documentation
  • [X] Internal documentation (documentation, interfaces, etc.)
  • [X] Existed and maintained for at least 6 months
  • [X] Installs and uninstalls cleanly
  • [X] Code structure follows best practice
  • [X] No side effects on Plone sites where not installed

Credits

David Glick [davisagli]

Thanks to Martin Aspeli for the Plone 3 portlet system.

Change history

1.2 (2017-09-05)

  • Support plone.portlets 2.3 [montypie]

1.1 (2013-10-16)

  • Submit changes to portlet weights using jQuery rather than KSS.

    This makes the addon compatible with Plone 4.3.

    You must run the upgrade step to install the javascript.

    [AdCastle, davisagli]

1.0 (2009-10-12)

  • Override the portlet edit macros in a way that is more compatible with ongoing changes in the base template from plone.app.portlets. [davisagli]

1.0rc2 (2009-05-04)

  • Add version.txt so the version shows correctly in Plone <3.3. [davisagli]
  • Fixed last-minute typo that made it into the edit macros. [davisagli]

1.0rc1 (2009-05-01)

  • Initial release. [davisagli]
Release History

Release History

This version
History Node

1.2

History Node

1.1

History Node

1.0

History Node

1.0rc2

History Node

1.0rc1

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.weightedportlets-1.2.tar.gz (18.3 kB) Copy SHA256 Checksum SHA256 Source Sep 5, 2017

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