Using the setup application with Existing Hippo Projects - BloomReach Experience - Open Source CMS

This article covers a Hippo CMS version 10. There's an updated version available that covers our most recent release.

12-05-2015

Using the setup application with Existing Hippo Projects

The Hippo setup application is designed to work with Hippo projects using version 7.9 or later. While using the setup dashboard is the recommended way to set up a new Hippo project, you may be dealing with an older project that has been upgraded to CMS 7.9 or later.

This page provides some information on how you can take advantage of parts of the Hippo setup application even if your project has not been set up using the setup application.

Adding the setup application to your project

While it is possible to add the setup application to your existing 7.9 (or later) Hippo project, you should be warned that the project structure set up by the setup application may conflict with the already existing structure of your project. While adding the setup dashboard to your project may provide you with useful tooling, the setup application currently doesn't guarantee that all interactions with an existing Hippo project will work smoothly. If you decide to add the setup application to your existing Hippo project, make sure you use your VCS in order to detect and revert undesired changes to your project.

That said, here is a page describing the steps you'll have to take to add the setup dashboard to your existing Hippo project.

Using the generic HST Components

The Hippo setup application provides a set of generic, parameterized HST components. In order to make these HST components available to your upgraded Hippo project, include the following dependency in your site module’s pom.xml:

<dependency>
  <groupId>org.onehippo.cms7</groupId>
  <artifactId>hippo-essentials-components-hst</artifactId>
  <version>[SETUP APPLICATION VERSION]</version>
</dependency>
When your project depends on multiple artifacts of the setup application, consider managing the version using the dependencyManagement section.
Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?