Patch DocumentTemplate to not return any content.
Project description
Patch DocumentTemplate to not return any content.
Features
DTML documents have been deprecated for several years, at least within the Plone community. So you should not use them. But still Plone ships with DTML documents. And these may contain security issues, especially for Cross Site Scripting (CSS). So this package patches the Document Templates to not return any content.
Options
The package looks for a few environment variables.
- SHOW_ORIGINAL_DTML
When this is set to a true value, the original DTML value is printed in the zope instance log. The arguments and keyword arguments are also shown, so you can know where this is coming from. Default: false.
- DEBUG_DTML_VALUE
When this is set, the given value is return as content of the DTML. Default: empty string.
- EXPERIMENTAL_NODTML_ONLY_WARN
When this is set to a true value, instead of replacing the dtml value, a warning is logged. When true, the SHOW_ORIGINAL_DTML and DEBUG_DTML_VALUE settings are ignored. Default: false.
- EXPERIMENTAL_NODTML_RAISE
When this is set to a true value, instead of replacing the dtml value, an exception is raised. When true, the other settings are ignored. Default: false.
Accepted True values are: true, t, 1, yes, y.
Installation
Install experimental.nodtml by adding it to your buildout:
[buildout]
...
eggs =
experimental.nodtml
and then running bin/buildout
No zcml is needed.
Supported Plone Versions
Plone 4.x
Plone 5.x
We are only patching DocumentTemplate so this works with any plain Zope2.
Contribute
Issue Tracker: https://github.com/plone/experimental.nodtml/issues
Source Code: https://github.com/plone/experimental.nodtml
License
The project is licensed under the GPLv2.
Contributors
Maurits van Rees, maurits@vanrees.org
Changelog
1.2 (2016-11-14)
New features:
Added EXPERIMENTAL_NODTML_RAISE option. [maurits]
1.1 (2016-09-28)
New features:
Added EXPERIMENTAL_NODTML_ONLY_WARN option. [maurits]
Bug fixes:
Interpret value of SHOW_ORIGINAL_DTML as true value. Accepted True values are: true, t, 1, yes, y. [maurits]
Show arguments and keyword arguments when SHOW_ORIGINAL_DTML is true. [maurits]
Return empty string instead of empty unicode by default. Otherwise you get exceptions when loading dtml files in for example the css registry on Plone 4.3. [maurits]
1.0.2 (2016-09-24)
Bug fixes:
Fixed showing String .__str__. [maurits]
1.0.1 (2016-09-24)
Bug fixes:
Added z3c.autoinclude entry point, so our code gets loaded on startup. [maurits]
1.0 (2016-09-24)
Initial release. [mauritsvanrees]
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
