experimental.nodtml 1.2

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.

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]