How to integrate forms into Umbraco CMS

For integration into the Sitecore CMS, we created a small integration package. With this package a new Data Type will be installed, which provides a form chooser on your Document Type.

You can download the package in the Umbraco package browser or directly.

Install Umbraco package 'FlyingForms.Umbraco'

Install Umbraco package - Step 1

AAt first you need to download and install the FlyingForms.Umbraco package. The installation can be done with the standard Umbraco package installer.

After installing the package, there are a few steps that needs to be configured.

Setup the FlyingForms.config file

Configure Umbraco package

By default is an example config file placed at /config/FlyingForms/flyingforms.config.example. This file needs to be renamed to FlyingForms.config to get the connection to you FlyingForms project working.

There are three settings needed: 'FlyingForms.ProjectName', 'FlyingForms.ProjectId' and 'FlyingForms.Token'. The ProjectName is the name of your project subdomain, eg. when your subdomain is 'my.flyingforms.io' then you need to set the 'my' to the ProjectName. The project id and the token is given by the Api Access Point that is configured in your project settings.

Setup Rendering in View

Setup Rendering Step 1

FlyingForms.Umbraco provides a new rendering 'FlyingFormsForm'. This must be added to you existing rendering for your Document Type..

The model must be the 'Form' field from the Document Type. You can choose a name freely.

Add Data Type to Document Type

Data Type in Document Type

The Data Type must be added to corresponding rendering and Document Type. Choose 'FlyingForms Form' Data Type by adding the new field.

Module settings"

Module Settings

After creating your first module you can set the settings for this module. The main part is choosing the Form from the dropdown. The dropdown is filled automatically with your forms from your FlyingForms project.

Optional settings are the checkboxes 'Apply Stylesheet' and 'Render Approved in Preview'. When 'Apply Stylesheet' is enabled, the stylesheet that is configured in FlyingForms will be used. Otherwise the markup will be rendered without styling. This is helpful when your site has already a stylesheet for forms. In some cases you want to see the approved version of your form in the preview in Sitecore, then you can enabled the checkbox 'Render Approved in Preview'. Otherwise the latest non-approved version will be rendered. At published version, the latest approved version will be rendered.

Done

Render form

When all steps are done, the form will be rendered. :)

Articles and Links that could be important for you:

Erstelle einen Api Access Point Projekte Plugins