Project

General

Profile

Plugins Directory » Redmine draw.io

Author: Michele Tessaro
Website: https://github.com/mikitex70/redmine_drawio
Code repository: https://github.com/mikitex70/redmine_drawio.git
Registered on: 2016-09-04 (over 7 years ago)
Current version: 1.4.8
Compatible with: Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x
User ratings:   (13)

draw.io is free online diagramming tool.

This plugin will allow embedding draw.io diagrams into Redmine wiki pages and issues.

To embedd a diagram attach it to wiki page/issue, then use a macro as:

{{drawio(activity.xml)}}

Example:

.

From version 0.3.0 there are also two new macros:

  • drawio_attach, which saves diagrams as attachments of current wiki/issue page
  • drawio_dmsf, which saves diagrams as DMSF documents

These new macros are saving diagrams as images with embedded XML source, a special format supported by www.draw.io editor. This format enables the embedded editing of the diagrams: simply double click on the diagram to start editing, then save the diagram and a new version will be saved as attachment or DMSF document.

For more details or bug submission see plugin page.

Installation notes

Install redmine_drawio plugin:


cd $REDMINE_HOME/plugins
git clone https://github.com/mikitex70/redmine_drawio.git

Restart Redmine to load the new plugin.

Changelog

1.4.8 (2023-10-22)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed a bug with the drawio_dmsf macro, and another related to MathJax.

1.4.7 (2023-06-24)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed passing arguments in the Draw.io service url.
For example, if you have a local Draw.io installation at http://drawio.local, you can configure the url as:

http://drawio.local/draw?stealth=1

to disable loading diagrams from external urls.

1.4.6 (2023-01-28)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed toolbar editor buttons with the common mark syntax.

1.4.5 (2022-12-09)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Small fix related to emails.

1.4.4 (2022-09-13)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Version v1.4.3 introduced an error that prevented the plugin from working on Redmine 4.
This version fixes it, as well as some fixes in the integration with the WYSIWYG plugin.
See the CHANGELOG for details.

1.4.3 (2022-09-07)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed toolbar buttons in the WYSIWYG editor plugin.

1.4.2 (2022-07-16)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

Now diagrams are included in the PDF export of pages from Redmine.
There are other small fixes, see the CHANGELOG.md for the details.

1.4.1 (2022-06-18)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed a potential XSS security vulnerability on macro dialogs.
The vulnerability is really minimal as the form is never submitted, but can made happy automatic scanning tools.

Other German translations have also been added in this version.

1.4.0 (2022-05-20)

Compatible with Redmine 5.0.x, 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed working on Redmine 5.

1.3.0 (2022-02-19)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Administrator can now completely disable SVG diagram support.

Now if the administrator disable SVG diagrams, they are fully disabled: existing SVG diagrams are no longer displayed and must be converted to another format.
This is a breaking change, but it makes the plugin more secure.

1.2.1 (2022-01-05)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

This is a minor fix, to track changes of an external Javascript from `embed.diagrams.net`.
The error is independent from the `redmine_drawio` plugin version, it also affects past versions, starting from when that file was modified.

1.2.0 (2021-11-24)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed XSS security with SVG diagrams.

Diagrams in SVG format can introduce XSS security issues, as they can have Javascript inside.

In this version a plugin setting has been added to allow to choose how svg images are displayed:
  • if svg is disabled, they are rendered as a base64 svg (hyperlinks not working)
  • if svg is enabled, they are rendered as inline svg, but they are vulnerable to XSS issues (mitigated, but not eliminated)

See the README.md for more details.

1.1.4 (2021-09-26)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x.

Changes in this release:

  • fixed a XSS security problem with SVG diagrams, which could be used to execute arbitrary Javascript in the browser
  • added comment in wiki page when editing an attached diagram.

1.1.3 (2021-08-26)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed use of diagrams in issues.

1.1.2 (2021-08-19)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

Fixed save diagram as attachment with single quotes in the wiki page name.

1.1.1 (2021-07-16)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed view of XML diagrams

The dynamic patch of the viewer-static.min.js was broken due to an update of the library.
Now the dynamic patch should be more robust.

1.1.0 (2021-06-18)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Only a minor change.
Now is in the diagram editor is possible to create and use custom libraries of shapes.

1.0.3 (2021-05-26)

Compatible with Redmine 4.2.x, 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed save with null journal notes.

In some cases Redmine returns null on issue journal notes instead of omitting them.
This was causing a Javascript error which prevents the diagram editor from starting.

Added also a note in the README.md on configuring the Content-Security-Policy header in the Redmine's web server to allow this plugin to work correctly.

1.0.1 (2021-03-23)

Compatible with Redmine 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed a missing Javascript file.

1.0.0 (2021-02-21)

Compatible with Redmine 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Enhanced support diagrams in XML format

Now the drawio_attach and the drawio__dmsf macros can handle diagrams in XML format, with enhanced viewer which supports page and layer selector.
The drawio macro is now deprecated and must be replaced with the drawio_attach macro.

0.9.9 (2020-12-19)

Compatible with Redmine 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Added German language translations.

0.9.8 (2020-11-07)

Compatible with Redmine 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Added Japanese language support.

0.9.7 (2020-09-24)

Compatible with Redmine 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Updated the default drawio url for the embedded editor, which is changing from apps.diagrams.net to embed.diagrams.net.

0.9.6 (2020-06-21)

Compatible with Redmine 4.1.x, 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed header/footer duplication with Wiki Extensions plugin

