[[PageOutline(2-5,Contents,pullout)]]

= Delete users and their tickets and comments

== Description

This plugin adds a TracAdmin command for cleaning out spammer accounts and all their tickets and comments. It requires SpamFilterPlugin.

It does not do anything about wiki content or attachments. It does not provide a web user interface. Forks and patches welcome.

To use it:
{{{#!sh
$ trac-admin /path/to/trac/environment/  nukeuser username
}}}

If you use it interactively, it does tab-completion of usernames from the auth cookie table in the database.

This will do all of the following:

 * Remove the user account.
 * Delete all tickets and comments created by that user.
 * Train and delete SpamFilterPlugin entries by that user.

Motivation: I've been getting some (authenticated) Trac spam lately, some of it getting past SpamFilterPlugin's filters (I'm using all of Akismet, !BlogSpam, and reCaptcha, and they still got through). I was getting tired of doing cleanup manually.

'''Update:''' On request Paul Winkler declared on 18-Sep-2012, that he doesn't use Trac since quite some time and will not work on the code anymore. But at the same time he expressively allowed forking and even give "ownership" (I read: plugin development and maintenance) away. --hasienda

== Bugs/Feature Requests

Existing bugs and feature requests for NukeUserPlugin are 
[https://github.com/slinkp/TracNukeUserPlugin/issues here].

If you have any issues, create a 
[https://github.com/slinkp/TracNukeUserPlugin/issues new ticket].

== Download

Download the zipped source from [https://github.com/slinkp/TracNukeUserPlugin/tarball/master GitHub]. There is also a version on [pypi:TracNukeUserPlugin PyPi].

== Source

You can check out NukeUserPlugin from [git://github.com/slinkp/TracNukeUserPlugin.git here] using Git, or [https://github.com/slinkp/TracNukeUserPlugin  browse the source].

== Configuration

To configure it, first you need SpamFilterPlugin installed. Then put this in your `trac.ini` file:
{{{#!ini
[components]
nukeuserplugin.* = enabled
}}}

== Recent Changes

[[ChangeLog(nukeuserplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:slinkp] [[BR]]
'''Maintainer:''' ''none'' [[BR]]
'''Contributors:'''