This is a developer's walkthrough of integrating with Drupal 7. Please note, this is not a deep dive, but rather an overview that will give you a basic idea of what is involved. Drupal is highly customizable, and thus difficult to encapsulate in one article. For more info, contact support at email@example.com. For a non-developer's walkthrough of installing Drupal in Kapost, read this article.
Drupal 7 is a complicated beast. Before you install the BlogAPI and Kapost's plugins, you need to first make sure some of the standard modules in your Drupal are up to date. These modules are Chaos Tools and Services. 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:
- Installing the BlogAPI module. After this is done, we'll walk you through how to set the configurations so it works correctly
- Installing the Kapost Byline Module.
- Set your configuration parameters so that the blog API module works correctly
1. Installing Blog API:
To install the BlogAPI plugin, go to the Modules section of Drupal. Click on the "Install new module" link. Depending on how your Drupal is set up, you might need to FTP this module to your server. The module can be downloaded from https://www.drupal.org/
Once the BlogAPI module is installed, you then must enable and set the permissions for it. On the Module page, scroll down to the "Services" area. Listed there will be all the services you'll need. You need to enable the Services in Drupal. Kapost uses pieces of Metawebblog and BlogAPI, so please enable all of them.
While you're there, you also need to set permissions for the BlogAPI. In the right of its row is a "Permissions" link for the BlogAPI. Click that.
In the Services permissions area, you should scroll down to the "Services" area and also make sure all their items are set to Administrator as well.
The BlogAPI module is almost set up - there are just a few final steps for you to complete.
Next, you need to go the "Configurations" tab, find the "Web Services" area and click on BlogAPI link.
On this page: you should first check metawebblog
2. Installing the Kapost Byline Module:
After all this is done, now you should install the Kapost Byline Module, which is updated by node type. The plugin is available to download here . In Drupal, you can install by going to Modules tab and clicking "Install."
Then you should enable it, and then you'll need to configure it. You'll see a Kapost section (still under "Modules") and you'll see a configuration link.
Clicking that link will allow you to adjust here how specific Kapost features are configured such as categories, featured images and author attribution.
SEO Metatag Module: The Plugin also allows you to sync SEO title, descriptions, keywords and abstract for the Metatag module. The SEO fields at the bottom of Kapost (built in) will sync title, dsecription, keywords and then you will need to create a custom field with this field name: _metatag_abstract. The minimum version we support is '7.x-1.0-beta7' but the latest version is best.
3. Set up some parameters around the content that you will be publishing from Kapost to Drupal.
First, you should add any node types (content types) you'd like to associate with the content that comes in via Kapost. Unlike Wordpress, Drupal requires you to choose your node types within Drupal, and then connect with each node separately in Kapost. This is outlined in the article Connecting with Drupal 7 in Kapost, but the steps in the article you are reading now must be completed first.
After that, you need to specify which field types you would like to have available for each node. To do this, go to Structure -> Content Type -> manage fields.
To learn about syncing your field types in Drupal with custom fields in Kapost, read this article.
On this same page you will see file settings. In this area, you should increase the max file side upload for both the general area and the administrator role. We recommend it go to 100MB, unless you plan on uploading very large images, in which case you should pick a larger limit. Please note, if your max file size is not large enough, your pictures will not pull through.
Once all of these steps have been completed, you or a non-developer can integrate your Drupal site with your Kapost instance.
If you would like to sync your categories in Drupal with Kapost, read this article.
if you have any questions, contact support at firstname.lastname@example.org and a support engineer will be in touch.