A lightweight version without Gentics CMS and Gentics Portal.

This solution includes the following components:

1. Gentics Mesh

2. ANDP Plugin

Here is the link to download the plugin: https://repo.gentics.com/repository/maven-releases/com/gentics/andp/mesh-acta-nova-plugin/<VERSION>/mesh-acta-nova-plugin-<VERSION>.jar (Replace <VERSION> with the desired ANDP version, e.g., 8.3.1 See Changelog (Link to changelog TBD))

Please send a request to servicedesk@jira-gentics.atlassian.net to download the ANDP Plugin (.jar file). Please place this JAR file directly in your Mesh instance in the folder /mesh-plugins.

3. Acta-Nova

Please ensure that an Acta-Nova instance already exists and is correctly connected to Mesh. To do this, the environment variable in Mesh MESH_PLUGIN_ACTA_NOVA_AN_BASE_URL must be adjusted to the URL of your Acta-Nova instance.

Integration

Proxy Configuration

Please ensure that the proxy configuration is correctly targeted at Mesh and Acta-Nova. A concrete configuration file, e.g., for an Apache Server, can look like this:

Configuration file for Apache Proxy: proxy.conf

<VirtualHost *:80>
  DocumentRoot /var/www/html
  SSLProxyEngine on
  ProxyPreserveHost Off

  # Acta Nova Instance
  ProxyPass /api/acta-nova <URL of your Acta Nova Instance>
  ProxyPassReverse /api/acta-nova <URL of your Acta Nova Instance>

  # Built JS and CSS files (in Mesh)
  ProxyPass /static/formgen/static <{Your Mesh Instance}/api/v2/andp/plugins/acta-nova/webroot/formgen/static>
  ProxyPassReverse /static/formgen/static <{Your Mesh Instance}/api/v2/andp/plugins/acta-nova/webroot/formgen/static>

  # Translations (Default URL is the URL for translations, change the source if you have another source)
  ProxyPass /static/translations <Default URL - {Your Mesh Instance}/api/v2/andp/plugins/acta-nova/webroot/formgen/static/translations>
  ProxyPassReverse /static/translations <Default URL - {Your Mesh Instance}/api/v2/andp/plugins/acta-nova/webroot/formgen/static/translations>
</VirtualHost>

Include Bootstrap (css + js)

We use Bootstrap version 5.3.

It is possible that the listed URLs have changed. Please verify this again for safety.

Embedding the React App

First, include the CSS resources that will be used for the React App.

  • /static/formgen/static/css/index.css

  • /static/formgen/static/css/style.css

Proxy configurations will redirect these two requests to Mesh.

Insert the React App (the following HTML snippet) at the location on the page where the form should be rendered.

<div id="root" tabindex="0" data-formID="<FormID>"
  style="max-width: max-content;" data-culture="de"
  data-translation-url="/static/translations">
  <script type="module" src="../../../static/formgen/static/js/index.js"></script>
</div>

Explanation of the HTML Snippet:

Please manually configure all parameters marked with <>.

  • data-formID: The ID of the form to be loaded.

  • data-translation-url: The translation source (Default /static/translations (see Proxy Configuration above)).

Translation Configuration

If you want to change the translation source, you must change the variable data-translation-url as described above. (For Wordpress integration, changing this variable is slightly different - Translation Configuration for Wordpress ).

Important: It is of great importance to ensure that the structure of the translation file system is set up as follows: For each language, a separate folder exists with the name of the language (e.g., de), containing a file named form.json. This file contains the actual translations, e.g., de/form.json.