Information for: DEVELOPERS   PARTNERS

Installing Content Hub for Drupal 8

Use the following instructions to install the Acquia Content Hub client modules:

Note about Acquia Lift support

Users of Acquia Lift with Acquia Content Hub 2.x must use Acquia Lift 8.x-4.1 or greater for full support of all features. Acquia Lift 4 users may use Acquia Content Hub 1.x, but multilingual content is not supported.

Requirements

As you prepare to use Acquia Content Hub with your website, ensure you plan for the following requirements:

Application Component
Drupal version Drupal 8.6 or greater
PHP Dependency manager Composer (installation instructions)
PHP version 7.0 or greater
Other Drush 9 or greater
Application Component
Drupal version Drupal 8.2 or greater
PHP Dependency manager Composer (installation instructions)
Keys After you purchase Acquia Content Hub, Acquia will email you a set of keys which are required to connect to the Acquia Content Hub content repository.
Other Acquia Content Hub assumes you are using clean URLs.

Obtaining your Acquia Content Hub credentials

The credentials for Acquia Lift include information from Acquia Lift, and your Acquia Content Hub hostname:

  1. Sign in to Acquia Lift.

  2. In the administrative menu, click Configure > Users > Content Hub Admin User.

    Acquia Content Hub will display the Access Key ID (your API Key) and Secret Access Key (your Secret Key).

  3. Your Acquia Content Hub hostname is based upon the region in which your website is hosted:

    Region Acquia Content Hub hostname
    Americas https://us-east-1.content-hub.acquia.com
    Europe, Middle East, and Africa https://eu-central-1.content-hub.acquia.com
    Asia-Pacific and Japan https://ap-southeast-2.content-hub.acquia.com

Installing Acquia Content Hub

Use the following steps to install the Acquia Content Hub client on your website:

  1. Clone the website repository locally (either manually or with Acquia Dev Desktop)

  2. From a command prompt window, go to the directory containing your main composer.json file.

    Note for Acquia Cloud users

    The main composer.json file is located in your website’s docroot directory.

  3. Run the following commands:

    composer require drupal/acquia_contenthub:^2
    

    Note

    If you receive an error Your requirements could not be resolved to an installable set of packages., ensure that zend-diactoros is is using the correct required version. See Drupal.org for more information.

  4. Sign in to your Drupal website as an administrator.

  5. In the Admin menu, click Extend.

  6. Select the check box next to Acquia Content Hub.

  7. Click Install.

  1. Clone the website repository locally (either manually or with Acquia Dev Desktop)

  2. From a command prompt window, go to the directory that contains your main composer.json file.

    Note for Acquia Cloud users

    The main composer.json file is located in your website’s docroot directory.

  3. Run the following commands:

    composer config repositories.drupal
    composer https://packages.drupal.org/8
    composer require drupal/acquia_contenthub:~1.0
    
  4. Commit the changes to your codebase.

  5. Sign in to your website as an administrator, and then click Extend in the admin menu.

  6. Select the following check boxes in the Acquia Content Hub section:

    • Acquia Content Hub
    • Acquia Content Hub Subscriber
  7. Click Install.

Your module should be ready to configure.