Settings

The settings page enables you to configure all of the global settings for WS Form. It is accessed from the WordPress admin menu.

The settings page is split into the following tabs:

Setup

This tab contains only one setting called ‘Mode.’ If you change this, WS Form will reset the settings to a ‘Basic’ or ‘Advanced’ configuration. If you are not a developer, we recommend keeping this setting on ‘Basic’. For developers we recommend the ‘Advanced’ setting.

System

The system tab provides a summary of your WS Form installation. It is split into the following sections:

  • WS Form Pro
  • WordPress
  • Web Server
  • SMTP
  • PHP
  • MySQL

If any issues are found with your WS Form installation, they are indicated in yellow with a warning triangle . We would recommend that you upgrade your hosting to meet the minimum versions stated in this tab.

License

This tab only appears if you have installed WS Form Pro and does not appear in the Basic version.

Version

This shows the current version of WS Form Pro you have installed. To see if you need to update WS Form, you should visit the Plugins page.

License Key

When you purchased WS Form Pro, you would have been given a license key. Enter it here and then click the ‘Activate’ button.

If you have lost your license key, click here.

License Status

The status of your license key is shown here. Once you activate it, the license status will read ‘Activated’.

Appearance

Framework

Framework

If you are unfamiliar with CSS frameworks, we recommend leaving this setting as is on WS Form.

For developers the framework option lets you select the framework you are working with. You can click the ‘Detect’ button to enable WS Form to attempt to detect which framework you are using, or you can manually select it from the list. If there is a particular framework you would like us to support, please contact us and we will add it to our consideration list. If you are using one of the frameworks we support, WS Form will output it from HTML using code and CSS classes that are appropriate to that framework.

Column Count

If you are unfamiliar with CSS frameworks, we recommend leaving this setting on 12.

If you are using a different column count from the default 12, you can change it here. We would normally recommend that this setting is left on 12 columns.

HTML Comments

You can switch HTML code comments on/off with this setting.

CSS Comments

You can switch CSS code comments on/off with this setting.

Admin

Enable Flexbox

We recommend leaving this setting on.

Enabling flexbox will lead to a better user-interface experience when using WS Form in WordPress.

Most recent browsers support flexbox. If, however, you are using an older browser that does not support flexbox, you can switch this off.

We always recommend upgrading to latest version of your favorite web browser.

Public

Framework CSS

This option will only appear if you have the WS Form framework selected. We recommend leaving this setting on.

The framework CSS is responsible for the layout of the form. It is not responsible for colors, fonts, etc.

If you want to completely customize the CSS used for your form, or you are using a different framework that already styles form elements, you can switch this off.

Skin CSS

This option will only appear if you have the WS Form framework selected. We recommend leaving this setting on.

The skin CSS is responsible for the fonts, colors, etc.,  of the form. It is not responsible for layout.

If you want to completely customize the CSS used for your form, or you are using a different framework that already styles form elements, you can switch this off.

Enable Flexbox

We recommend leaving this setting on.

Enabling flexbox will lead to a better user-interface experience when viewing forms on your website.

Most recent browsers support flexbox. If, however, your users are using older browsers that do not support flexbox, you can switch this off.

jQuery Date/Time Picker

This feature is available in WS Form PRO.

HTML 5 compliant web browsers have the ability to show a date and/or time picker when you click on a date field. Some web browsers do not have this ability. Therefore, to provide similar functionality WS Form PRO comes with a date and time picker that can provide similar functionality.

The options for this setting are:

  • If native not available – WS Form PRO will show the substitute date/time picker if the browser does not have its own.
  • On – WS Form PRO will always show the substitute date/time picker.
  • Off – WS Form PRO will never show the substitute date/time picker.

Advanced

Helpers

Debug Console

For more information about the debug console and this setting, click here.

Column Guidelines

Column guidelines help you identify columns when you are resizing sections or fields. This setting has 3 options:

  • Off – Guidelines are not shown
  • On resize – Guidelines are shown when you start to resize a section or field
  • Always – Guidelines are always shown
