Development Tools

The Essentials setup application provides a number of development tools that can speed up or even automate some common tasks when developing a Hippo CMS project:

They can be found on the Tools tab:

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/trails/getting-started-trail-10.0/essentials-tools.png

Selections

The Selections tool provides a configuration UI to add value list-based  Selection fields to existing  document types.

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/library/setup/10.0/essentials-tools-selection.png

For more information see the  Selections Plugin Configuration page.

Gallery Manager

The Gallery Manager allows you to configure custom image sets by entering the dimensions, labels and configuration properties for the different size variants through a form-based UI.

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/library/setup/11.0/gallery-manager-1.png

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/library/setup/11.0/gallery-manager-2.png

After creating or modifying an image set using the Gallery Manager, make sure to (re-)generate the corresponding content bean using the Beanwriter (see next section).

Beanwriter

The Beanwriter auto-generates content bean classes for all your content types. If the project contains multiple image set types, you can choose which one to use for the bean generation, and whether existing beans should be updated to use that image set type too:

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/library/setup/10.0/essentials-tools-beanwriter.png

After running the Beanwriter, all generated classes and methods will be listed in the setup application's feedback panel:

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/library/setup/10.0/essentials-tools-notification.png

You should now rebuild and redeploy your project in order to make the updated beans available.

REST Services Setup

The REST Services Setup tool provides an easy way to create basic RESTful services using Hippo CMS's JAX-RS support.

Content REST API

The generic Content RESP API can be enabled by checking Enable generic REST resources and specifying the URL at which the REST services will be available.

Custom Plain JAX-RS Services

The setup tool can also bootstrap you custom JAX-RS resources. Check Enable manual REST resources, specify the URL at which the REST services will be available, and select the document types in the project for which a service should be generated:

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/library/setup/10.2/essentials-tools-rest.png

The tool will generate the required HST configuration, Java classes and Spring configuration. The content bean classes in your project will be enriched so they can be used as JAXB models as well.

Although the generated services will work right away, they are meant as a starting point for further development and will most likely need to be customized and/or extended to meet your project requirements.

At this point only "plain" JAX-RS services are supported by the tool.