Postmark Email Integration for Kanboard
Clone or download
Latest commit 8ffdbfd Jun 16, 2018
Permalink
Failed to load latest commit information.
Controller
Locale
Template
Test
vendor
.gitignore
.travis.yml
EmailHandler.php
LICENSE
Makefile
Plugin.php
README.md Add for Reply-To header Feb 19, 2017
composer.json
composer.lock Handle attachments Feb 5, 2017
postmark-icon.png

README.md

Postmark plugin for Kanboard

Build Status

Use Postmark to create tasks directly by email or to send notifications.

  • Send emails through Postmark API
  • Create tasks and attachments from incoming emails

Author

  • Frederic Guillot
  • License MIT

Requirements

  • Kanboard >= 1.0.40
  • Postmark API credentials

Installation

You have the choice between 3 methods:

  1. Install the plugin from the Kanboard plugin manager in one click
  2. Download the zip file and decompress everything under the directory plugins/Postmark
  3. Clone this repository into the folder plugins/Postmark

Note: Plugin folder is case-sensitive.

Kanboard Configuration

You can configure this plugin through the user interface or with the custom config file.

Configuration via the user interface

Go to Settings > Integrations > Postmark:

Postmark

Configuration via the config file (alternative method)

Define those constants in your config.php file to send notifications with Postmark:

// We choose "postmark" as mail transport
define('MAIL_TRANSPORT', 'postmark');

// Copy and paste your Postmark API token
define('POSTMARK_API_TOKEN', 'COPY HERE YOUR POSTMARK API TOKEN');

// Be sure to use the Postmark configured sender email address
define('MAIL_FROM', 'sender-address-configured-in-postmark@example.org');

Use Postmark to create tasks from emails

Just follow the official documentation about inbound email processing. Basically, you have to forward your own domain or subdomain to a specific Postmark email address.

The Postmark webhook URL is visible in Application Settings > Integrations > Postmark

  1. The sender email address must be same as the user profile in Kanboard and the user must be member of the project
  2. Set a project email address in Project Settings > Edit Project
  3. Send an email to your project

Troubleshooting

  • Test the webhook url from the Postmark console, you should have a status code 200 OK

Changes

Version 1.0.8

  • Add support for Reply-To header

Version 1.0.7

  • Use project email address instead of project identifier
  • Create task in first active swimlane
  • Add email body as task attachment
  • Handle email attachments