Metadata-Version: 2.4
Name: plone.app.debugtoolbar
Version: 2.0.0
Summary: Debug toolbar for Plone
Home-page: https://pypi.org/project/plone.app.debugtoolbar/
Author: Martin Aspeli
Author-email: optilude@gmail.com
License: GPL
Keywords: plone debug toolbar
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 6.2
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: setuptools
Requires-Dist: Products.CMFPlone
Requires-Dist: zope.annotation
Requires-Dist: plone.transformchain
Requires-Dist: Paste
Provides-Extra: test
Requires-Dist: plone.app.testing; extra == "test"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

Introduction
============

``plone.app.debugtoolbar`` provides a wealth of debug information about a
running Plone site at your fingertips.


Translations
============

This product has been translated into

- Italian (thanks, Giacomo Spettoli)

- Spanish (thanks, Leonardo J. Caballero G.)


Installation
============

Simply install it in your build (e.g. by adding it to the ``eggs`` list in your Buildout):

::

    [buildout]

    ...

    eggs =
        plone.app.debugtoolbar


and re-running the ``bin/buildout`` command 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 information 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 noticeable 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.


Contribute
----------

- Issue Tracker: https://github.com/plone/plone.app.debugtoolbar/issues
- Source Code: https://github.com/plone/plone.app.debugtoolbar
- Documentation: https://github.com/plone/plone.app.debugtoolbar/blob/master/README.rst


License
-------

The project is licensed under the GPLv2.

Contributors
============

- Martin Aspeli, Author
- Giacomo Spettoli, i18n
- Leonardo Caballero, Spanish Translation, Uninstall GenericSetup profile

All the list of contributors is available at the following link: https://github.com/plone/plone.app.debugtoolbar/graphs/contributors

Changelog
=========

.. You should *NOT* be adding new change log entries to this file.
   You should create a file in the news directory instead.
   For helpful instructions, please see:
   https://github.com/plone/plone.releaser/blob/master/ADD-A-NEWS-ITEM.rst

.. towncrier release notes start

2.0.0 (2026-05-18)
------------------

Bug fixes:


- Fix FileNotFoundError on str(attr) when attr is <App.special_dtml.DTMLFile object at 0x109b2c530>
  [pbauer] (#34)


2.0.0a1 (2025-12-23)
--------------------

Breaking changes:


- Replace ``pkg_resources`` namespace with PEP 420 native namespace.
  Support only Plone 6.2 and Python 3.10+.
  @petschki


1.4.0 (2024-03-19)
------------------

New features:


- Added more improvements about i18n support [macagua]

  Updated Spanish translation [macagua]

  Updated the documentation [macagua]

  Upgraded the buildout configuration to Plone 6.0 version [macagua] (#31)


1.3.0 (2022-12-02)
------------------

Bug fixes:


- Add support for Python 3.11 [pbauer] (#30)


1.2.3 (2021-12-29)
------------------

Bug fixes:


- Fix missing zcml directive when `plone.app.standardtiles` is installed.
  [petschki] (#18)
- Fix brackets in toolbar-help
  [djowett] (#25)
- Fix a compatibility issue with Python 3.8 (#27)


1.2.2 (2020-04-20)
------------------

Bug fixes:


- Minor packaging updates. (#1)


1.2.0 (2019-01-09)
------------------

New features:

- Prepare for Python 2 / 3 compatibility [jmevissen]


1.1.4 (2018-03-07)
------------------

Bug fixes:

- Remove unittest2 dependency
  [kakshay21]

- Make it work in chrome, as '<script />' no longer works.
  [jaroel]


1.1.3 (2017-07-03)
------------------

Bug fixes:

- Fix problem with debugtoolbar panel opening on click but immediately closing again.
  [sunew]


1.1.2 (2017-03-31)
------------------

Bug fixes:

- Fix imports from Globals that was removed in Zope4
  [pbauer]

- Add coding headers on python files.
  [gforcada]

1.1.1 (2016-08-17)
------------------

Bug fixes:

- Use zope.interface decorator.
  [gforcada]


1.1.0 (2016-06-07)
------------------

New:

- Add a ``plone.app.debugtoolbar.toolbar`` tile for displaying in plone.app.blocks layouts.
  [thet]

- Plone 5 compatibility: Don't register JS and CSS but include them inline.
  Includes upgrade step.
  [thet]

- Added panel with catalog info: indexed values and metadata of the current
  object.
  [sunew]


1.0 (2014-08-13)
----------------

- Fix ``scrollHeight`` for the interactive prompt for jQuery 1.7+. Now,
  executing code jumps again to the latest prompt message.
  [thet]

- Removed 'xxx__roles__' methods from Context / Methods viewlet and added
  roles + permission for each method when available.
  [glenfant]

- Emphasize marker interfaces in context view
  [glenfant]

- Provide same variables as in portal_actions in TAL tests
  [glenfant]

- Fix themelayer. Use IBrowserSkinType instead of generic
  Interface which can return an real utility instead of an
  iface and broke the page rendering. Skin Layer must inherits
  from IBrowserSkinType
  [toutpt]


1.0a3 (2013-02-06)
------------------

- completed i18n support and added it translation

- add reload panel
  [vangheem]

- added Spanish translation and Uninstall GenericSetup profile
  [macagua]

- completed i18n support and added it translation
  [giacomos]

- replace checkboxes with mark symbols in permission matrix
  [gaudenz]

- permission matrix display improvements
  [gaudenz]

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]

