Drop-in template overrides.
Project description
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.
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.
Changes
0.5.3 (2009-10-31)
ZCML-directive is now called jbot. [malthe]
0.5.2 (2009-10-23)
Fixed issue where an exception would be raised if a view was not an acquirer, while the context was. [gweis]
0.5.1 (2009-10-19)
Acquisition-wrap template instance, if applicable. This fixes an issue on Zope 2.10 where legacy code would break.
0.5 (2009-10-16)
Added support for CMF skin objects.
0.4 (2009-10-15)
Added Chameleon-support.
Reimplemented override logic; the total usage cost is now reduced to an insignificant amount. Meanwhile, only templates that are defined as class-attributes (e.g. on views, viewlets and portlets) can be overriden.
0.3 (2009-09-26)
Improved test coverage.
Refactored code, improving performance.
Fixed issue with multiple layers.
0.2 (2008-07-14)
Added layer support.
0.1 (2007-11-27)
Initial public release.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
