Global 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:

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.

Preview

Template

You can use setting to tell WS Form which page template to use when previewing a form. If set to auto, WS Form will automatically find a template to use. If a template cannot be found, WS Form will use a basic fallback template.

Public

Framework CSS

This setting 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 setting 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.

Minify CSS

This setting will only appear if you have the WS Form framework selected. In a production environment we recommend switching this setting on.

When enabled, WS Form will minify its own CSS to improve page load speed times.

Inline CSS

This setting will only appear if you have the WS Form framework selected. In a production environment we recommend switching this setting on.

When enabled, WS Form will output its own CSS in the head tags of the web pages to improve page load speed times.

CSS Cache Duration
If CSS files are not being rendered inline, this will determine the expiry header duration in seconds.
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.

Advanced

Helpers

Debug Console

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

Live Preview

If this setting is enabled, any changed you make to a form will be refreshed in the preview window automatically.

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.

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.

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.

Statistics

Disable Statistics

If this setting is enable, WS Form will stop collecting data on form views, submissions and saves.

Disable Unread Submission Bubbles

If this setting is enabled, submission count bubbles will no longer be shown in the administration pages.

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.

File 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.

Tracking 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.

Geolocation 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.

Javascript

Enqueue in Footer

If this setting is enabled, all scripts associated with WS Form will be enqueued in the footer of the website.

jQuery Source

This setting enables you to determine whether jQuery scripts are loaded from your server (Local) or from a CDN.

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.

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.

E-Commerce (PRO only)

If you have WooCommerce installed, these settings will be inherit from WooCommerce.

Prices

Currency

Select the current you would like to use for prices on your forms.

Currency Position

This setting determines if the currency symbol should be placed to the left or right of prices.

Thousand Separator

Use this setting to configure which character is used to separate thousands in prices.

Decimal Separator

Use this setting to configure which character is used to separate decimals in prices.

Number of Decimals

Use this setting to configure how many decimals should be used in pricing.

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. Learn more about licensing.

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 purchase WS Form Pro, you are emailed 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’.

Data

Data Encryption

See Data Encryption.

Uninstall

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

Logo
Image

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.

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.

#email_submission

Use these settings to control the format of the #email_submission variable.