Register tiles

A tile is registered similar to a pyramid view. Registration is done with the the cone.tile.tile decorator on classes.

from cone.tile import tile
from cone.tile import Tile

@tile(
    name='b_tile',
    path='package:browser/templates/b_tile.pt',
    permission='view',
    strict=False)
class BTile(Tile):
    pass

There also exists a cone.tile.register_tile function. It should not be used directly any more. tile decorator attaches this function to venusian for deferred tile registration.

from cone.tile import register_tile

register_tile(
    name='a_tile',
    path='package:browser/templates/a_tile.pt',
    permission='view')

tile decorator accepts the following arguments:

name

Identifier of the tile (for later lookup).

path

Either relative path to the template or absolute path or path prefixed by the absolute package name delimeted by ‘:’. If path is used attribute is ignored.

attribute

Attribute on the given _class to be used to render the tile. Defaults to render.

interface

Interface or class of the pyramid model the tile is registered for.

class_

Class to be used to render the tile. usally cone.tile.Tile or a subclass of. Promises to implement cone.tile.ITile. When the tile decorator is used, the decorated class is expected as tile implementation.

permission

Enables security checking for this tile. Defaults to view. If set to None security checks are disabled.

strict

Wether to raise Forbidden or not if rendering is not permitted. Defaults to True. If set to False the exception is consumed and an empty unicode string is returned.

Tiles can be overwritten later while application initialization by just registering it again. This is useful for application theming and customization.

Rendering tiles

Tile rendering with the render_tile function

from cone.tile import render_tile
rendered = render_tile(model, request, name)

Inside templates which are bound to the tile, more tiles can be rendered on current model and request via tile

<tal:sometile replace="structure tile('tilename')" />

The Tile

A tile is similar to what’s known in the zope world as content provider.

Before rendering of the tile is done, the prepare function is called which can be used to load data or whatever.

Further, the show flag is considered (which might have been set in the prepare function) and rendering is skipped if it evaluates to False.

More on rendering

There are helper functions for rendering which pass the tile renderer to templates for invoking child tiles and consider redirections.

The tile class provides a redirect function, which expects either a string containing a URL or a webob.exc.HTTPFound instance. This causes rendering of remaining tiles to be skipped and request.environ['redirect'] to be set.

cone.tile.render_template

Render template. Passes tile renderer to template. Considers redirection. Returns empty string if redirection found.

cone.tile.render_template_to_response

Render template to response. Passes tile renderer to template. Considers redirection. Returns HTTPFound instance if redirection found, otherwise rendered response.

cone.tile.render_to_response

Renders some result to the response considering redirection. Returns HTTPFound instance if redirection found, otherwise rendered response.

2.1.0 (2026-10-31)

• Check tile permissions with request.has_permission when rendering instead of looking up the authentication and authorization policies when registering. Tiles are protected with a Pyramid security policy now, and regardless of whether a policy was configured before the tile was registered. [rnix]

• Sort the imports with ruff (one per line, from imports first, no sections) and format the code with ruff format (90 characters per line, single quotes). [rnix]

• Add import sorting (I rules) and the formatter settings to the ruff configuration in pyproject.toml. [rnix]

2.0.1 (2026-10-24)

• Render a copy of the registered tile on every call. One tile object is registered per name, and Tile.__call__ sets model and request on it: two threads rendering the same tile at once shared that object, and a template could read the model and request of the other request. register_tile now registers a wrapper that renders a shallow copy. [rnix]

• Drop the Python 2 remnants: IS_PY2 in cone.tile._api and the urllib/cgi import fallbacks. [rnix]

• Modernise the code ruff flags as outdated: u'' prefixes, class X(object), .format() over f-strings. Behaviour unchanged. super(Class, self) is kept, see cone.app. [rnix]

• Add qa.ruff domain to Makefile and pin the ruff rule selection in pyproject.toml, make check runs ruff check. [rnix]

2.0.0 (2026-02-03)

• Refactor package layout to use pyproject.toml and implicit namespace packages. [rnix]

• Setup Makefile. [lenadax]

• Run tests with pytest. [lenadax]

1.2 (2025-10-25)

• Pin upper versions of dependencies. [rnix]

• Setup Makefile. [lenadax]

• Run tests with pytest. [lenadax]

1.1 (2022-12-05)

• Release wheel. [rnix]

1.0 (2019-11-07)

• Drop pyramid support < 1.5. [rnix, 2019-03-24]

• Python 3 compatibility. [rnix, 2019-03-24]

• Do not use cgi module if replacement module html available. [rnix, 2019-03-24]

• Convert doctests to unittests. [rnix, 2019-03-21]

• tile decorator uses venusian to defer tile registration now. [rnix, 2015-11-06]

• Accept name as keyword instead of positional argument in register_tile and tile decorator. [rnix, 2015-11-06]

• registerTile has been renamed to register_tile. [rnix, 2015-11-06]

• Update to pyramid 1.5 [rnix, 2015-11-02]

• Remove useless test case due to this change. https://github.com/Pylons/pyramid/commit/4b552e539a1725356b9982261b73fd88de7d59a1#diff-bcda6948340ab38542fe18fd2365ac70R144 [rnix, 2015-11-02]

0.9.6

• Use traceback module instead of zope.exceptions to format exceptions in render_template. [rnix, 2017-10-06]

0.9.5

• Remove log_exception utility and use registered IDebugLogger in cone.tile._api.render_template for exception logging. [rnix, 2017-03-24]

0.9.4

• Tile registration name is taken from Tile subclass if not given in registerTile function and tile decorator. [rnix, 2017-02-17]

• name is now optional in registerTile function and tile decorator. [rnix, 2017-02-17]

• Default attribute is now None in registerTile function and tile decorator to ensure considering attribute from Tile subclass if set. [rnix, 2017-02-17]

• Tile.name, Tile.path and Tile.attribute can be set on Tile subclass directly without being overwritten at tile registration if not given. [rnix, 2017-02-17]

0.9.3

• Errors caught in render_tile may contain umlaute. Properly decode error string. [rnix, 2017-02-13]

0.9.2

• Using and depending now on zope.exceptions to format tracebacks with supplements. [jensens, 2012-06-06]

• Improved visibility of tracebacks, they appear now in the error log. even if an expression like `tal:replace="structure tile('editform')"` ate it, the traceback is logged. traceback supplements are rendered. [jensens, 2012-06-05]

• Removed superfluos try except [jensens, 2012-06-05]

• Fixed dependencies for integrated tests [jensens, 2012-06-05]

0.9.1

• Tiles can be overwritten. [rnix, 2012-05-22]

• Use zope.interface.implementer instead of zope.interface.implements. [rnix, 2012-05-18]

0.9

• Fit for pyramid 1.1 + 1.2 [rnix, 2011-09-08]

• Documentation [rnix, 2011-09-08]

• Make it work [jensens, rnix, et. al]