Important

You are browsing the documentation for version 1.6 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCRM Available in OroCommerce

Embedded Forms

In Oro application, embedded forms help create the code that may be added to a third-party website to enable communication between the third-party website users and the Oro application.

Embedded forms may be used to collect requests of marketing, technical, commercial or any other nature.

The fields of an embedded form depend on its type. The two out-of-the-box types of the embedded forms are:

  • Contact Request

    ../../../../../_images/cont_req.png
  • Magento Contact Us Request

    ../../../../../_images/cont_req_magento.png

Additional embedded form types may be created in the course of integration with the Oro application, subject to your specific business needs.

Create an Embedded Form

In order to create a new embedded form:

  1. Navigate to System > Integrations > Embedded Forms in the main menu.

  2. Click Create Embedded Form.

  3. Provide the following details:

    • Title — The title used to refer to the form in the system. The field must be defined.

    • Form Type — Choose one of the form types described above. Please note, that while the Magento Contact Us Request type is sharpened to suit the Magento design, you can choose the type regardless of the Channel chosen.

    • CSS — Editable CSS. The default CSS corresponds to the initial form design, subject to its type. You can edit the CSS to change such settings as the border width, color, fonts etc.

    • Success Message — The message to be displayed on the website following the successful form submission. By default is set to Form has been submitted successfully.

    • Allowed Domains — Allowed cross origin domains where the form can be embedded. Supports wildcard, e.g., X.example.com.

      ../../../../../_images/embedded_form_contact_us.png
  4. Click Save and Close.

    ../../../../../_images/emb_form_create_ex_02.png

Once saved, the form is displayed on the page of all embedded forms under System > Integrations > Embedded Forms.

../../../../../_images/emb_form_create_ex_01.png

You can view , edit , and delete contact requests using the corresponding action icons.

Add Embedded Forms to Your Site

To add the necessary embedded form to your website:

  1. Navigate to System > Integrations > Embedded Forms in the main menu.
  2. Click once on the form to open its details page.
  3. In the Get Code section, copy the provided code and paste it to the required section of your website.
../../../../../_images/emb_form_code.png