ftw.trash 1.1.1

Installation and usage

• Be aware that ftw.trash requires and installs collective.deletepermission.

• Add ftw.trash to the eggs in your buildout configuration:

  [instance]
  eggs +=
      ...
      ftw.trash

• Install the ftw.trash addon in Plone (Addons control panel or portal_setup or quickinstaller).

• Deleting content looks exactly as in standard Plone, but it does not actually delete the content but only hide it.

• Administrators can restore content with a global trash view, accessible via the user menu.

• Personal trashes are not implemented at the moment.

Manipulate condition for restoring

By default, restoring a page can be compared to adding a new page to its container. Therefore we require the Add portal content permission on the parent. This may depend on the application and the content type though: there are content types which can be seen as part of the content of their parents, in which case we’d like to require the Modify portal content permission for restoring instead. Therefore this behavior can be manipulated by simply registering an adapter for the restored content for which we want to change the behavior.

Example:

Internals

• When content is deleted, it is marked as ITrashed and IRestorable, children are only marked as ITrashed.

• Only the root node of the deleted structure can be restored and thus provides IRestorable. Restoring children without their deleted parents cannot work since the parent is missing.

• Trashed content is not moved.

• The catalog’s searchResults method is patched so that it filters trashed objects by default.

• Trashed content is prevented from beeing published / accessible through the browser unless the user has the Manager role.

• For restoring content, the permissions Restore trashed content and Add portal content are required. The Restore trashed content is granted by default to the roles Manager and Site Administrator on the site root.

Development

1. Fork this repo

2. Clone your fork

3. Shell: ln -s development.cfg buildout.cfg

4. Shell: python bootstrap.py

5. Shell: bin/buildout

Run bin/test to test your changes.

Or start an instance by running bin/instance fg.

Links

• Github: https://github.com/4teamwork/ftw.trash

• Issues: https://github.com/4teamwork/ftw.trash/issues

• Pypi: http://pypi.python.org/pypi/ftw.trash

Copyright

This package is copyright by 4teamwork.

ftw.trash is licensed under GNU General Public License, version 2.

Changelog