Project

General

Profile

Plugins » History » Version 82

Anton Hedström, 2011-08-19 15:26
Should be db:migrate_plugins instead of db:migrate:plugins?

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 81 Jean-Philippe Lang
1. Copy your plugin directory into @#{RAILS_ROOT}/vendor/plugins@. If you are downloading the plugin directly from GitHub, you can do so by changing into your plugin directory and issuing a command like @git clone git://github.com/user_name/name_of_the_plugin.git@.
8 1 Jean-Philippe Lang
9 81 Jean-Philippe Lang
2. If the plugin requires a migration, run the following command to upgrade your database (make a db backup before):
10 1 Jean-Philippe Lang
11 82 Anton Hedström
  rake db:migrate_plugins RAILS_ENV=production
12 1 Jean-Philippe Lang
13 81 Jean-Philippe Lang
3. Restart Redmine
14 1 Jean-Philippe Lang
15 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).
16 1 Jean-Philippe Lang
17
h2. Plugin list
18
19 80 Jean-Philippe Lang
A full list of available Redmine plugins can be found at the "Plugin Directory":/plugins.
20 61 Mischa The Evil
21 80 Jean-Philippe Lang
More plugins (some in very early development), which are not listed at the "Plugin Directory":/plugins 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.
22 38 Mischa The Evil
23 16 Jean-Philippe Lang
h2. Writing plugins
24 1 Jean-Philippe Lang
25 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.
26 77 Felix Schäfer
More (general) developer information can be found in the [[Guide#Developer-guide|Redmine Developer Guide]].