Bloomreach Experience Manager v15 Tutorial: Build a Website

This tutorial will guide you through the development of GoGreen, brXM's demo website. The tutorial follows two development iterations. In each iteration, you will deliver a working site and increase your brXM knowledge level at the same time. At the end of the tutorial, you will have a good idea of the basic development tasks involved in the implementation of a brXM-based website.

Full tutorial:

https://documentation.bloomreach.com/trails/developer-trail/introduction.html

The tutorial describes two project iterations:

1. Select Out-of-the-Box Features
2. Develop New Features

The result of each project iteration is available from the corresponding branch:

1. iteration-1
2. iteration-2

Running locally

This project uses the Maven Cargo plugin to run Essentials, the CMS and site locally in Tomcat. From the project root folder, execute:

mvn clean verify
mvn -P cargo.run

Access the applications at the following URLs:

• Essentials: http://localhost:8080/essentials
• CMS: http://localhost:8080/cms
• Website: http://localhost:8080/site

Logs are located in target/tomcat9x/logs.

Best Practice for development

Use the option -Drepo.path=/some/path/to/repository during start up. This will avoid your repository to be cleared when you do a mvn clean.

For example start your project with:

mvn -P cargo.run -Drepo.path=/home/usr/tmp/repo

Automatic Export

Automatic export of repository changes to the file system is turned on by default. To control this behavior, log into http://localhost:8080/cms/console and press the "Enable/Disable Auto Export" button at the top right. To set this as the default for your project edit the file ./repository-data/application/src/main/resources/hcm-config/configuration/modules/autoexport-module.yaml