Skip to content
This repository has been archived by the owner on Feb 3, 2019. It is now read-only.
/ plugin-postmark Public archive

[NOT MAINTAINED] Postmark Email Integration for Kanboard

License

Notifications You must be signed in to change notification settings

kanboard/plugin-postmark

Repository files navigation

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