{"id":8202,"date":"2023-09-18T12:28:00","date_gmt":"2023-09-18T11:28:00","guid":{"rendered":"https:\/\/help.cirrus-shield.com\/?post_type=docs&p=8202"},"modified":"2024-03-01T15:38:41","modified_gmt":"2024-03-01T14:38:41","slug":"wordpress-form","status":"publish","type":"docs","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/wordpress-form\/","title":{"rendered":"WordPress Form"},"content":{"rendered":"\n

With its WordPress plugin, Cirrus Shield allows you to put online forms integrated into your website that automatically create records in your CRM and notify you by email with each new submission<\/p>\n\n\n\n

The implementation of an online form goes through 7 steps:<\/p>\n\n\n\n

\n\n\n\n

1- Installing the Cirrus Shield plugin in WordPress<\/strong><\/p>\n\n\n\n

Start by downloading the Cirrus Shield plugin by clicking on the following button:<\/p>\n\n\n\n

Download the Cirrus Shield plugin for WordPress<\/a><\/p>\n\n\n\n

Then, log in to your WordPress site and click on the “Extensions” tab (1)<\/strong>, “Add” (2)<\/strong>, and then “Upload Extension” (3).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Upload the .zip file.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Install it (4)<\/strong> and activate it (5)<\/strong>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
\n\n\n\n

2- Connect to your Cirrus Shield environment.<\/strong><\/p>\n\n\n\n

Once the extension is installed, a “Cirrus Shield” tab (6)<\/strong> appears in WordPress.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Click on it and log in by entering your CRM username and password.<\/p>\n\n\n\n

Connecting to your CRM environment allows you to create forms tailored to your data model. Indeed, the forms will include the objects and fields present in your Cirrus Shield environment.<\/p>\n\n\n\n

\n\n\n\n

3- Form Creation<\/strong><\/p>\n\n\n\n

Let’s take, for example, the creation of a form that will allow your prospects to request a demonstration of your solution.<\/p>\n\n\n\n

To create a form, click on the “Add New Form” button (7).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Select the Cirrus Shield object that will receive the data from your form. In our case, the “Prospect” object (8).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The form creation interface includes the following elements:<\/p>\n\n\n\n

An HTML editor that allows you to directly modify the code (9).<\/strong>
An “Add New Field” menu to add new fields to your form (10).<\/strong>
A form preview to preview your modifications (11).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

To add a new field, simply select it from the “Add New Field” dropdown menu and click “Add to Form.” The field will be automatically added to your form (HTML editor).<\/strong><\/p>\n\n\n\n

Note that this dropdown menu does not contain calculated fields from Cirrus Shield (such as formulas, cumulative fields, and automatic number fields) as well as those that refer to another object (search relationship and multi-search relationship) (12).<\/strong><\/p>\n\n\n\n

The field labels present in the form are customizable. For example, you can rename the “Submit” button to “Envoyer” (13).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

You can make the field mandatory or insert a default value into the field (14 and 15).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

To change the order of the fields, select the field from the opening <p><\/strong><\/code> to the closing <\/p><\/strong><\/code>, and cut and paste it to the desired location (16).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Note on checkbox elements<\/strong><\/p>\n\n\n\n

You must ensure that you have a value [value=”1″] in the HTML code of a checkbox (input type=”checkbox”). Indeed, the value attribute is common to all input fields; however, this is used specially for input fields of type checkbox: when a form is submitted, only the checkboxes that are checked are sent to the server and the value sent is that of the value attribute. If the value attribute is not specified, the value “on” is sent by default, and this value is not accepted by Cirrus Shield, which expects value=1 for a checked box.<\/p>\n\n\n\n

Further down, you will also find other options to customize your form:<\/p>\n\n\n\n

Adding a compliance note (17);<\/strong>
Adding a Captcha (18);<\/strong>
Adding a link to the “Terms and Conditions” (19);<\/strong>
Customizing the theme with CSS code (20).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Click on “Save” to save the changes made.<\/p>\n\n\n\n

\n\n\n\n

4- Customization of the registration process<\/strong><\/p>\n\n\n\n

Once your form is created, you can configure the various steps of the registration process (21):<\/strong><\/p>\n\n\n\n

Email notification upon form submission;
Sending a confirmation email to registrants;
Enabling Double Opt-in, which sends a confirmation request email to the address provided in the form;
Redirecting registrants to a confirmation page after registration;<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Click on “Save” to save the changes made.<\/p>\n\n\n\n

Customization of the confirmation email (advanced settings)<\/strong><\/p>\n\n\n\n

The email templates are located in the subdirectory “inctemplatesconfirm”. Simply add your email template to this folder, you can use the default email template as an example to create your own.<\/p>\n\n\n\n

Once the files of your email template are added to this directory, you need to recreate the .zip file containing all the plugin files and upload this plugin into WordPress. If WordPress asks you if you want to overwrite the old version, you should accept and install the new version you have built.<\/p>\n\n\n\n

\n\n\n\n

5- Customization of registration messages<\/strong><\/p>\n\n\n\n

You can customize the registration messages of your form (22):<\/strong><\/p>\n\n\n\n

Validation message after submitting a form;
Error message;
Message when someone tries to submit a form a second time. This is checked if the submitter’s email already exists in the CRM.
Message when the email format is invalid.
Message when a mandatory field is not filled in.
Message present in the confirmation email sent back to the submitter.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Click on “Save” to save the changes made.<\/p>\n\n\n\n

\n\n\n\n

6- Adding the form to your WordPress page<\/strong><\/p>\n\n\n\n


Once the form is created and saved, to integrate it into a page on your WordPress site:<\/p>\n\n\n\n

Click on the “Back to form list” button (23).<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
    \n
  • Copy the “Shortcode” (24)<\/strong> located on the right side of your form.<\/li>\n<\/ul>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
      \n
    • Paste this “Shortcode” into your WordPress page within a block of type “Shortcode Widget” (25).<\/strong><\/li>\n<\/ul>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
        \n
      • Save your modification. The created form will appear in this section.<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n

        7- Submission and Error Logging<\/strong><\/p>\n\n\n\n

        The Cirrus Shield extension for WordPress logs all form submissions, API connection actions, as well as non-submitted forms. This logging can be useful to you, for example, in case of an issue with the extension.<\/p>\n\n\n\n

        To access the form submission history, click on the “Subscription List” button (26).<\/strong><\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        The displayed table contains:<\/p>\n\n\n\n

        The module and corresponding form that was submitted.
        The information submitted through the form along with the date and time of submission.
        The data sent by the form to the Cirrus Shield API.
        And the data received in return from the Cirrus Shield API.<\/p>\n\n\n\n

        To access the API connection history, click on the “Connection Log” button (27)<\/strong>. The page will display the history of all connections made with the Cirrus Shield API.<\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        It may sometimes happen that the submission of a form cannot reach Cirrus Shield. In this case, you have the following elements:<\/p>\n\n\n\n

        You can configure the message that will be displayed in this situation in the “Error Message” field (28).<\/strong><\/p>\n\n\n\n

        The extension will still send the form data to the email address specified in the “Email Address to Send Data from Unsended Forms” field.<\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n
          \n
        • You can access the history of data sent by the form but which could not reach Cirrus Shield for one reason or another. To do this, click on the “Unsubmitted Forms Log” button (29).<\/strong><\/li>\n<\/ul>\n\n\n\n
          \"\"<\/figure>\n\n\n\n

          Finally, the logout button allows you to disconnect the extension from Cirrus Shield (30).<\/strong><\/p>\n\n\n\n

          \"\"<\/figure>\n\n\n\n

          When your extension is disconnected, existing forms are still available on your site but will no longer send data to Cirrus Shield. However, you will continue to receive data from these forms via email at the address configured in the “Email Address to Send Data from Unsended Forms” field.<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":0,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"off","_et_pb_old_content":"","_et_gb_content_width":"","_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"doc_tag":[],"class_list":["post-8202","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/8202","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/comments?post=8202"}],"version-history":[{"count":17,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/8202\/revisions"}],"predecessor-version":[{"id":9929,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/8202\/revisions\/9929"}],"next":[{"title":"Developer Guide","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/developer-guide\/","href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/943"}],"prev":[{"title":"Guide Client","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/guide-client\/","href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/11618"}],"wp:attachment":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/media?parent=8202"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/doc_tag?post=8202"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}