Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Plone UI integration for plone.tiles
Python Other
Failed to load latest commit information.
plone
.coveragerc
.gitignore
.travis.yml
CHANGES.rst Back to development: 2.1.1
CONTRIBUTORS.rst
LICENSE.GPL
LICENSE.txt
MANIFEST.in
Makefile added development buildout
README.rst
bootstrap.py
buildout.cfg
buildout.cfg.in added development buildout
dev.nix added development buildout
develop.cfg Update .travis.yml
rebuild_i18n.sh updated package i18n: Spanish and Brazilian Portuguese translations w…
setup.py Back to development: 2.1.1
test-4.2.x.cfg Update Travis-CI configuration
test-4.3.x.cfg
test-5.x.cfg
versions.cfg added development buildout

README.rst

Plone's Specific Implementation of Tiles

plone.app.tiles is Plone's UI integration for plone.tiles.

Travis CI badge Coveralls badge Downloads

This package contains the following things:

  • A view @@add-tile, and an associated form, which can be used to create a new tile based on the tile's schema. For transient tiles, this merely redirects to a URL with an appropriate query string. For persistent tiles, it will also save the necessary data. This will fire an IObjectCreatedEvent as well as an IObjectAddedEvent for the newly created tile (a transient object) when successfully submitted. In the case of the IObjectAddedEvent, the newParent attribute will be the tile's context, and the newName attribute will be the tile's id.
  • The @@add-tile view, when accessed directly, allows the user to choose from all available tiles (subject to the tile's add permission) and redirects to the appropriate @@add-tile/<tile-type> URL to configure the tile.
  • A view @@edit-tile, and an associated form, which can be used to edit a tile based on the tile's schema. This will fire an IObjectModifiedEvent for the modified tile (a transient object) when successfully submitted.
  • A view @@delete-tile, where the user may select a tile type, enter a tile id, and opt to clear out any persistent data for that tile. This can also be called by AJAX code given appropriate request parameters. This will fire an IObjectRemovedEvent for the removed tile (a transient object). The oldParent attribute will be the tile's context, and the oldName attribute will be the tile's id.

The default add and edit forms should suffice for most use cases. You can use plone.autoform to configure alternative widgets, either by hand or via plone.directives.form.

If you need a custom form, you can register an add view as an adapter from (context, request, tileType), where tileType is an instance providing plone.tiles.interfaces.ITileType.

The actual integration of the various views is left up to other packages (such as the Deco editor).

Something went wrong with that request. Please try again.