Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install plone.app.toolbar

How to install plone.app.toolbar

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install plone.app.toolbar
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
Linux (64-bit)
1.3.0 Available View build log
Depended by
Lastest release
version 1.3.0 on Jan 9th, 2014

plone.app.toolbar installs a new content editing toolbar for Plone.


  • Move the admin toolbar currently found in the content of a page (when

    logged in) to a separate, encapsulated, bar at the top of the page.

  • Make it so themer's do not need to handle or manage admin specific UI,

    unless it is something they are are intentionally doing


To install toolbar drop following lines to your buildout.cfg:

extends = http://dist.plone.org/release/4.3rc1/versions.cfg
versions = versions
parts = instance

recipe = plone.recipe.zope2instance
user = admin:admin
http-address = 7000
eggs =
zcml =

plone.app.jquery = 1.8.3
plone.app.widgets = 0.2
plone.app.toolbar = 1.2

Bellow version pins are for Plone version 4.3rc1 or higher.

Make sure you install the "Plone Toolbar" profile when creating your Plone site or include plone.app.toolbar:default profile in your metadata.xml..

To start developing plone.app.toolbar you can find buildout at buildout.deco repository.:


Diazo rules

First we need to copy the toolbar's HTML code:

<before theme-children="/html/body"
    content="//div[@data-iframe='plone-toolbar']" />

Then, in case we are not copying all resources from Plone (content) into the theme we have to include the toolbar's resources and its dependencies as well:

<before theme-children="/html/head">
    <link rel="stylesheet" type="text/css"
    <link rel="stylesheet" type="text/css"
    <link rel="stylesheet" type="text/css"
    <script type="text/javascript"
    <script type="text/javascript"
    <script type="text/javascript"
    <script type="text/javascript"

Also, in order to correctly support updating a page after using Edit, you must ensure that the element #portal-column-content exists within your theme. In short, as with Plone's default theme, this element should correspond to the main content column. It will be repopulated with updated content after an edit action takes place via the toolbar. A rule similar to this is needed - in this case, the entire element is placed into the theme:

<replace css:theme-children="#content article"
    css:content="#portal-column-content" />

For the technically minded, the element of #portal-column-content will be repopulated with HTML corresponding to the same element ID from a response body returned after an edit takes place.

The above rules and consideration should be enough so that your theme will support plone.app.toolbar.

Subscribe to package updates

Last updated Jan 9th, 2014

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.