Overview of integration possibilities

Kordiam can interact with other systems in a variety of ways.

This page provides you with an overview of all integration options:

• Integrating with your Content Management System (CMS) via API
• Content export via ftps
• Importing and exporting events/appointments data

If you have questions about how to integrate with Kordiam, please email support@kordiam.io.

Integrating with your Content Management System (CMS)

Depending on the CMS you use you have these integration options:

• WordPress Plugin (how it works -- how to set it up -- the plugin on WordPress.org)
  
  
• Drupal Module for Drupal7, Drupal8, Drupal9 and Thunder (how it works -- how to set it up -- the module on Drupal.org)
  
  
• Other CMS - see description below

Integrating with a CMS other than WordPress or Drupal

You can set up either a one-way or bi-directional integration between your CMS and Kordaim.

To review the technical options of integrating Kordiam with a (headless) CMS or an editorial system please read this post.

To get an idea of what kinds of use-cases your integration could support, read how our WordPress Plugin works. This documentation can serve as a blueprint for your own integration.

Among others, we have integrated Kordiam with Livingdocs, Aptoma, Cue of StiboDX, Purple by Sprylab, WoodWing and K4. 

If you are interested in a custom CMS integration, please contact us at support@kordiam.io.

Content Export

The above-mentioned web-services can export content such as text or picture files that have been uploaded via the Content tab to a REST API.

Instead of using the web-service, you can also export such content via ftps in the News ML G2 data standard instead. Learn more about the ftps export.

These two options are typically being used when integrating Kordiam with a Digital Asset Management (DAM) / Media Asset Management tool (MAM).

Events/appointments

Kordiam handles events and appointments such as press conferences, interview appointments, city hall meetings, or sporting events.

From a structural point of view, events and appointments are the same type of element as a story. The difference is that events and appointments contain an event date (start/end; and optionally an event start and end time).

Reading and exporting events and appointments

Using the Kordiam API is the best way to read events and appointments. You can get individual appointments by ID or lists of events (e.g. all appointments related to next week's sports pages of your website).

All users can subscribe to a webcal feed using their electronic calendars (e.g. Outlook, iPhone Calendar, etc.). All personal assignments (e.g. attending a press conference) are then exported to the user’s calendar.

The webcal feeds can be found at the bottom of the My Settings page.

Inserting individual events and appointments

Kordiam API

The Kordiam API allows you to enter new events or appointments, and to edit existing ones.

Event Feeds

Kordiam can import event XML files via ftps from sources such as wire agencies (e.g. Keystone-SDA, STT, Zapaday) or event databases (e.g. MSU Event, LeoEvent, Tempestiva).

The XML files preferably adhere to the EventsML G2 standard. However, in coordination with the Kordiam developer team, custom formats can be imported as well.

Read more about how to import event feeds.

Inserting and importing event data via an ics file is currently not possible. If this feature is important to you, please contact us at support@kordiam.io to discuss.

Emails

Often a story is based on an email that has been received by the newsroom or editorial department.

Importing an email and turning it into a Story is an easy manual process described here.

If you want your team to be able to send emails to Kordiam to have them automatically converted into calendar events, see "Automatic Import into a Calendar".