About GatherContent

GatherContent is an online platform for pulling together, editing, and reviewing website content with your clients and colleagues. It's a reliable alternative to emailing around Word documents and pasting content into your CMS. This plugin replaces that process of copying and pasting content and allows you to bulk import structured content, and then continue to update it in Drupal with a few clicks.

Connecting a powerful content production platform, to a powerful content publishing platform.

Module Overview

Installing the module on your site allows you to quickly migrate content from your GatherContent account to Drupal. Content can be imported as any sort of node content type. And you can choose to create new pages etc. or overwrite existing entities.

The module currently supports the following features:

Migrate content from GatherContent
Update content in Drupal from GatherContent
Update content from Drupal to GatherContent
Multilingual support using Entity translation module
Meta tag basic support
Content hierarchy
Drush support

This module isn’t backward compatible with older major versions of module and there is no upgrade path.

Installation

We're highly recommend to use the latest stable 8.x-4.3 version of this module.
Since the 8.x-4.x version the module uses a custom made library for API communication, because of this, using composer to install the module is the most efficient/easiest way.

Examples:

To install the latest development version run composer command from your Drupal root directory: composer require 'drupal/gathercontent:4.x-dev'
Or to install the latest stable version: composer require 'drupal/gathercontent'

This way the module dependencies will be automatically downloaded.

Drupal 8

The currently supported stable branch for Drupal 8 is 8.x-4.x. It provides two (previously four) separate modules:

GatherContent Core (import and drush support)
GatherContent UI (UI for the mapping and manual import)
GatherContent Upload (upload support) REMOVED in 8.x-4.x*
GatherContent Upload UI (UI for the upload support) REMOVED in 8.x-4.x*

* The upload modules are removed because the new version (v0.5 Content Editor update) of the GatherContent API won't support uploads.

We highly recommend to use the latest 8.x-4.3 version of the module.

Together they implement all features of the Drupal 7 module, and more:

Entity reference fields referencing to taxonomy terms
Date and datetime field
Importing to and exporting from Paragraphs fields

Module version 5.0 Beta3 and 5.x-dev

IMPORTANT: If you are upgrading from an older version, please apply the patch for the core found here: https://www.drupal.org/project/drupal/issues/3039991. Without this patch, some updates can fail!

This new version of the module got an almost complete rewrite.
The custom importing and exporting solutions are replaced by the Migrate API, Migrate Tools and Migrate Plus functionality.

We made this version backward compatible, so everything is the same at the outside.
After updating it is necessary to visit the update.php or to run the following drush command: drush updatedb

IMPORTANT: Moving the previously imported content to Migrate API compatible one is currently not supported. We are working on the solution. In the meantime, it is advised to install this module as a new one or delete the previously imported content and re-import it.

The only changes that affect the UI are the following:

Changing content update method is removed due the migrate API’s limitations
The Update content from Gathercontent menu element is removed, because with the Migrate API we will only need one import selection form

Known problems/missing features period:

Changing content update method is removed due the migrate API’s limitations

API

To interface with the GatherContent API we have created a PHP library, with which the Drupal module is interacting. As of 8.x-4.x we are depending on the cheppers/gathercontent-client library to do all the API specific work, the module no longer contains them.

For both Drupal 7 and Drupal 8 we prepare API allowing you to modify data of imported or updated content in Drupal and content being published into GatherContent. Check our Events for Drupal 8 and hooks for Drupal 7.

Standalone PHP library

Since the 8.4 version the module uses the GatherContent REST client to communicate with the GatherContent REST API. This library provides CMS independent functionality for implementing GatherContent integration on any platforms.

Planned Improvements

We're continuously improving and updating the module.

Related modules

GatherContent OG - integration with Organic Groups for Drupal 7

RTBC issues for GatherContent

Filters