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

= Add administrator privileges to a given user

== Description

This plugin automatically gives a given username `TRAC_ADMIN` permissions. This is useful for a multiproject setup with AccountManagerPlugin, where users and passwords are shared between all projects, and there should be an '''admin''' user with full permissions without manually setting it on every project.

The plugin works by wrapping the current PermissionStore, in order to fake the superuser permissions. Permissions are not added to the database, but added ''on the fly'' when requested.

== Bugs/Feature Requests

Existing bugs and feature requests for SuperUserPlugin are 
[report:9?COMPONENT=SuperUserPlugin here].

If you have any issues, create a 
[/newticket?component=SuperUserPlugin new ticket].

[[TicketQuery(component=SuperUserPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:superuserplugin here].

== Source

You can check out SuperUserPlugin from [/svn/superuserplugin here] using Subversion, or [source:superuserplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Configuration

To enable the plugin, add the following line to your `trac.ini` file:

{{{#!ini
[components]
tracsuperuser.* = enabled
}}}

Then, replace the current PermissionStore. In this example ''DefaultPermissionStore'' was used before installing the superuser plugin:

{{{#!ini
[trac]
...
permission_store = SuperUserPlugin
...

[superuser]
superuser = admin
wrapped_permission_store = DefaultPermissionStore
...
}}}

Where:
 * '''permission_store''': Use SuperUserPlugin as the new permission store.
 * '''supersuser''': The name of the user with admin permissions.
 * '''wrapped_permission_store''': The permission store being used previously. If the user is not the superuser, this permission store will be used to retrieve the user permissions.

== Recent Changes

[[ChangeLog(superuserplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:airadier] [[BR]]
'''Maintainer''': [[Maintainer]] [[BR]]
'''Contributors:'''