Redmine

h1. Plugins

Redmine plugins rely on "Rails engines":http://rails-engines.org/ to add functionalities to the application.

h2. Installing a plugin

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.

<pre>

ruby script/plugin install http://svn.rails-engines.org/engines/tags/rel_2.0.0/

mv vendor/plugins/rel_2.0.0 vendor/plugins/engines

</pre>

2. Then, copy your plugin directory into @#{RAILS_ROOT}/vendor/plugins@.

3. If the plugin requires a migration, run the following command to upgrade your database (make a db backup before):

  rake db:migrate_plugins RAILS_ENV=production

4. Restart Redmine

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).

h2. Plugin list

The list below contains the plugins from authors who requested to add them here or who are having the contributer-role on the Redmine-project themself.

* [[BotsFilterPlugin]] prevents common bots from crawling various urls.

* "Blog Plugin":http://www.redmine.org/boards/3/topics/5782 is a plugin for having a blog within Redmine.

* "BugCloud":http://github.com/maedana/redmine_bugcloud/tree/master is a plugin that visualizes the tickets as a bug cloud.

* [[PluginBudget|Budget]] is a plugin to manage the set of deliverables for each project, automatically calculating key performance indicators.

* [[PluginBulkTimeEntry|Bulk Time Entry]] is a plugin to enter multiple time entries at one time.

* "Chat":http://github.com/jbrien/redmine-chat-plugin/tree/master is a plugin to chat within Redmine. Early state!

* "Code Book":http://github.com/sroegner/redmine_codebook/tree/master is a plugin that provides code snippet management.

* "Code Review Plugin":http://www.redmine.org/boards/3/topics/5878 is a plugin for Redmine which lets you annotate source code within the repository browser.

* "Charts Plugin":http://github.com/mszczytowski/redmine_charts/tree/master is a plugin for Redmine which integrates some nice project charts like a burndown chart.

* [[PluginCollapse|Collapse]] is a plugin which transforms the default Redmine sidebar into a collapsible sidebar.

* [[PluginCustomer|Customer]] is a plugin to track basic customer information and to see which project belonged to a customer.

* "Diff Email":http://github.com/Lamar/redmine_diff_email/tree/master is a plugin which sends diff mails of the code changes of last changeset to other users.

* [[PluginEmbedded|Embedded]] lets you embed HTML files (eg. auto generated documentation, test reports) in your projects.

* [[PluginExceptionHandler|Exception Handler]] will allow Redmine to send emails when an exception or error occurs.

* [[PluginEzfaq|ezFAQ]] is a FAQ management plugin for Redmine.

* [[PluginEzlibrarian|ezLibrarian]] is a book shelf management plugin designed for use in company or department.

* [[PluginEzSummary|ezSummary]] will send an issue status summary mail to the specified email-address.

* [[PluginGoogleAnalytics|Google Analytics]] is a simple plugin to include a Google Analytics tracking code within Redmine.

* [[PluginGoogleCalendar|Google Calendar]] is a simple plugin to include Google Calendar iframe as a tab within Redmine projects.

* [[PluginGraphs|Graphs]] is a simple plugin provides additional graphs for the system.

* "Hudson Plugin":http://www.redmine.org/boards/3/topics/6650 is a plugin which integrates hudson jobs into redmine.

* "IssuesGroup":http://www.redmine.org/boards/3/topics/4701 is a plugin implementation of issues grouping and query categorization.

* "LocalAvatars":http://www.redmine.org/boards/3/topics/5365 is a plugin implementation of local user avatars.

* "Messenger":http://github.com/mszczytowski/redmine_messenger/tree/master is a plugin to interact with Redmine via instant messenger.

* "My Widgets":http://github.com/bradbeattie/redmine-my-widgets-plugin/tree/master is a plugin that provides additional blocks for "the my page portal":/my/page.

* [[PluginProjectScores|Project Scores]] is a plugin which will let a user score a project on different criteria.

* "RD formatter":http://github.com/yugui/redmine_rd_formatter/tree/master adds Ruby Doc text formatting capability to Redmine (requires Redmine r1955 or above)

* [[PluginQuestion|Question]] is a plugin which will allow users to ask questions to each other in issue notes

* [[PluginRate|Rate]] is a plugin which will store billable rates for users.

* "Resources Plugin":http://github.com/dvandersluis/redmine_resources/tree/master is a plugin which allows links to resources to be added to an issue. For the purposes of this plugin, a resource is any external site that is useful for the understanding or completion of an issue.

* "Require Note":http://github.com/ajwalters/redmine_require_closing_note/tree/master is a plugin for allow users closing a ticket only by entering a comment.

* "Redmine Tab":http://github.com/jamtur01/redmine_tab/tree/master is a plugin to create a new Redmine tab to embed content from an iframe on a per-project base.

* [[PluginSchedules|Schedules]] is a plugin which will schedule users to assigned projects over time

* [[PluginSimpleCI|Simple CI]] is a generic plugin for integrating per project RSS continuous integration feeds (eg. "Cruise Control":http://cruisecontrol.sourceforge.net/) in Redmine.

* "Status Updates":http://www.redmine.org/boards/1/topics/1483 is a plugin that allows users to create small status updates about what they’re currently working on. You can think of it as Twitter on a per-project basis, within Redmine. source is available "here":http://github.com/bterlson/redmine-status-updates/tree/master

* [[PluginStuffToDo|Stuff To Do]] allows a user to order and prioritize the issues they are doing into a specific order. It will also allow other privileged users to reorder the user's workload.

* [[PluginSystemNotification|System Notification]] is a plugin that will allow an Administrator to send notification emails to recently logged in users.

* [[PluginTimesheet|Timesheet]] is a plugin to show and filter timelogs across all projects in Redmine.

* "Vote":http://www.redmine.org/boards/3/topics/5506 is a plugin for issues voting.

More plugins (some in very early development), which are not listed above 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.

h2. Writing plugins

See the [[Plugin_Tutorial|plugin tutorial]] and the information provided in the [[Plugin_Internals|plugin internals]] page.