• 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!

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:

1. Send emails directly to a task
2. Send emails to a project to automatically be converted into a task within the project
3. Send emails to a task to automatically convert into a task comment
4. 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 #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<[email protected]>
• to send an email to a project for task conversion: Project#1<[email protected]>
• to send an email to a task for comment conversion: CommentOnTask#1<[email protected]>

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:

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

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

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

1. 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

2. 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

1. 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.