There was an incompatibility with the Wiki Extensions plugin which caused duplication of header and/or footer text when using header and footer pages.

0.9.5 (2020-05-04)

Compatible with Redmine 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed saving diagrams as attachments in issues.

0.9.4 (2020-05-03)

Compatible with Redmine 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x.

Fixed saving diagrams as attachments on main wiki page

There was a problem saving diagrams as attachments on main wiki page, which was reported as an erroneous message Make sure WebDAV capabilities of DMSF module is enabled.
The plugin was working fine in any other wiki page.

0.9.2 (2020-01-10)

Compatible with Redmine 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed the authorization header when saving diagrams as attachments, which prevented correct diagram saving.

0.9.1 (2020-01-06)

Compatible with Redmine 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed saving of empty diagrams

Empty diagrams doesn't have an image to click to start editing, so now
saving of empty diagrams is blocked.

0.8.3 (2018-10-27)

Compatible with Redmine 4.0.x, 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Fixed a little incompatibility with the redmine_wiki_pages plugin.
When using the drawio_attach macro, at every diagram update a new {{fnlist}} macro was appended to the wiki page.

0.8.2 (2018-05-01)

Compatible with Redmine 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

Various fixes:
  • Fixed mathjax configuration url always disabled
  • Fixed saving with DMSF 1.6.1+
  • Fixed attachment saving with restricted extensions

0.8.1 (2018-02-24)

Compatible with Redmine 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

  • Added Danish translation.
  • Added traditional chinese translation.
  • Added in the markdown editor the buttons for inserting macros.
  • Local MathJax installation support
  • Fixed SVG saving in DMSF
  • Fixed working with rails 5
  • Fix bug while saving diagram on page with non-ascii name.
  • Fixed https access to the drawio site

0.8.0 (2017-07-16)

Compatible with Redmine 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x.

New language translations and various fixes

  • Tested on Redmine 3.4.0-stable
  • Added mathemathics support in SVG
  • Added Simplified Chinese translation
  • Added russian translation
  • Fixed foreign characters in SVG diagrams
  • Fixed invalid character stripping from filenames
  • Fixed saving on DMSF 1.5.9+

0.7.1 (2017-06-12)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x.

Changes:
  • fixed diagram filename extension check
  • auto disabled SSL if the drawio app is served with HTTP protocol
  • updated documentation

0.7.0 (2017-06-11)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x.

  • added support for EasyRedmine
  • added buttons for CkEditor plugin
  • buttons on textile editor can edit macro
  • disabled DMSF support if not installed or not active
  • many fixes, see the CHANGELOG.md

0.6.0 (2017-04-11)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

Added embedded editor support for diagrams in SVG format.
Append and .svg extension to diagram names and you are free to use SVG diagrams.

0.5.0 (2017-01-26)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

  • Added configuration dialog for setting a local draw.io installation (see the README.md)
  • Added support for issue notes
  • Fixed UTF-8 encoding in init.rb
  • Fixed computation of Redmine URL if not installed in the root path of the web server

0.4.0 (2016-12-10)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

  • Added size option to set diagram width (in pixels)
  • Fixed errors when used outside issues and wiki pages
  • Fixed redmine path with custom routes
  • Fixed load of loading image using protocol-relative paths (eg. https)

0.3.2 (2016-11-22)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

  • Some fixes for running in a Windows hosted Redmine (tested with Bitnami).
  • More friendly error messages when saving with the DMSF plugin.

0.3.1 (2016-11-03)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 2.6.x.

  • Fixed saving of diagrams with the embedded editor if Redmine isn't running from the root path (for example, is running from the /redmine web folder)
  • Fixed buttons swapped in the toolbar editor

0.3.0 (2016-11-01)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 2.6.x.

Added two new macros for embedding diagrams, macros that can launch an embedded diagram editor:

  • drawio_attach, which saves diagrams as attachments of wiki/issue pages. Double click diagram images to start editing.
  • drawio_dmsf which saves diagrams as DMSF documents. Double click diagram images to start editing.
  • added buttons on toolbar editor to easy inserting diagram macros (only for those with embedded editing).

See the README.md for more details.

0.1.3 (2016-10-13)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

Fixed rendering of some graphs (like flowcharts).

0.1.2 (2016-09-10)

Compatible with Redmine 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.6.x.

0.1.1 (2016-08-02)

Compatible with Redmine 3.2.x, 3.1.x, 3.0.x, 2.6.x.

screenshot.png (52.1 KB) screenshot.png Diagram example Michele Tessaro, 2016-09-04 17:20

User ratings

  by DB F 7 months ago

  by Ric Bon about 1 year ago

  by mo xun about 1 year ago

very good

  by Steven Uggowitzer over 1 year ago

Currently not working on Redmine 5.x

  by Marcos Mata almost 2 years ago

  by Jihyeon Gim about 4 years ago

  by Christoffer Rumohr over 4 years ago

Great plugin, we are using it every day!

  by Do Tuan Anh over 4 years ago

Very useful plugins. Installed with redmine 3.4.1 (bitnami) and run well. Thanks !!!

Want to install a local of drawio but don't know how to configure

  by Vincent Robert almost 5 years ago

  by Harris Byun over 5 years ago

In the past, I didn't konw this plugin was so useful!
When use charts, this is the best plugin.

  by Alexandr Korovets over 6 years ago

  by Steven Wong almost 7 years ago

wow, amazing plugin. Thanks.

  by Anton Sergeev about 7 years ago