Tab plugin¶ ↑

A Redmine plugin which adds new Redmine tabs to display content (html, iframe…) or redirect to external URL on a per-project and system-wide base.

Author¶ ↑

• James Turnbull

Latest release¶ ↑

The currently available, latest release of the plugin is version 0.5.0.

Changelog¶ ↑

For the complete changelog see the CHANGELOG file in the Tab plugin directory.

Description¶ ↑

The Tab plugin is a Redmine plugin which provides the ability to create a new Redmine tab, to embed content from an iframe, on a per-project base. This is done by storing the iframe-snippet in a project custom field. It also provides the ability to add a new, system-wide top menu tab. The iframe-source for that tab can be configured in the plugin settings.

Besides these two features it also allows you to modify the actual tab and link names, without changing the source of the plugin, in the plugin settings.

Compatibility¶ ↑

This plugin is compatible with Redmine 0.8.x as well as with the Redmine trunk.

Obtaining ¶ ↑

URL of the GitHub repository: http://github.com/jamtur01/redmine_tab/tree/master

The source of this plugin can be “cloned” from the GitHub-repo using:

$ cd {REDMINE_ROOT}/vendor/plugins && git clone git://github.com/jamtur01/redmine_tab.git

Installation¶ ↑

1. Download the plugin from the available source (see www.redmine.org/wiki/redmine/PluginTab#Obtaining)

2. Install the plugin as described at: www.redmine.org/wiki/redmine/Plugins (this plugin does not require a plugin database migration)

3. Restart Redmine

Setup¶ ↑

Project-specific tabs¶ ↑

This plugin creates a project-menu tab in which you can embed an iframe. You can globally configure the name of the tab in the Plugins -> Tab Plugin configuration options, under “Project Specific -> Tab Name” (default is “Tab Name”). The iframe-sources for the individual projects can be configured on a per-project base using the value of a pre-configured project custom field (configured under “Project Specific -> Tab Text” (default is “none”).

1. You need to go to ‘Admin -> Custom fields -> Project’ and create a field of the type ‘Text’ to hold the tab name.

2. Create another field of the type ‘Long text’ to hold the tab content.

3. Select the project custom fields you’ve created in the plugin configuration, by going to Plugins -> Tab Plugin configuration options, under “Project Specific -> Tab Text & Tab Name”.

4. Inside your project you will need to add your content as the value of the project custom field you’ve selected. For example to embed Google:

   <iframe src="http://www.google.com/" style="border: 0" width="800" height="600" frameborder="0" scrolling="no"></iframe>

   OR

   <h1>Hello World</h1>
   <p>Html Content</p>

   OR

   http://wwww.google.com
   

5. Then use the project’s Modules tab to enable the Tab module for the project; go to the preferred Redmine project -> “Project settings”:

   • On the “Modules” tab: enable the plugin-module by checking “Tab”.

After that, the new project menu item will show up in the project menu.

System-wide tab (link)¶ ↑

The plugin also provides the ability to add a new, system-wide top-menu tab (link). You can globally configure the name of the tab in the Plugins -> Tab Plugin configuration options, under “System wide -> Tab Name” (default is “System Tab Name”). The iframe-source for the new top menu link can be globally configured using the value of the plugin setting “System wide -> Tab Text” (default is “none”).

Upgrading¶ ↑

1. Backup the currently deployed Tab plugin (cp -r /vendor/plugins/redmine_tab /vendor/plugins/redmine_tab-backup)

2. Reinstall the updated plugin:

   • using the command: git pull

3. Restart your Redmine

Uninstalling¶ ↑

1. Remove the directory “redmine_tab” from the plugin-directory “../vendor/plugins”

2. Restart Redmine

Support¶ ↑

If you would like to report a bug or request a new feature you can open a new issue at the issue-tracking section of the plugins’ GitHub site: github.com/jamtur01/redmine_tab/issues. You can also post about the plugin in the dedicated plugin-section of the “Redmine forums” (www.redmine.org/projects/redmine/boards/3).

As an alternative you can also join the #redmine channel on the “freenode” (freenode.net/irc_servers.shtml) IRC network to see if there is anyone who can provide some support.

Credits¶ ↑

• Mischa the Evil for extensive updates and refactoring

• Eric Davis for numerous fixes and new features

Licensing¶ ↑

This plugin is open-source and licensed under the “GNU General Public License v2” (www.gnu.org/licenses/old-licenses/gpl-2.0.html) (GPL). See the included COPYRIGHT.txt and GPL.txt files for details.

• © 2009, James Turnbull (www.james-turnbull.net)