New Plugin: AddMermaid

Add rendering of mermaid.js diagrams in markdown texts.

<div class="mermaid">
sequenceDiagram
    Alice->>John: Hello John, how are you?
    John-->>Alice: Great!
    Alice-)John: See you later!
</div>

See GitHub - euneuber/AddMermaid: Add rendering for mermaid.js sections in kanboard markdown texts

Hi euneuber,

for a test (to find out for which of my needs that might be useful) I would prefer a plugin version which can simply be copied to /plugins folder

Hey Rainer,
Instead of cloning the repo, you could download a usual zip from here.
Rename the directory after expanding.

Hi Alfred,

that finally now works. At first attempt the plugin destroyed acces to the test KANBOARD, but now with AddMermaid in my Plugins folder all seems to work now, and euneuber’s example diagram also becomes shown:

My config:

Version: 1.2.20
PHP Version: 7.4.30
PHP SAPI: fpm-fcgi
HTTP-Client: cURL
OS Version: Linux 4.15.0-188-generic
Datenbanktreiber: mysql
Datenbank Version: 5.7.37-nmm1-log

Plugins: Wiki, Self-Registration, AddMermaid, MarkdownPlus
Browser: De SeaMonkey 2.53.14 beta 1 pre Mozilla/5.0 (NT 6.1; Win64; x64; rv:68.0) Gecko/20100101 Firefox/68.0 Build 20220801210005 (normal user Profile and Default Classic Theme) on German WIN10 64bit

1 Like

Hi Eugen,

thx a lot for this new Plugin!

I did another test without that “destroyed access” problem.
For me – probably for everybody – AddMermaid only works with additional plugin MarkdownPlus. If I’m right you should mention this on the download page.

Hi Rainer,

Thank you for clarifying the requirement – I always install MarkdownPlus on my kandoard servers…

I added a hint in the README.md.

Is there a formal definition for requirements in Plugin.php?

For this question we will have to wait for an expert, I’m not.

BTW soemthing completely different:

My favorate Live Mermaid Generator currently is https://mermaid.live/
May be I’m not the only one who never heard about mermaid, and it would help newbes lke me to have some HowTos in the ReadMe?

no. nothing formal.

could add something basic in initialize:

if (!file_exists('plugins/Markdownplus)){

Insert do action

}

Yes, https://mermaid.live/ is really helpful when creating something bigger, because you get instant feedback.

I will look into a HowTo section for the ReadMe.

Ok, this will prevent the bad and ugly things.

How can I promote such an error to the user? (e.g. message on the web page)

that depends on your html/css skills.

a flash message using kanboards messaging system might be too quick, and go unnoticed.

i would mimic kenlogs update notifier, with a top bar notice.