====== History Cleanup Plugin ======

---- plugin ----
description: Removes subsequent edits by the same user from old revisions and history entries
author     : Dominik Eckelmann
email      : dokuwiki@cosmocode.de
type       : action, admin
lastupdate : 2010-01-23
compatible : 2008-05-05+, rincewind, angua
depends    : 
conflicts  : 
similar    : 
tags       : revisions, maintenance, spam, users


downloadurl: http://github.com/cosmocode/clearhistory/zipball/master
sourcerepo : http://github.com/cosmocode/clearhistory/
bugtracker : http://github.com/cosmocode/clearhistory/issues
----

===== Download and Installation =====
[[http://www.cosmocode.de/en/wiki/dokuwiki/plugins|{{ http://www.cosmocode.de/_media/en/wiki/dokuwiki/cosmologo.png?recache|A CosmoCode Plugin}}]]

Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the following URL. Refer to [[:Plugins]] on how to install plugins manually.

  * [[http://github.com/cosmocode/clearhistory/zipball/master]]

==== Changes ====

{{rss>http://github.com/feeds/cosmocode/commits/clearhistory/master date}}

===== Usage =====

Access the Admin menu and choose the History Cleanup plugin.

==== Cleanup on last changes ====

The plugin checks all [[:page|pages]] from the [[:recent changes]] page.

==== Configuration ====

In [[:config|configuration manager]], you can also setup the plugin to run automatically once a day.

==== Cleanup on namespace ====

The plugin checks all [[:page|pages]] from a [[:namespaces|namespace]] and it's sub-[[:namespaces]]. If no [[:namespace]] is given it checks all [[:page|pages]]. 

===== Page cleanup process =====

  * The plugin checks for all old versions of a [[:page]].
  * it checks from old to new version.
  * it check always two versions that are back-to-back each other.
  * if the authors are the same and the time span between the versions is lesser then 1 hour the old version will be deleted.

==== Example ====

Here a small example on the [[:DokuWiki]] welcome page history:\\

History before:
  2008/08/16 19:24 DokuWiki – (external edit) (current)
  2008/08/10 15:34 DokuWiki – re-added doku> interwikilink again, because this page gets included in the install tarball andi
  2008/08/10 13:57 DokuWiki – 87.206.233.64
  2008/08/10 13:57 DokuWiki – 87.206.233.64
  2008/08/10 07:10 DokuWiki – 93.135.108.77
  2008/08/10 07:10 DokuWiki – 93.135.108.77
  2008/08/09 13:57 DokuWiki – fixed links, page seems clean 82.224.163.148

History after:
  2008/08/16 19:24 DokuWiki – (external edit) (current)
  2008/08/10 15:34 DokuWiki – re-added doku> interwikilink again, because this page gets included in the install tarball andi
  2008/08/10 13:57 DokuWiki – 87.206.233.64
  2008/08/10 07:10 DokuWiki – 93.135.108.77
  2008/08/09 13:57 DokuWiki – fixed links, page seems clean 82.224.163.148

===== TODO =====

  * Add a function to automatic delete old history data that is older then a specefic value in days (like [[tips:maintenance#automatic_cleanup_script]])
  * Add a function to automatic cleanup the playground (like [[tips:maintenance#keeping_playground_clean]])