PluginCollapse » History » Version 14

Mischa The Evil, 2010-09-25 05:45
Fixed user-profile links.

1 1 Mischa The Evil
h1. Redmine Collapse plugin
2 1 Mischa The Evil
3 10 Mischa The Evil
{{>toc}}
4 1 Mischa The Evil
5 10 Mischa The Evil
Collapse is a plugin for Redmine which transforms the default, static sidebar into a collapsible sidebar on the left side providing some additional tabs containing project- and menu-links.
6 10 Mischa The Evil
7 10 Mischa The Evil
h2. Author
8 10 Mischa The Evil
9 10 Mischa The Evil
* Mischa The Evil
10 10 Mischa The Evil
11 10 Mischa The Evil
h2. History
12 10 Mischa The Evil
13 10 Mischa The Evil
The Redmine Collapse plugin is a Redmine plugin-port of the collapsible-sidebar implementation created by Sebastian Kurfürst for the "Typo3-Forge":http://forge.typo3.org. He has implemented the feature in the following revisions in the Redmine-fork they use:
14 10 Mischa The Evil
* revision 1085: "Adding blindLeft and blindRight":http://forge.typo3.org/repositories/diff/team-forge?rev=1085
15 10 Mischa The Evil
* revision 1086: "Adding left menu collapser to SVN":http://forge.typo3.org/repositories/diff/team-forge?rev=1086
16 10 Mischa The Evil
* revision 1087: "Adding missing image":http://forge.typo3.org/repositories/diff/team-forge?rev=1087
17 10 Mischa The Evil
* revision 1088: "Fixing small JS error":http://forge.typo3.org/repositories/diff/team-forge?rev=1088
18 10 Mischa The Evil
19 10 Mischa The Evil
This implementation depended on core-hacks and some custom Typo3 Redmine plugins. It also didn't do good to the @Default@, @Alternate@ and @Classic@ themes). This made the author decide to implement the feature within a seperate and independed Redmine plugin.
20 10 Mischa The Evil
21 10 Mischa The Evil
h2. Changelog
22 10 Mischa The Evil
23 10 Mischa The Evil
For the complete changelog see the @CHANGELOG@-file in the Redmine Collapse plugin directory.
24 10 Mischa The Evil
25 10 Mischa The Evil
h2. Latest stable release
26 10 Mischa The Evil
27 12 Mischa The Evil
The currently available, latest stable release of the plugin is version *0.2.2*.
28 10 Mischa The Evil
29 1 Mischa The Evil
h2. Features
30 1 Mischa The Evil
31 10 Mischa The Evil
The following features are provided by the plugin:
32 1 Mischa The Evil
* Replaces the Redmine core's sidebar
33 10 Mischa The Evil
** The provided sidebar is made collapsible using JavaScript-helpers
34 10 Mischa The Evil
** The default sidebar-content is made available on the default "Actions"-tab
35 10 Mischa The Evil
* A first, optional tab named "Projects" provides (nested) project-links to projects for which the current user has a role
36 10 Mischa The Evil
** on Redmine 0.8.0 project-links are pointing to project overviews
37 10 Mischa The Evil
** on Redmine 0.8.1 and later project-links are pointing to the currently-watched menu-item in the selected project (if available)
38 1 Mischa The Evil
* Optionally, the core's project-selector drop-down menu can be hidden
39 10 Mischa The Evil
* A second, optional tab named "Menus" provides links to all global (cross-project) views and reports (respecting the current users roles and permissions)
40 10 Mischa The Evil
** optionally, the default project-menu (by default placed horizontally below the header) can be "moved" to the menus tab
41 10 Mischa The Evil
* Used strings can be centrally translated to every language (currently only Czech, Dutch, English, German and Slovak are translated, for others English stubs are provided)
42 10 Mischa The Evil
* 100% compatible with all the core-themes (@Default@, @Alternate@ & @Classic@) and the currently supported and registered community-themes (@Basecamp@ and @Squeejee@)
43 1 Mischa The Evil
44 10 Mischa The Evil
One note should be made: currently the plugin overrides the Redmine base-layout to implement the features as described.
45 10 Mischa The Evil
46 1 Mischa The Evil
h2. Screenshots
47 1 Mischa The Evil
48 12 Mischa The Evil
Note: the following screenshots are taken from version @0.1.0@ of the plugin. They do not reflect the complete feature-set of the latest available release (@0.2.2@) yet.
49 1 Mischa The Evil
50 10 Mischa The Evil
|=. *Global view; Collapsed sidebar*                    |=. *Global view; Un-collapsed sidebar, Projects-tab*  |
51 10 Mischa The Evil
| !global_collapsed.jpg!                                | !global_un-collapsed_projects-tab.jpg!               |
52 10 Mischa The Evil
53 1 Mischa The Evil
|=. *Project view; Un-collapsed sidebar, Projects-tab*  |=. *Project view; Un-collapsed sidebar, Actions-tab*  |
54 1 Mischa The Evil
| !project_un-collapsed_projects-tab.jpg!               | !project_un-collapsed_actions-tab.jpg!               |
55 1 Mischa The Evil
56 10 Mischa The Evil
|=. *Settings view; Project-selector shown*             |=. *Settings view; Project-selector hidden*  |
57 10 Mischa The Evil
| !settings_project-selector-not-hidden.jpg!            | !settings_project-selector-hidden.jpg!      |
58 1 Mischa The Evil
59 1 Mischa The Evil
h2. Compatibility
60 1 Mischa The Evil
61 12 Mischa The Evil
The following compatibility information only applies to versions @0.2.x@ of the Redmine Collapse Plugin.
62 1 Mischa The Evil
63 12 Mischa The Evil
h3. 0.2.x Redmine Compatibility
64 1 Mischa The Evil
65 12 Mischa The Evil
@0.2.x@ releases of the plugin requires at least Redmine 0.8.0 and are compatible with the Redmine trunk and the 0.8-stable branch as visible in the following table:
66 1 Mischa The Evil
67 10 Mischa The Evil
|_. Redmine Branch: |_. Revision/Release: ||_. Tested: |_. Compatible: |_.Comments:                       |_. Supported: |
68 10 Mischa The Evil
|                   |                     ||           |               |                                  |              |
69 10 Mischa The Evil
|<._Trunk_          |@CURRENT@            ||Yes        |Yes            |                                  |Yes           |
70 10 Mischa The Evil
|<._0.8-stable_     |@CURRENT@            ||Yes        |Yes            |                                  |Yes           |
71 10 Mischa The Evil
|<._0.8-stable_     |@0.8.4@              ||Yes        |Yes            |                                  |Yes           |
72 10 Mischa The Evil
|<._0.8-stable_     |@0.8.3@              ||Yes        |Yes            |                                  |Yes           |
73 10 Mischa The Evil
|<._0.8-stable_     |@0.8.2@              ||Yes        |Yes            |                                  |Yes           |
74 10 Mischa The Evil
|<._0.8-stable_     |@0.8.1@              ||Yes        |Yes            |                                  |Yes           |
75 10 Mischa The Evil
|<._0.8-stable_     |@0.8.0@              ||Yes        |Yes            |                                  |Yes           |
76 10 Mischa The Evil
|<._0.7-stable_     |@0.7.x@              ||No         |No             |                                  |No            |
77 10 Mischa The Evil
78 12 Mischa The Evil
h3. 0.2.x Browser Compatibility
79 10 Mischa The Evil
80 12 Mischa The Evil
@0.2.x@ releases of the plugin are (for about 99%) compatible with the major browser-engines. Though some tiny differences may occur between different browsers. Some known issues are listed in the following table:
81 10 Mischa The Evil
82 10 Mischa The Evil
|_.Rendering Engine: |_.Browser:                      |_.Version:       ||_.Tested: |_.Compatible: |_.Comments: |_.Supported: |
83 10 Mischa The Evil
|                    |                                |                 ||          |              |            |             |
84 12 Mischa The Evil
|WebKit              |<._Google Chrome_               |@2.0.172.30@     ||Yes       |Yes           |            |Yes          |
85 1 Mischa The Evil
|Gecko               |<._Mozilla Firefox_             |@3.0.10@         ||Yes       |Yes           |            |Yes          |
86 10 Mischa The Evil
|Trident             |<._Microsoft Internet Explorer_ |@7.x@            ||Yes       |No            |IE7 misses full-support for the @inherit@-value (which is defined by CSS 2.1) |Yes, but "workaround":http://www.redmine.org/wiki/redmine/PluginCollapse#Workaround-for-Internet-Explorer-7 is required |
87 10 Mischa The Evil
|Trident             |<._Microsoft Internet Explorer_ |@8.0.6001.18702@ ||Yes       |Yes           |            |Yes          |
88 10 Mischa The Evil
|WebKit              |<._Apple Safari (Win32)_        |@3.2.3@          ||Yes       |Yes           |            |Yes          |
89 10 Mischa The Evil
|Presto              |<._Opera_                       |@9.64@           ||Yes       |Yes           |            |Yes          |
90 10 Mischa The Evil
91 10 Mischa The Evil
h2. Obtaining
92 10 Mischa The Evil
93 10 Mischa The Evil
The plugin can be downloaded as a packaged release from:
94 12 Mischa The Evil
* this MediaFire-account: http://www.mediafire.com/evildev
95 13 Muntek Singh
96 10 Mischa The Evil
97 10 Mischa The Evil
h2. Installing
98 10 Mischa The Evil
99 11 Mischa The Evil
# Download the plugin from the available sources (see "Obtaining":http://www.redmine.org/wiki/redmine/PluginCollapse#Obtaining)
100 10 Mischa The Evil
# Install the plugin as described at: http://www.redmine.org/wiki/redmine/Plugins (this plugin does not require a plugin database migration)
101 10 Mischa The Evil
# Login to your Redmine as an Administrator
102 10 Mischa The Evil
# Initially configure the plugin settings
103 10 Mischa The Evil
104 1 Mischa The Evil
h2. Configuration
105 1 Mischa The Evil
106 10 Mischa The Evil
This plugin can be configured under Administration -> Plugins -> Redmine Collapse plugin -> Configure. It provides the following settings:
107 10 Mischa The Evil
* Show the projects tab (default: checked)
108 10 Mischa The Evil
* Hide the core project selector (default: unchecked)
109 10 Mischa The Evil
* Show the menus tab (default: unchecked)
110 10 Mischa The Evil
** Show the project menu in the menus tab (default: unchecked, only configurable when "Show the menus tab" is checked)
111 10 Mischa The Evil
* Sidebar position (default: Left, though functionality isn't implemented [yet])
112 1 Mischa The Evil
113 10 Mischa The Evil
h2. Upgrading
114 1 Mischa The Evil
115 11 Mischa The Evil
# Download the latest archive file from the available sources (see "Obtaining":http://www.redmine.org/wiki/redmine/PluginCollapse#Obtaining)
116 10 Mischa The Evil
# Backup the currently deployed collapse plugin (@mv /vendor/plugins/redmine_collapse /vendor/plugins/redmine_collapse-backup@)
117 10 Mischa The Evil
# Unzip the downloaded file to your Redmine into the plugin-directory _"../vendor/plugins"_
118 10 Mischa The Evil
# Restart your Redmine
119 1 Mischa The Evil
120 10 Mischa The Evil
h2. Uninstalling
121 1 Mischa The Evil
122 10 Mischa The Evil
# Remove the directory _"redmine_collapse"_ from the plugin-directory _"../vendor/plugins"_
123 10 Mischa The Evil
# Restart Redmine
124 1 Mischa The Evil
125 10 Mischa The Evil
Make sure that no plugin-assets remain available in _"../public/plugin_assets/redmine_collapse"_.
126 1 Mischa The Evil
127 10 Mischa The Evil
h2. Workaround for Internet Explorer 7
128 1 Mischa The Evil
129 10 Mischa The Evil
Due to the fact that Microsoft Internet Explorer 7 doesn't fully support the @inherit@-value (which is defined by CSS 2.1), a manual modification of a CSS-declaration is required when either using the @Default@ or the @Classic@ theme (or every other theme which sets an incorrect @background-color@ on @#main@). You need to hard-code the wanted enumeration of the @inherit@-value by changing the following snippet in _"../assets/stylesheets/collapse.css"_;
130 10 Mischa The Evil
131 10 Mischa The Evil
from:
132 10 Mischa The Evil
133 10 Mischa The Evil
<pre>
134 10 Mischa The Evil
/***** Overloading Redmine Core layout-selectors *****/
135 10 Mischa The Evil
#main {
136 10 Mischa The Evil
    background-color: inherit; /* not in IE7 */
137 10 Mischa The Evil
    padding: 2px 0px 0px 14px;
138 10 Mischa The Evil
}
139 10 Mischa The Evil
</pre>
140 10 Mischa The Evil
141 10 Mischa The Evil
to:
142 10 Mischa The Evil
143 10 Mischa The Evil
<pre>
144 10 Mischa The Evil
/***** Overloading Redmine Core layout-selectors *****/
145 10 Mischa The Evil
#main {
146 10 Mischa The Evil
    background-color: #FFFFFF; /* hard-code white (#FFFFFF) for IE7 with either the Default- or the Classic-theme */
