For developers, here is an overview to provide the basics for integrating with Drupal 8. (Non-developers can find a walkthrough of installing Drupal in Kapost in this article.)
First things first: Before you configure Drupal 8 with your Kapost instance, make sure some of the standard modules in your Drupal are up to date. These modules are XML-RPC and Kapost plugin, both of which are available for free from Drupal. You'll need the latest versions or the modules and you must have access to your actual Drupal server in order to install these.
This article will cover three steps to integrate with Drupal in Kapost:
Install and enable the XML-RPC and Kapost modules.
Configure the Kapost module.
Add a Drupal 8 publish destination by going to Kapost’s App Center. (This step can be completed by a non-developer and is covered here.)
1. Install and enable the XML-RPC and Kapost modules
Before you can use Kapost to publish to your Drupal 8 instance, you need to install and enable
the following modules:
2. Configure the Kapost module
Next, the Kapost module must be configured. Do this by going to the "Kapost Settings" in Drupal:
The "Metatag" Field will only show up if the Drupal instance has the “Metatags” module. The SEO section of Kapost will “map” to this “Metatag Field.”
3. Add a Drupal 8 publish destination in Kapost's App Center:
After the configuration has been saved, you can now add a Drupal 8 publish destination by going to the Kapost App Center.
(Attempting to “connect” before these two modules are installed will result in a failure.)
In your Kapost Instance, go to Settings → App Center, then click "Install More Apps" and choose your platform from the App Center to be Drupal. If applicable, choose which Instance you wish to connect.
You will be directed back to your Instance and your Drupal Integration box will appear. Enter the authentication info for the Drupal user you wish to connect (this user doesn't have to be an Admin level user, but does need correct publishing permissions).
Once you click connect, a pop-up will appear asking which of your blogs you would like to publish to; in Drupal, these are referred to as content types or nodes. You can find them in Drupal by going to Structure → Content Types.
Select the blog or node you would like this connection to publish to. In the example image below, the user is connecting to "article":
You can only connect to one blog or node per Drupal connection. If you wish to publish to more than one node, you need to create another Drupal connection following the steps above. You may use the same user, but when the node pop-up appears, select a node different from the one in your previous connection.
Don't forget: Once you've connected in the App Center, you will need to add Drupal as a primary destination to your content type.
Head to Content Types & Workflow in Kapost Settings and you can choose the Drupal instance(s) that you've connected to as the primary destination. Click save and you're ready to publish.
If you'd like to sync your Drupal categories to Kapost, find information in this article.
Lastly, if you want to preview Drupal posts in Kapost before publishing them, you need to enable Preview frist. Here is how to enable this feature.
If you have any questions or feedback, email us at firstname.lastname@example.org.