Written by The Jahia Team
   Estimated reading time:

Form Factory is an advanced forms builder and monitoring application that is integrated with Digital Experience Manager (DX). To install Form Factory and make it available to your websites, you:

  • Deploy the Form Factory - Enterprise Distribution package on your DX server
  • Enable the modules in the package for your websites
Note: You deploy the package and enable modules in DX.

Deploying the Form Factory package

You deploy the Form Factory - Enterprise Distribution package by adding the package's JAR file to DX. You can get the JAR file for the package by:

  • Searching for the package in the Administration page in DX.
  • Downloading the package from the Jahia AppStore. After downloading the package, you upload it in DX or copy it to the digital-factory-data/modules directory on your server.

The Form Factory - Enterprise Distribution package includes the required Form Factory Core module and additional optional modules. The optional modules extend or customize Form Factory. For example, the Form Factory prefill module provides prefilling of Form Factory fields from a user profile or its geolocation.

To deploy your module from DX:

  1. On the server on which DX is running, in Edit mode, choose Administration>System components>Modules.
  2. On the Modules page, click Available modules and enter Form Factory as search criteria in the search box.
    form-factory-module-search.png
  3. To view more information about the package, click the Form Factory - Enterprise Distribution package. Information includes:
    • A description of the module and its key features.
    • A list of the Form Factories modules included in the package. 
    • Changelog notes and a summary of install details.
  4. To start the modules automatically after downloading them, select Start modules automatically after download.
  5. Click the Download arrow 
    download-icon.png
     in the Download column for the Form Factory - Enterprise Distribution package. A message shows the modules that were uploaded and started.
    form-factory-modules-deployed.png
  6. Click Installed modules tab to view the status of the modules. Use the Search box to locate the module that you deployed, as shown in the following image. For each module, you can view the version number, whether the module is stopped or started, and whether the module has been enabled for any sites.
    ff-modules-install.png

You can stop a module by clicking the Stop button module-stop.png, and then start it using the Start button module-start.png or remove it from DX by stopping it and then clicking the Undeploy button module-undeploy.png.

Next, enable modules for specific websites.

Enabling your modules

After deploying the Form Factory - Enterprise Distribution package, you enable the modules included in the package for your sites. While only the Form Factory Core module is required, we recommend that you enable all modules in the package, unless you have a good reason for doing so. For more information on the modules, see Form Factory modules.

 

Note: You can also store form submissions in Elasticsearch by deploying and enabling the Form Factory Elasticsearch Storage module. For more information on configuring Elasticsearch storage, see Storing form submissions in Elasticsearch.

To enable modules:

  1. In DX, choose Administration>System components>Modules.
  2. On the Modules page, click Installed modules and enter search criteria to locate the module, as shown in the following example.
    ff-modules-install.png
  3. In the Status column, click on a Form Factory module. For example, click Form Factory Core.
  4. In Usage in sites, move the slider to Enabled for each site that you want to enable the module for.
    ff-enabled-for-sites.png

    In the following example, Form Factory is now available for the Digitall sample website.
    ff-enabled-digitall.png
  5. Enable additional modules as required.