147 10 Mischa The Evil
    padding: 2px 0px 0px 14px;
148 10 Mischa The Evil
}</pre>
149 10 Mischa The Evil
150 10 Mischa The Evil
h2. Todos
151 10 Mischa The Evil
152 3 Mischa The Evil
Note that these can be a subject of change:
153 10 Mischa The Evil
* Make the position of the collapsible sidebar configurable (left ánd right)
154 10 Mischa The Evil
* Refactor the plugin to remove the requirement of overriding the base-layout
155 1 Mischa The Evil
156 7 Mischa The Evil
h2. Credits
157 7 Mischa The Evil
158 3 Mischa The Evil
Thanks goes out to the following people:
159 1 Mischa The Evil
160 10 Mischa The Evil
h3. Code-credits
161 10 Mischa The Evil
162 1 Mischa The Evil
* Eric Davis, Little Stream Software (http://www.littlestreamsoftware.com)
163 10 Mischa The Evil
** Provided skeleton for Redmine core patches (see _"../lib/collapse_application_helper_patch.rb"_)
164 10 Mischa The Evil
** Helped a lot making the overall plugin-source more Ruby-ish
165 1 Mischa The Evil
* Sebastian Kurfürst, Typo3 Development Team (http://www.typo3.org)
166 1 Mischa The Evil
** Author of the Redmine core hacks, to implement this feature for Typo3-Forge, used as a base for this plugin
167 1 Mischa The Evil
* Lalit Patel, (http://www.lalit.org)
168 1 Mischa The Evil
** Provided Javascript code to store data as JSON-strings in cookies (initially used by Sebastian)
169 1 Mischa The Evil
170 10 Mischa The Evil
h3. Translation-credits
171 1 Mischa The Evil
172 14 Mischa The Evil
* Czech (CS): "Stanislav Pach":/users/2564
173 14 Mischa The Evil
* German (DE): "Andreas Schnederle-Wagner":http://www.Futureweb.at
174 14 Mischa The Evil
* Slovak (SK): "Stanislav Pach":/users/2564
175 1 Mischa The Evil
176 10 Mischa The Evil
h2. Licensing
177 1 Mischa The Evil
178 10 Mischa The Evil
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 @COPYRIGHT.txt@ and @GPL.txt@ files for details.
179 10 Mischa The Evil
180 10 Mischa The Evil
* ©2009, Mischa The Evil (http://www.evil-dev.net)
181 10 Mischa The Evil
182 10 Mischa The Evil
h2. Support
183 10 Mischa The Evil
184 10 Mischa The Evil
If you need help, would like to report a bug or request a new feature you can contact the 
185 10 Mischa The Evil
author via mail (mischa_the_evil [AT] hotmail [DOT] com) or at his (upcoming) website: http://www.evil-dev.net.
186 10 Mischa The Evil
187 10 Mischa The Evil
As an alternative you can also join the @#redmine@-channel on the "freenode":http://freenode.net/irc_servers.shtml IRC network to see if the author is connected (with the nickname @Mischa_The_Evil@).
188 10 Mischa The Evil
189 10 Mischa The Evil
h2. Attached screenshots