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 Content Hub 1.x.
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:
- Sign in to your Acquia Content Hub publishing website as a user with the Administrator role.
- In the admin menu, click Extend.
Select the checkboxes 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.
- Click Install.
- In the admin menu, go to Configuration > Acquia Content Hub.
- 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.
- 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 allowlist the webhook URL path to be publicly accessible.
Acquia Content Hub tries to register with the Content Hub service. If no errors are displayed, 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 Platform Filters.
Processing the import queue
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 receive both the content and configuration required to support the entities provided by your publishing website.
Note
To delete items in the import queue, you can click Purge on the Import Queue page. This deletes all the items in acquia_contenthub_subscriber_import
.