Skip to main content

Drop-in template overrides.

Project description


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 package (CMF-apps like Plone should use which adds full support).


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.


Suppose you want to override: /plone/app/layout/viewlets/

You would use the filename:

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" />

    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.


Malthe Borch <>


0.8 (2018-11-07)

  • Added support for Python 3.5, 3.6, 3.7; dropped support for 2.6. [ale-rt, pbauer]
  • Fix: Be sure ignored templates will reread from disk. [ale-rt]
  • Standardize namespace __init__
  • Fix issue where zope.browserpage.viewpagetemplatefile.ViewPageTemplateFile was not using jbot overrides. [davisagli]

0.7.1 (2012-01-09)

  • Fixed an issue where multiple registrations against the same layer would cause only one registration (decided randomly) to have effect.

    The lookup code now uses the specification resolution order to query for override registrations in order of specialization. [malthe]

0.7 (2012-01-05)

  • Fixed issue where templates being patched by would not get properly jbotted.
  • Use if available. [malthe]
  • Fixed an issue where tests would fail on Zope 2.10. [malthe]

0.6.3 (2010-09-07)

  • Fixed compatibility with Plone 3.x. [malthe]

0.6.2 (2010-02-17)

  • Downgrade log messages to debug level. In normal operation they don’t contain any valuable information. [hannosch]
  • Prefer over if it is available. [hannosch]

0.6.1 (2010-02-09)

  • Fix bungled release [optilude]

0.6.0 (2010-02-09)

  • Zope 2.12 compatibility. [malthe]
  • Added support for automatic configuration. [malthe]
  • Fixed layer specialization ordering. [malthe]

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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for z3c.jbot, version 0.8
Filename, size File type Python version Upload date Hashes
Filename, size z3c.jbot-0.8-py2.py3-none-any.whl (15.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size z3c.jbot-0.8.tar.gz (16.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page