Integrate With Drupal 8: Modules, Tips, and Usage
This is a developer's walkthrough of integrating with Drupal 8. Please note, this is not a deep dive, but rather an overview that will give you a basic idea of what is involved. For more info, contact support at firstname.lastname@example.org. For a non-developer's walkthrough of installing Drupal in Kapost, read [this article.]
Before you configure Drupal 8 with your Kapost instance, you need to first make sure some of the standard modules in your Drupal are up to date. These modules are XML-RPC and Kapost plugin. Both are available for free from Drupal and we've linked to their pages here. Please check to make sure you have the latest versions of these before doing anything else. Note, you must have access to your actual Drupal server in order to install these.
The next three steps are elaborated on below:
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.
1. Install modules:
Before you can use Kapost to publish to your Drupal 8 instance you need to install and enable
the following modules:
kapost (http://plugins.kapost.com/kapost_d8.zip) [this link will not work for now]
2. Configure the Kapost module:
Once this has been done, the Kapost module has to be configured by going to the "Kapost Settings" in Drupal.
The “Metatag Field” will only show up in the Drupal instance has the “Metatags” module. The SEO section of Kapost will “map” to this “Metatag Field”.
[the rest of the fields should be self explanatory]
3. Add Drupal 8 publish destination in App Center:
After the configuration has been saved, it is now possible to add a Drupal 8 publish destination by going to the App Center.
Attempting to “connect” before these two modules are installed will just result in a failure.
This step can be completed by a non-developer and is covered in [this article]. It is also outlined below for your convenience.
In your Kapost instance, go to Settings → App Center. You will want to 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 - please note, this user doesn't have to be an Admin level user, but a user that has 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/node you would like this connection to publish to - in this instance, the user is connecting to "article."
You can only connect to one blog/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.
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, read this article.
Lastly, if you wish to preview Drupal posts in Kapost before publishing them, you need to enable Preview. Here is how to enable this feature.
If you have any questions or feedback, don't hesitate to email us at email@example.com.