Fork me on GitHub

Installing the External Resource Add-ons

This section assumes you are using Maven to manage your Hippo CMS project.

Add the Forge repository configuration

In the main pom.xml of the project, in the repositories section, add this repository if it is not configured there yet.

    <repository>
      <id>hippo-forge</id>
      <name>Bloomreach Forge Maven 2 repository.</name>
      <url>https://maven.onehippo.com/maven2-forge/</url>
    </repository>
        

Add version properties to the project pom

In the main pom.xml of the project, in the properties section, add this property. For the correct version number, check the Release Notes page.

  <forge.externalresource.version>version.number</forge.externalresource.version>
      

The CMS

Add the following dependencies to your CMS module's pom.xml file:

    <dependency>
      <groupId>org.onehippo.forge</groupId>
      <artifactId>externalresource-addon-frontend</artifactId>
      <version>${forge.externalresource.version}</version>
    </dependency>

    <dependency>
      <groupId>org.onehippo.forge</groupId>
      <artifactId>externalresource-addon-repository</artifactId>
      <version>${forge.externalresource.version}</version>
    </dependency>

    <dependency>
      <groupId>org.onehippo.forge</groupId>
      <artifactId>externalresource-addon-reports</artifactId>
      <version>${forge.externalresource.version}</version>
    </dependency>
                

Bootstrapping

When running a version 12 or later, make sure your project bootstraps after bloomreach-forge group. Typically, add it in file repository-data/application/src/main/resources/hcm-module.yaml:

  group:
    name: <your-group-name>
    after: [hippo-cms, bloomreach-forge]

The site

Add the following dependencies to your site module's pom.xml file:

    <dependency>
      <groupId>org.onehippo.forge</groupId>
      <artifactId>externalresource-hst</artifactId>
      <version>${forge.externalresource.version}</version>
    </dependency>