Project

General

Profile

Plugins » History » Version 74

Mischa The Evil, 2009-08-03 14:41
Fixed links referencing [[PluginList]].

1 1 Jean-Philippe Lang
h1. Plugins
2
3 30 Jean-Philippe Lang
Redmine plugins rely on "Rails engines":http://rails-engines.org/ to add functionalities to the application.
4 1 Jean-Philippe Lang
5
h2. Installing a plugin
6
7 30 Jean-Philippe Lang
1. If you're using a 0.7.x release, you need to install the "Rails engines plugin":http://rails-engines.org/ (make sure to get the Rails 2.0.2 version). As of 0.8.0, Rails engines is included in Redmine, so skip this step unless you're using an older Redmine version.
8 1 Jean-Philippe Lang
9 30 Jean-Philippe Lang
<pre>
10
ruby script/plugin install http://svn.rails-engines.org/engines/tags/rel_2.0.0/
11
mv vendor/plugins/rel_2.0.0 vendor/plugins/engines
12
</pre>
13 1 Jean-Philippe Lang
14
2. Then, copy your plugin directory into @#{RAILS_ROOT}/vendor/plugins@.
15
16
3. If the plugin requires a migration, run the following command to upgrade your database (make a db backup before):
17
18 42 Jean-Philippe Lang
  rake db:migrate_plugins RAILS_ENV=production
19 1 Jean-Philippe Lang
20 32 Mischa The Evil
4. Restart Redmine
21 1 Jean-Philippe Lang
22 30 Jean-Philippe Lang
You should now be able to see the plugin list in _Administration -> Plugins_ and configure the newly installed plugin (if the plugin requires to be configured).
23 1 Jean-Philippe Lang
24
h2. Plugin list
25
26 74 Mischa The Evil
A full list of available Redmine plugins can be found at the [[Plugin List|Redmine plugin list]].
27 61 Mischa The Evil
28 70 Mischa The Evil
More plugins (some in very early development), which are not listed at the [[PluginList|Redmine plugin list]] but are publicly available on "GitHub":http://www.github.org can be found using a "search like this":http://github.com/search?type=Repositories&language=&q=redmine&repo=&langOverride=&x=0&y=0&start_value=1.
29 38 Mischa The Evil
30 16 Jean-Philippe Lang
h2. Writing plugins
31 1 Jean-Philippe Lang
32 73 Mischa The Evil
There is a step-by-step [[Plugin_Tutorial|tutorial]] about writing a plugin. Some more (detailed) information is collected and stored in the "[[Plugin_Internals|plugin internals]]" page.
33
More (general) developer information can be found in the [[Guide#Developer-Guide|Redmine Developer Guide]].