Drop-in template overrides.
Python
Latest commit ec1d881 Nov 18, 2015 @mgedmin mgedmin tox: testing on installed code breaks more assertions
I don't have the time and energy to investigate.
Permalink
Failed to load latest commit information.
src/z3c
.gitignore Ignore *.egg-info/ Nov 8, 2015
.travis.yml Use the faster Travis container-based infrastructure Nov 18, 2015
CHANGES.rst Standardize namespace __init__, pylint burps otherwise Nov 4, 2015
COPYRIGHT.rst post-git cleanup Mar 2, 2013
LICENSE.rst post-git cleanup Mar 2, 2013
MANIFEST.in Add a tox.ini Nov 18, 2015
README.rst post-git cleanup Mar 2, 2013
bootstrap.py Update to latest bootstrap.py Dec 26, 2014
buildout.cfg Don't test all of Zope2 please Nov 18, 2015
setup.py Don't test all of Zope2 please Nov 18, 2015
tox.ini tox: testing on installed code breaks more assertions Nov 18, 2015

README.rst

Overview

The z3c.jbot (or "Just a bunch of templates") package allows easy customization of existing templates and images. It works on Zope 2 and Zope 3.

The Chameleon rendering engine is supported [1].

Use of this package adds a small (2-3 ms per request on Plone) to the total application response time.

[1]To enable Chameleon on Zope 2, use the five.pt package (CMF-apps like Plone should use cmf.pt which adds full support).

Usage

To override a particular file, first determine its canonical filename. It's defined as the path relative to the package within which the file is located; directory separators are replaced with dots.

Example:

Suppose you want to override: /plone/app/layout/viewlets/logo.pt

You would use the filename: plone.app.layout.viewlets.logo.pt

Simply drop the file in a directory and register that directory for use with jbot using a ZCML-directive:

<include package="z3c.jbot" file="meta.zcml" />

<browser:jbot
    directory="<path>"
    layer="<layer>" />

Templates in views, viewlets and portlets

Any template that is defined as a class-attribute can be overriden using jbot, e.g. those used in views, viewlets and portlets. The template overrides may be registered for any request layer or only a specific layer.

CMF objects

Any skin-object (e.g. images, templates) on the file system (directory views) can be overridden.

Author

Malthe Borch <mborch@gmail.com>