Skip to main content

Drop-in template overrides.

Project description

Overview

The z3c.jbot (or “Just a bunch of templates”) package allows drop-in page template overrides.

It works by giving page templates a canonical filename which you can use to provide a replacement in your own package. Simply register a template overrides directory and give your new template the canonical filename.

Overrides may be registered for a specific layer or any layer.

Canonical filename

The canonical filename is defined as the path relative to the package within which the template is located with directory separators 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

Registering a on overrides directory

A Zope component configuration directive is available to configure overrides:

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

<browser:templateOverrides
    directory="<directory>"
    layer="<layer>" />

Performance considerations

The use of jbot adds to the general page load time. On a site with many templates this may be as much as 10 ms per request.

Author

Malthe Borch <mborch@gmail.com>

Changes

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.

Source Distribution

z3c.jbot-0.3.tar.gz (10.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page