TrashPlugin

Maintain the Trash web

This plugin lets you empty the trash bin on a regular base or immediately on request. By default deleting a topic, an attachment or a web, items are moved to the Trash. It will stay there for recovery until the trash is emptied. Cleaning up the trash bin will wipe out items and their history from the store permanently, that is the operation can't be reverted anymore, even not by checking out a previous revision.

For this reason cleaning up the trash can only be performed by an admin user under the assumption they know better what they are doing.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

TrashPlugin is able to clean up items from the trash older than a specific timespan specified in {TrashPlugin}{Expire} defaulting to 1M (one month). To perform regular maintenance automatically add a cron job calling the cleanUp REST handler of TrashPlugin.

0 0 * * * cd <foswiki-dir>/bin && ./rest /TrashPlugin/cleanUp

To clean up the trash of all virtual hosts installed via VirtualHostingContrib use

0 0 * * * cd <foswiki-dir>/tools && ./virtualhosts-rest /TrashPlugin/cleanUp

Optionally add an "Empty Trash" button to Trash.WebHome.

%BUTTON{"%MAKETEXT{"Empty Trash"}%" 
  icon="bin" 
  href="%SCRIPTURLPATH{"rest"}%/TrashPlugin/cleanUp?redirectto=%WEB%.%TOPIC%&expire=0"
}%

Dependencies

None

Change History

14 Jun 2016:	added parameter to configure which topics should be exempted from trashing; adding WebLeftBar by default now
29 Aug 2014:	fully specify rest security
04 Apr 2014:	flag rest handlers that don't require authentication
05 Sep 2013:	fixed tainted issue
06 Aug 2013:	initial release