Checkout our latest project

With DocPHT you can take notes and quickly document anything and without the use of any database.

⭐ If you use it, you should star it on Github! It's the least you can do for all the work put into it!

🪄 Mailmagik for Kanboard

Have you ever found yourself struggling with the process of creating a task in Kanboard via email? Maybe someone recommended the Mailgun Plugin, but you ended up feeling frustrated and out of pocket when you discovered its cost. Or perhaps someone suggested using Zapier and API, but you were left scratching your head and wondering what on earth they were talking about.

Well, fear not! We have the solution for you. Our plugin is easy to install and allows you to connect to an IMAP server of your choice. With just a few clicks, you'll be creating tasks like a pro in no time.

Say goodbye to confusion and frustration, and say hello to Mailmagik! Join us today and let's make task creation a breeze.

This plugin allows you to connect Kanboard directly to an IMAP server. Once connected, you can:

Send emails directly to a task
Send emails to a project to automatically be converted into a task within the project
Send emails to a task to automatically convert into a task comment
Adds a Trigger Event that can be called using the Crontab

For #2 & #3

Using the Daily Background Job for Tasks: You will need to setup the automatic actions in the project config, and there MUST be at least 1 open task within the project
Using the Mailmagik mail fetching trigger: You will need to setup the automatic actions in the project config

For #2

The sender of the mail must be a member of the targeted project, with the permission to create new tasks.

For #4

Trigger using: ./cli mailmagik:fetchmail
Example of adding to crontab to run independently of Daily Background Job:

0 8 * * * cd /var/www/app && ./cli cronjob >/dev/null 2>&1
* * * * * cd /var/www/app && ./cli mailmagik:fetchmail

Once installed, setup in Settings > Email settings:

The Parse Option allows you to choose how to parse the actions, using the TO: field or the SUBJECT: field

When using the TO: option, see examples below:

to send an email directly to a task: Task#1<myemail@email.com>
to send an email to a project for task conversion: Project#1<myemail@email.com>
to send an email to a task for comment conversion: CommentOnTask#1<myemail@email.com>

When using the SUBJECT: option, see examples below:

to send an email directly to a task: [Task#1] should appear at the start of the Subject
to send an email to a project for task conversion: [Project#1] should appear at the start of the Subject
to send an email to a task for comment conversion: [CommentOnTask#1] should appear at the start of the Subject
note: the action must be in brackets

Emails sent to a task can be found in the Task uner the "Task Email" icon on the sidebar:

In order to setup automatic conversions of email, you will need to add the Actions to the project.

When sending emails for automatic Task Conversion, MailMagik can parse the subject line to add attributes to the Task:

in Subject	Effect
d:YYYY-MM-DD	Set due date
s:YYYY-MM-DD	Set start date
p:n	Set priority n
c:name	Set category 'name'
t:name	Add tag 'name', may be repeated. Non-existing tags will be created, beware of typos.
col:name	Set column 'name' to bypass default column

A subject line containing

Test c:SQL p:3 d:2023-02-28 s:2023-02-20

will create a priority 3 task named "Test", category "SQL", start on Feb 20 and due on Feb 28.

Plugin Authors:

creecros
alfredbuehler

Collaborators and Contributors:

aljawaid

Requirements

https://github.com/barbushin/php-imap#requirements

If you are using the docker containter of Kanboard, simply remote into it and:

apk update
apk add php-imap
apk add php81-fileinfo

PHP 7.4 Check:

php -m | grep -i imap

$ sudo apt-get install php-imap
$ sudo apt-get install php7.4-imap
$ sudo apt-get install -y php-fileinfo

Run both commands

Install

Automatically

If your Kanboard installation is configured to install from the app, simply find it in the plugins directory and choose install.
Restart your server

Manually

Download the latest versions supplied zip file, it should be named Mailmagik-x.xx.x.zip

I advise not to install from source or master

Unzip to the plugins folder.

your folder structure should look like the following:

plugins
└── Mailmagik            <= Plugin name
    ├── Action  
    ├── Assets  
    ├── Controller  
    ├── Template
    ├── vendor
    ├── LICENSE
    ├── CHANGELOG.MD 
    ├── Makefile 
    ├── Plugin.php   
    ├── README.md
    ├── composer.json
    └── composer.lock

3.) Restart your server

Troubleshooting

If you are getting OP_READONLY complaints about an undefined variable, then you are missing the php-imap requirement, install req, enable and restart server.

creecros / Mailmagik