additionals customizes Redmine with dashboards, wiki macros, issue rules and a global search, and is the shared library for other Redmine plugins.
- Redmine.org plugin page: https://www.redmine.org/plugins/additionals
- GitHub: https://github.com/alphanodes/additionals
- Dashboards for the home page and project overviews, arranged by drag and drop, private, shared or per role
- Global search dialog (Cmd+K or Ctrl+K) on all pages
- Wiki macros, e.g. for videos, maps, icons, members, projects and recently updated pages, with a macro button in the wiki toolbar
- Issue rules: freeze closed issues, assign automatically on status changes, require logged time for selected statuses
- Issue shortcuts: Assign to me, status change in the sidebar, fast edit of the description, new issue from a user profile, linked categories
- Note for new issues, global and per project
- Global contents: text on the login page, global sidebar, footer and wiki sidebar
- Hidden roles in member boxes and lists, auto-watch of issues assigned to you, change of the issue author
- Help menu with links to the documentation of Redmine and installed plugins
- PDF options for wiki pages, emoji and legacy smiley support, hiding of project modules
The manual describes all functions and settings.
Note: We reserve the right to remove functions again, e.g. when Redmine itself provides them or they conflict with it.
| Name | Requirement |
|---|---|
| Redmine | >= 7.0.3 |
| Ruby | >= 3.3 |
| Database | MySQL >= 8.4, MariaDB >= 11.8 or PostgreSQL >= 16 |
Only MySQL (including MariaDB) and PostgreSQL are supported. The plugin refuses to load on SQLite or MSSQL, although Redmine supports them.
With MySQL or MariaDB, all tables must use the same storage engine (InnoDB recommended) and character set (utf8mb4 recommended). With mixed engines, migrations that add foreign keys to a MyISAM table fail with a misleading does not match column ... type error.
cd $REDMINE_ROOT
git clone -b stable https://github.com/alphanodes/additionals.git plugins/additionals
bundle config set --local without 'development test'
bundle install
bundle exec rake redmine:plugins:migrate RAILS_ENV=productionRestart the application server afterwards. More about plugins in the Redmine plugin documentation.
cd $REDMINE_ROOT/plugins/additionals
git pull
cd ../..
bundle install
bundle exec rake redmine:plugins:migrate RAILS_ENV=productionRestart the application server afterwards.
cd $REDMINE_ROOT
bundle exec rake redmine:plugins:migrate NAME=additionals VERSION=0 RAILS_ENV=production
rm -rf plugins/additionalsUninstall all plugins that depend on additionals first.
additionals gives plugins a common base, so they do not ship and load the same libraries in different versions.
| Library | Version |
|---|---|
| Chart.js | 4.6.1 |
| Chart.js plugin annotation | 3.1.0 |
| Chart.js plugin colorschemes (patched for Chart.js 3+) | 0.4.0 |
| Chart.js plugin datalabels | 2.2.0 |
| Chart.js chart matrix | 3.1.0 |
| Chart.js chart sankey | 0.19.1 |
| Chart.js chart treemap | 4.2.2 |
| dhtmlxGantt | 9.1.4 |
| mermaid | 12.3.0 |
| Sortable | 1.15.7 |
| Tom Select | 2.7.0 |
Pages and dashboard blocks load only the libraries they need, each file once per page:
additionals_library_load :chartjs_metaThe Library Loader lists all library names and describes loading in dashboard blocks and on demand in the browser, how plugins register libraries of their own, and how the bundled libraries are updated from npm (redmine:additionals:vendor:update), which also keeps the versions above current.
- Dashboard Development Guide: dashboard blocks and dashboard types
- Library Loader: JavaScript and CSS libraries for pages and blocks
- Chart Development Guide: charts in blocks and pages
- Settings Schema: declared settings for blocks and queries
- Select Fields: select fields with search, tags and query filters
- Updating mermaid
- additional_tags
- redmine_ai
- redmine_automation
- redmine_clamav
- redmine_db
- redmine_devops
- redmine_gantt
- redmine_git_hosting
- redmine_hedgedoc
- redmine_hrm
- redmine_issue_checklists
- redmine_issue_view_columns
- redmine_passwords
- redmine_privacy_terms
- redmine_reporting
- redmine_saml
- redmine_servicedesk
- redmine_sudo
- redmine_templates
- redmine_timesheet
- redmine_wiki_guide
You know another plugin using additionals? Let us know or open a pull request.
Pull requests with fixes and features are welcome. Please use the issue tracker for questions and feedback. All contributions are licensed under the terms of GNU/GPL v2.
additionals is maintained by AlphaNodes, an open source service company from Munich. If you need a feature you cannot implement yourself, AlphaNodes offers commercial plugin development, as long as the feature fits the purpose of the plugin.
This plugin is licensed under the terms of GNU/GPL v2, see LICENSE.
additionals is an extension for Redmine, Copyright (C) 2006- Jean-Philippe Lang, a flexible project management web application written using the Ruby on Rails framework. More details on https://www.redmine.org.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- Tabler Icons, Copyright (c) 2020- Paweł Kuna, MIT License
- mermaid, includes code from DOMPurify, licensed under the Mozilla Public License 2.0 and the Apache License 2.0
- Tom Select, licensed under the Apache License 2.0