Breakpoint Widths

When this is checked, the form editor will adjust the form width to the appropriate breakpoint width selected at the bottom of the editor screen. This is useful to give you an idea of how the form might look at that device size.

Note that the Basic version does not allow breakpoint-specific editing. Upgrade to the Pro version to take advantage of this feature.

HTML Compatibility Helpers

This feature will show information icons that when clicked will take you to the caniuse.com website to show you the compatibility of a particular field or field attribute in various web browsers. This is useful for developers to determine whether to implement a particular field setting or not.

Help Text

If checked help text will appear under each setting in the right-hand sidebar as you edit your form.

Field IDs

If you are using the WS Form variables in your form development, this useful feature will show the field IDs in the sidebar when editing a field. It will also show the field ID when you hover over a field in the editor.

For more information about WS Form variables, click here.

API

Use X-HTTP-Method-Override for API Requests

We recommend leaving this setting on.

WS Form relies heavily on WordPress RESTful API calls back to your server.

Some web hosting providers do not support RESTful methods such as PUT or DELETE. By enabling this feature, all requests will be made via the POST method. If this is switched off, all API calls will be made using their native request method.

Cookies

Cookie Timeout (Seconds)

We recommend leaving this setting on 3600 seconds = 1 Hour.

Cookies are used if you introduce the form save feature in WS Form. The save feature enables users to save their form and then come back and complete it again later. In order to achieve this, cookies must be enabled in the user’s browser so that their session can be stored. The timeout period for a session is configured using this setting.

If you want to reduce or extend the duration the session cookie is valid for, adjust this setting. Some common values for this setting are:

  • 3600 = 1 Hour
  • 86400 = 1 Day
  • 604800 = 1 Week
Cookie Prefix

We recommend leaving this setting as ‘ws_form.’

To avoid conflicting with any other WordPress cookies, we prefix all cookies. This setting allows you to change this prefix if necessary.

Uploads

Maximum Filesize (Bytes)

We recommend leaving this setting to the value set by the plugin.

This setting dictates the maximum file-upload size allowed in bytes.

WS Form will set this value to the PHP setting on your server by default. If you want to reduce this value, you can set it here. Note that this value should not exceed the max_upload_size PHP setting.

Maximum Files

We recommend leaving this setting to the value set by the plugin.

This setting dictates how many files can be uploaded simultaneously.

WS Form will set this value to the PHP setting on your server by default. If you want to reduce this value, you can set it here. Note that this value should not exceed the max_uploads PHP setting.

Lookups

IP Lookup URL Mask

When someone submits a form and you have enabled the ‘Remote IP Address’ tracking option in Form settings, this feature will show a link that will link to a website showing the approximate location of that IP address, plus associated ownership information.

You can change the website that the IP address is sent to by adjusting this mask.

#value will be replaced with the tracking IP address.

For more information about form tracking, click here.

Latitude & Longitude Lookup URL Mask

Similar to the IP Lookup URL Mask, when geo-location tracking is activated, this feature will provide you with a link to a website showing the location of the user.

You can change the website that the latitude and longitude is sent to by adjusting this mask.

#value will be replaced with latitude,longitude.

Data

Delete Plugin Options on Uninstall

If checked the plugin settings will be deleted when you uninstall WS Form.

Delete Database Tables on Uninstall

If checked the database tables associated with WS Form will be dropped.

Email

Email Logo

You can upload your company logo or any other image you would like to add to emails sent from WS Form by uploading it here. We would recommend that you crop any whitespace from images and also keep images to no wider than 400 pixels wide and no taller than 200 pixels tall.

You can insert the logo you upload into an email by using #email_logo.

Note that it is also possible to insert your logo using the ‘Add Media’ button in the Visual editor when editing email content.

Email Logo Size

By default your logo will appear at the full size you uploaded it as. You can also choose one of the built-in WordPress image sizes to adjust the size of your logo.