Inquiry form for Liaison Inc.'s SpectrumEMP enrollment CRM
This WordPress plugin provides an inquiry form for prospective students. It uses the SpectrumEMP API to get the form parameters from Liaison, and submit the form data back to Liaison. It is based on example code from https://github.com/Liaison-Intl/EMP_API-Example
The plugin provides an option page in the WordPress admin, under the main Settings menu called Liaison Forms. Enter the API Key and Client ID provided by Liaison for the relevant account here.
Once the API Key and Client ID have been set, the inquiry form can be placed anywhere in the site by using the following shortcode:
[liaison_inquiry_form]
When the page or post is displayed, the shortcode will be replaced by the Liaison inquiry form. Prospective students can fill out the form and submit it directly from the WordPress site, and will be redirected to their personal URL on the Spectrum EMP site.
A mini-form can be created by adding a shortcode attribute named fields containing a comma delimited list of integer field ids. The field ids that are listed will appear in the shortened form.
- Any unlisted fields that are not required will be dropped from the form
- Any unlisted required fields with no preset values set in the shortcode will be included as hidden field with a default value (currently
mini-form) - Any unlisted required fields that have a preset value set in the shortcode will be included as a hidden field with the preset value
Preset values can be added to the shortcode by adding an attribute with the field id and value like this: 11="PN". Here 11 is the field id for the Country, and PN is a country code that will be used as the preset value.
Any other values can be set by including a shortcode attribute of the form field_id="preset value". As long as there is a valid field id, any field can be preset in this way regardless of whether the field is part of the inquiry form.
Liaison uses a special field called source that can track where a lead originated. It appears to be the only field in the Liaison forms that uses something other than an integer for the field id. The source can be set in a shortcode attribute like any other field like this: source="12345".
To maintain backwards compatibility and support multiple Liaison organizations, there is a "default" API Key and Client ID, which are set at the top of the settings page in the WordPress admin.
You can also enable multiple organizations by adding alternate credentials in the plugin settings. This allows you to use different API Keys and Client IDs for different forms or organizations. The alternate credentials can be added in the "Alternate Credentials" section of the settings page. Each alternate requires a unique Org Key, which is referenced in the shortcode.
If your site needs to support multiple Liaison organizations (Client IDs/API Keys), you can add alternate credentials in the plugin settings under Settings → Liaison Forms.
To use a specific organization's credentials, add the org attribute to your shortcode:
[liaison_inquiry_form org="org_key"]- Your_org_key is the identifier you set when adding alternate credentials in the admin.
- If org is omitted, the default credentials are used.
The plugin may be switched to dev mode. In this mode, no requests to the SpectrumEMP API will be sent. It is useful mostly for developers working on new features, but also for plugin users who want to try the plugin out prior obtaining Liaison API Keys.
To switch to dev mode, add the following to wp-config.php:
define('BU_LIAISON_INQUIRY_SAMPLE', true);By default, any submission of the form will be considered successful. To change this behavior, define one of following in wp-config.php:
| Constant Name | Description |
|---|---|
| define('BU_LIAISON_INQUIRY_POST_FAIL', true); | Some fields are invalid |
| define('BU_LIAISON_INQUIRY_POST_DUPLICATE', true); | Such email already exists |