[[PageOutline(2-5,Contents,pullout)]]
= Create new projects without using the TracAdmin command line tool =

== Description ==

This extension is designed to work with Trac 0.10.3 in a [trac:TracMultipleProjects/MultipleEnvironments] configuration.

It adds a ''Create New Project'' page to the Admin menu, providing an alternative to the TracAdmin command-line tool.  It also improves on TracAdmin by allowing default settings for the new projects, and by automatically adding the new projects' InterTrac settings to the global TracIni file.

'''This plugin does work, but it is not quite finished yet.  Please see the current [report:9?COMPONENT=CreateProjectPlugin active tickets] for details.'''

== Bugs/Feature Requests == 

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=CreateProjectPlugin&owner=linetor new ticket].

== Download ==

Download the zipped source from [download:createprojectplugin.zip here].

== Source ==

You can check out CreateProjectPlugin from [http://trac-hacks.org/svn/createprojectplugin here] using Subversion, or [source:createprojectplugin browse the source] with Trac.

== Example ==

First ensure that the WebAdminPlugin is installed and enabled.

Then [trac:TracPlugins#InstallingaTracPlugin install] the CreateProjectPlugin and [trac:TracPlugins#Enablingtheplugin enable] the components if necessary:

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

This will make a new permission (called PROJECT_CREATE) available to your projects.  For one of your project environments, you must give a user this permission, as shown below.  Note that ''myenv'' should be replaced with the directory path of your project environment, and ''myuser'' should be a user's login name.

{{{
#!sh
trac-admin myenv permission add myuser PROJECT_CREATE
}}}

This user will now be able to visit the "Create New Project" page on the Admin menu.  They can fill in the form and create new project environments.

=== Configuring project defaults ===

To customise the default settings for a new project's TracIni file, you can create a {{{defaults.ini}}} file with corresponding settings.  You must connect this file to the CreateProjectPlugin by adding the following option to your existing project's TracIni file:

{{{
#!ini
[customsetup]
project_defaults_ini = /path/to/defaults.ini
}}}

== Recent Changes ==

[[ChangeLog(createprojectplugin, 3)]]

== Author/Contributors ==

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