Registry / cms / plone-app-portlets

plone-app-portlets

JSON →
library7.0.0pypypiunverified

Plone integration for the basic plone.portlets package. Provides UI for managing portlets, portlet assignment, rendering, and storage in the Plone CMS. Current version 7.0.0, release cadence follows Plone major releases.

cms
pip install plone.app.portlets
github ↗homepage ↗
INSTALL
IMPORT
SIG · PLONE-APP-PORTLETS
P
plone-app-portlets
cmspythonv7.0.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

portlet_assignment
✓ from plone.app.portlets.utils import portlet_assignment
✗ from plone.app.portlets.utils import portlet_assignment

Get portlet assignments for the navigation root context. Works with Plone site.

from plone.app.portlets.utils import portlet_assignment from plone import api context = api.portal.get_navigation_root() assignments = portlet_assignment(context) print('Assignments:', list(assignments.keys()))
Debug
Known issues
breakingPlone 6 / Python 3.10+ removed Archetypes support. plone.app.portlets no longer works with Archetypes-based content types.
fix
Migrate content types to Dexterity (plone.dexterity) before upgrading.
affects: >=7.0.0
breakingRemoved deprecated `portlet_manager` and `portlet_renderer` functions from plone.app.portlets. They were moved to `plone.portlets` or replaced.
fix
Use `plone.portlets.interfaces.IPortletManager` directly.
affects: >=7.0.0
deprecatedFunction `register_portlet` in plone.app.portlets.utils is deprecated in favor of ZCML registration.
fix
Use <browser:page> and <plone:portlet> ZCML directives instead.
affects: >=7.0.0
gotchaPortlet assignment order in a block is not guaranteed unless you explicitly set sorting. Overriding `sort_order` property is common mistake.
fix
Implement `sort_order` property on your portlet assignment or use `plone.app.portlets.browser.edit` sorting.
affects: all
gotchaCSS class names for portlet rendering changed in Plone 6. Custom portlets may display incorrectly if they rely on old class names.
fix
Update your portlet templates to use Plone 6 CSS patterns (Bootstrap 5).
affects: >=7.0.0
Upgrade
Version history
7.0.0latest on PyPI · released May 7, 2026
Audit
Dependencies
plone.portletsrequiredCore portlet infrastructure
plone.baserequiredPlone base components
zope.componentrequiredComponent architecture
zope.interfacerequiredInterface definitions
zope.schemarequiredSchema fields for portlet configuration
Agent activity
31 hits · last 30 days
node
24
Resources
githubhttps://github.com/plone/plone.app.portlets ↗
homepagehttps://github.com/plone/plone.app.portlets ↗
plone-app-portlets — pip install plone-app-portlets · libregistry