Introduction to the Drupal Integration
Integrate GatherContent with Drupal. Using the integration you can:
- Migrate content from GatherContent into Drupal
- Update migrated content in Drupal
- Update your content in GatherContent with changes from Drupal
How does the integration work?
The integration allows you to quickly migrate mapped content from GatherContent to Drupal. Content can be imported as any sort of node content type.
The integration was produced and is maintained by Cheppers, in partnership with GatherContent.
The module supports Drupal 7 and 8.
This module isn’t backward compatible with older versions of the module and we don’t provide any upgrade path for it.
Installing the GatherContent Module
Follow these steps to install the Drupal module:
1. Download the package
Download the package from Drupal.org.
2. Install the package on your Drupal site
Follow the steps outlined on Drupal.org to install your GatherContent module (in case of version 8.x-4.x make sure to enable the GatherContent UI, GatherContent Upload and GatherContent Upload UI modules as well, all found in the same package):
3. Check the menu item exists
After you install the GatherContent module, you will find a new menu item named GatherContent in:
Location: the Admin > Configuration menu (/Admin/Configuration/GatherContent).
Tip: The Drupal 7 module needs Guzzle v5.3.1 as a dependancy.
Location: Manage > Configuration menu (/Admin/Configuration/GatherContent).
Tip: The Drupal 8 module uses the Guzzle module attached to the core install.
Configuring the module
Here's how you can authenticate your module after installing it:
1. Head to Authentication
You will find authentication in:
Location: Admin > Configuration > GatherContent > Authentication (/admin/configuration/GatherContent/configuration).
Location: Manage > Configuration > GatherContent > Authentication (/admin/configuration/GatherContent/configuration).
2. Enter your email address and API Key
Enter your GatherContent user email address and your GatherContent API Key. Here’s information on where you can generate an API key from. Then click the 'Verify' button.
3. Choose the GatherContent account to connect to
After verifying your credentials, you need to choose the GatherContent account you will be using to import content. Then click the 'Save' button.
4. Test the connection
You can test the connection with your GatherContent account on the 'Test connection' tab.
5. Set the import configuration details
You can set some global options for your future imports and updates such as the default update method or default node status after an import/update.
You will find the import configurations in:
Location: Admin > Configuration > GatherContent > Import configuration (admin/configuration/GatherContent/import-config)
Location: Manage > Configuration > GatherContent > Import configuration (admin/configuration/GatherContent/import-config).
Once complete, you can move onto setting up your Template Mappings.