plone.app.debugtoolbar 1.0a2

Debug toolbar for Plone

Introduction

plone.app.debugtoolbar provides a wealth of debug information about a running Plone site at your fingertips. Simply install it in your build (e.g. by adding it to the eggs list in your Buildout and re-running buildout) and install it into your Plone site.

You should now see a Debug link at the top of your site. Click it to open the debug drawer. Click on a panel to view relevant information.

Panels include:

• Context, showing information about the current content object

• Interactive, providing an interactive Python prompt through which you can interact with the current context (only available to users with the Manage portal permission)

• Request, showing information about the request that produced the current page

• Response, showing informationa about the response that produced the current page

• Published, showing information about the page template or view that was published

• Theme, showing information about the current theme and browser layers

• User, showing information about the current user

• Workflow, showing information about workflow and security

• Zope, showing information about how the Zope server is configured

• Versions, listing the versions of every package known to the Zope process

Safety

The debug toolbar provides a lot of information about your Plone site that you may not want the world to know. It could also have a noticable performance impact, and for users with the Manage portal permission it provides access to an interactive interpreter where arbitrary Python statements can be executed, allowing a user to bypass Zope security.

In other words: Do not install this package on your production server.

Integration

Each panels is included as a viewlet. You can register new panels using a viewlet registration like this:

<browser:viewlet
    name="plone.app.debugtoolbar.somepanel"
    manager="plone.app.debugtoolbar.browser.interfaces.IDebugToolbarViewletManager"
    class=".somepanel.SomePanelViewlet"
    template="somepanel.pt"
    permission="zope2.View"
    layer="plone.app.debugtoolbar.browser.interfaces.IDebugToolbarLayer"
    />

See plone.app.debugtoolbar.browser for plenty of examples of panels.

Contributors

Martin Aspeli, Author

Changelog

1.0a2 (13/11/2011)

• Add interactive code debugging [optilude]

• Add TALES tester [optilude]

• Add details of context methods and attributes [optilude]

1.0a1 (13/11/2011)

• Initial release [optilude]