Information for: DEVELOPERS   PARTNERS

Creating a subscribing website

Acquia Content Hub attempts to simplify the setup process by removing most of the initial configuration options. Once the subscribing website is configured and connected to your publishing website using the webhook, the subscribing website queues data for import as it’s exported by your publishing website.

Prerequisites

Configuring an Acquia Content Hub publisher website requires the following information:

  • Acquia Content Hub Hostname: Your Acquia Content Hub service URL.
  • API Key: Your Content Hub API key.
  • Secret Key: Your Content Hub secret key.

If you don’t have this information, see Configuring Acquia Content Hub.

Acquia Content Hub also requires a valid SSL certificate for normal operation.

Note

Websites without a valid SSL certificate must configure their webhooks to use http, not https.

Installing the subscriber modules

To create an Acquia Content Hub subscribing website, perform the following steps:

  1. Sign in to your Acquia Content Hub publishing website as a user with the Administrator role.

  2. In the admin menu, click Extend.

  3. Select the check boxes next to:

    • Acquia Content Hub
    • Acquia Content Hub Subscriber
    • Acquia Content Hub Curation

    The Subscriber module handles the syndication import process. The Curation module provides an interface to create Cloud Filters.

  4. Click Install.

  5. In the admin menu, go to Configuration > Acquia Content Hub.

  6. Enter the following information:

    • Acquia Content Hub Hostname: Your Acquia Content Hub service URL.
    • API Key: Your Content Hub API key.
    • Secret Key: Your Content Hub secret key.
    • Client Name: Use a name to describe this website, such as subscriber_test. Client names should be unique per website and environment and not contain special characters. The Content Hub service uses the client name across the websites to distinguish where your content was created.
  7. Click Register site.

Note

To register a webhook with Content Hub, the publicly accessible URL must be an externally accessible URL. It can’t be behind a firewall or use password protection such as the Shield module or an .htaccess password. Content Hub must communicate with a subscriber’s website, and receive a valid response from the URL. If you require password protection of a website, you must whitelist the webhook URL path to be publicly accessible.

Acquia Content Hub will now try to register with the Content Hub service. If no errors display, the website has connected.

Filtering imports

To filter imports in the Acquia Content Hub service, you can configure Cloud Filters on your publishing website. Cloud Filters deploy to each registered webhook in your platform.

To enable Cloud Filters for your websites, see Managing Cloud Filters.

Processing the import queue

Acquia Content Hub requires Drush 9 or greater.

Acquia Content Hub subscribing websites rely on an import queue to add or update content on a subscribing website. Drush is the easiest and most reliable method to perform queued tasks. To process your import queue, use the following Drush command:

drush queue:run acquia_contenthub_subscriber_import

The command performs the following actions:

  • Processes entity groups sent by the Acquia Content Hub service
  • Determines any missing dependencies in the received content
  • Retrieves any missing dependencies

The import process repeats until all the data necessary to support the syndicated entities is present. The process reduces the number of imports and ensures future subscribing websites will receive both the content and configuration required to support the entities provided by your publishing website.