z3c.jbot Drop-in template overrides. 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 [#]_. Use of this package adds a small (2-3 ms per request on Plone) to the total application response time. .. [#] 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> 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. Malthe Borch 38d1fa3709e4435d5acabdd3c1d26b529ec24227 0.5.3