Project

General

Profile

PluginTab » History » Version 3

Robert Schneider, 2014-05-26 17:48
Updated since the plugin still can be used with current Redmine versions

1 1 Mischa The Evil
h1. Tab plugin
2
3
{{>toc}}
4
5
A Redmine plugin which adds new Redmine tabs to embed content from an iframe on a per-project and system-wide base.
6
7
h2. Author
8
9
* James Turnbull
10
11
h2. Latest release
12
13 3 Robert Schneider
The currently available, latest release of the plugin is version *0.4.0*. Does also work with Redmine version 2.5.
14 1 Mischa The Evil
15
h2. Changelog
16
17
For the complete changelog see the @CHANGELOG@-file in the Tab plugin directory.
18
19
h2. Description
20
21
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.
22
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.
23
24
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.
25
26
h2. Compatibility
27
28 2 Mischa The Evil
This plugin is compatible with both Redmine 0.8.x and Redmine trunk.
29 1 Mischa The Evil
30
h2. Obtaining 
31
32
bq. URL of the GitHub repository: http://github.com/jamtur01/redmine_tab/tree/master
33
34
The source of this plugin can be "cloned" from the GitHub-repo using:<pre>
35 3 Robert Schneider
$ cd {RAILS_ROOT}/plugins
36 1 Mischa The Evil
$ git clone git://github.com/jamtur01/redmine_tab.git
37
</pre>
38
39
h2. Installation
40
41
# Download the plugin from the available source (see "[[PluginTab#Obtaining|obtaining]]")
42
# Install the plugin as described at: http://www.redmine.org/wiki/redmine/Plugins (this plugin does not require a plugin database migration)
43
# Restart Redmine
44
45
h2. Setup
46
47
h3. Project-specific tabs
48
49
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").
50
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").
51
52
# You need to go to 'Admin -> Custom fields -> Project' and create a field of the type 'Long text' to hold the iframe link.
53
# Select the project custom field you've created in the plugin configuration, by going to Plugins -> Tab Plugin configuration options, under "Project Specific -> Tab Text".
54
# Inside your project you will need to add your iframe-link as the value of the project custom field you've selected. For example to embed Google: <pre><iframe src="http://www.google.com/" style="border: 0" width="800" height="600" frameborder="0" scrolling="no"></iframe></pre>
55
# Then use the project's Modules tab to enable the Tab module for the project; go to the preferred Redmine project -> "Project settings":
56
** On the "Modules" tab: enable the plugin-module by checking "Tab".
57
58
After that, the new project menu item will show up in the project menu.
59
60
h3. System-wide tab (link)
61
62
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").
63
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").
64
65
h2. Upgrading
66
67 3 Robert Schneider
# Backup the currently deployed Tab plugin (@cp -r /plugins/redmine_tab /plugins/redmine_tab-backup@)
68
69 1 Mischa The Evil
# Reinstall the updated plugin:
70
** using the command: @git pull@
71
# Restart your Redmine
72
73
h2. Uninstalling
74
75 3 Robert Schneider
# Remove the directory _"redmine_tab"_ from the plugin-directory _"../plugins"_
76 1 Mischa The Evil
# Restart Redmine
77
78
h2. Support
79
80
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: http://github.com/jamtur01/redmine_tab/issues.
81
You can also post about the plugin in the dedicated plugin-section of the "Redmine forums":http://www.redmine.org/projects/redmine/boards/3.
82
83
As an alternative you can also join the @#redmine@ channel on the "freenode":http://freenode.net/irc_servers.shtml IRC network to see if there is anyone who can provide some support.
84
85 2 Mischa The Evil
h2. Credits
86
87
* Mischa the Evil for extensive updates and refactoring
88
* Eric Davis for numerous fixes and new features
89
90 1 Mischa The Evil
h2. Licensing
91
92
This plugin is open-source and licensed under the "GNU General Public License v2":http://www.gnu.org/licenses/old-licenses/gpl-2.0.html (GPL). See the included @COPYRIGHT.txt@ and @GPL.txt@ files for details.
93
94
* ©2009, James Turnbull (http://www.james-turnbull.net)