The Hostinger Reach add-on lets you push new contacts from a WordPress form using a WS Form action. You can create new forms from your Hostinger Reach groups in a single click from the Add Form page.
Installation
The Hostinger Reach plugin is installed in the same way as installing the WS Form PRO plugin.
Once installed you will need to activate the license for the plugin. When you purchase the Hostinger Reach plugin, you will be given a license key. If you have lost your license key(s), click here.
To activate your license key:
- Click WS Form in the WordPress administration menu.
- Click Settings.
- Click the Hostinger Reach tab at the top of the page.
- Enter your license key.
- Click the Activate button.
If your license key fails to activate, please ensure you are using the correct license key and not your WS Form PRO license key.
Connecting to Hostinger Reach
In order to use the add-on, you need to connect it to Hostinger Reach. Connecting is easy!
- Click WS Form in the WordPress administration menu.
- Click Settings.
- Click the Hostinger Reach tab at the top of the page.
- Enter your API Token. If you don’t have an API token, create one and ensure you set Expiration to Never expires.
If you do not have a Hostinger account, you can create a new account here.
Creating a Form for Hostinger Reach
Automatically
WS Form can create a form for any of our Hostinger Reach lists in a single click. This process not only creates a form but also fully configures WS Form so that the form is ready to use immediately.
To create a Hostinger Reach form in WS Form:
- Click WS Form in the WordPress administration menu.
- Click Add New.
- Select the Hostinger Reach tab at the top of the page.
- Click on any of your Hostinger Reach groups to create a form.
- Wait a few moments while the form is created.
That’s it! Your form will be created and is ready to add to your website.
If your list does not appear, click the refresh icon in the Hostinger Reach tab.
Manually
It is also possible to use any form created in WS Form and add an action so that it is submitted to Hostinger Reach when a user saves or submits their form.
To add a Hostinger Reach action:
- When editing your form, click the Actions icon at the top of the page. The Actions sidebar will open on the right-hand side of the page.
- Click the Add icon to add a new action.
- Select Add to a Hostinger Reach List from the Action pulldown. A series of settings will appear.
As with all sidebars in WS Form, click to the Save button at the bottom to save your changes, or click Cancel to disregard your changes.
The Hostinger Reach action settings are as follows:
When Should This Action Run?
You can choose to run the Hostinger Reach action when the form is saved, submitted, or both.
Hostinger Reach Group
Choose the Hostinger Reach Group you would like contacts to be added to. If you have created a new group since viewing this screen, you can click the refresh icon to retrieve the new group.
Opt-In Field
Use this setting to select which of your fields to act as the opt-in field. We recommend adding a checkbox field with a single checkbox. It is always recommended that you have an unchecked opt-in checkbox on your forms to ensure you comply with GDPR requirements. If you choose an opt-in field and the user does not check it when submitting the form, this action will not run.
Status
Choose a status for the contact. Choose from:
- Subscribed
- Unsubscribed
Field Mapping
Field mapping tells WS Form which of your form fields relate to the corresponding custom fields in Hostinger Reach. For example you would want to map your Email field to the Email field in Hostinger Reach.
To map a field:
- Click the Add icon at the bottom right of the field mapping section.
- In the left-hand column, select your form field.
- In the right-hand column, select the corresponding Hostinger Reach field.
- Repeat this process for each field on your form.
- Click the Save button at the bottom of the sidebar to save your changes.
Note
Enter an optional note that will be added to the contact. You can use WS Form variables in this field. By default it is set to:
#blog_name: #form_label