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

= Configuring project data and setting project configuration options

== Description

This plugin provides an extension for `trac-admin` for easy removal of unneeded milestones, components, etc., and setting configuration options from a file.

Extends command `trac-admin` with some more commands:

 * `component removeall <pattern>`: Remove all components with a specific pattern.
 * `permission removeall <user_pattern>`: Remove all permissions with a specific pattern for users.
 * `milestone removeall <pattern>`: Remove all milestones with a specific pattern.
 * `version removeall <pattern>`: Remove all versions with a specific pattern.
 * `ticket_type removeall <pattern>;`: Remove all ticket_types with a specific pattern.
 * `priority removeall <pattern>;`: Remove all priorities with a specific pattern.
 * `config setall <path/to/file>`: Set all config options from file to `trac.ini`.
 * `plugin replace <plugin_name>`: Replaces plugin(s) with plugin name (without version).
 * `plugin replaceall`: Replaces all plugins (dangerous!).
 * `attachment unused`: Removes unused attachments (dangerous!); options: [list | remove].
  - option `list` only lists unused attachments.
  - option `remove` backups attachments into `$PROJECT_ENV/backup_unused_attachments.zip` and removes unused attachments; this could be useful when upgrading Trac from revision before `11036` to Trac revision after that.
 
Patterns can have wildcards (%).

Example usage of commands:
{{{
# removes all components starting with component
trac-admin </path/to/projenv> component removeall component%

# removes ALL (!) versions
trac-admin </path/to/projenv> version removeall %

# overrides and creates all config entries from `company.ini`
trac-admin </path/to/projenv> config setall company.ini

# replaces plugin TracAccountManager
trac-admin </path/to/projenv> plugin replace TracAccountManager

# removes all plugins (and made a backup) 
# then copies all plugins of the current directory into plugins-directory  
trac-admin </path/to/projenv> plugin replaceall
}}}

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

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

== Recent Changes

[[ChangeLog(settingsplugin, 3)]]

== Author/Contributors

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