Add on a Conversation-Like User Interface for your web forms!
+ Front End Screen
The front end screen elements are described below.
+ Database Tables
Tables used are as follows:
A custom table *_convxns_forms stores the form fields submitted for the conversation.
A custom table *_convxns_followups stores the follow-up messages in each conversation.
General settings and form settings are stored in the standard *_options table.
Users are stored in the standard *_users table.
* refers to the tables prefix of your WordPress installation.
+ General Settings
Folder for screen templates for front end:
~/tempates/simple-html5 contains the template files which are in standard HTML5
~/templates/bootstrap contains similar files but with bootstrap 3.3 classes.
If you wish to use your own design, you can either edit these files, or create new files and change folder name accordingly.
+ Form Settings
Settings are required for each
typeof form you are using. For example, a setting for Contact-Us forms, a setting for Get-Quote forms, etc.
+ Specifying fields for a Contact7 form
If you are using a Contact7 Form follow the steps below.
+ Specifying fields for a Caldera form
If you are using a Caldera Form follow the steps below.
+ Specifying fields for a Ninja form
If you are using a Ninja Form follow the steps below.
+ Specifying fields for a WPForms form
If you are using a WPForm follow the steps below.
+ Specifying fields for a Gravity Forms form
If you are using Gravity Forms follow the steps below.
+ Configuring for other form plug-ins
If you are using some other form plug-in see the diagram below for explanation of how to incorporate it. Or, send us the name of the plugin, and we will send you an update in a few days.
+ Configuring custom PHP forms
If you are using a custom PHP forms follow the steps below.
For custom PHP forms, you simply call do_action( ) with two arguments as shown below.
+ User Roles
The wpcontactus plug-in creates 2 custom WordPress User Roles. They are wpcontactus-end-users and wpcontactus-responders.
The role 'wpcontactus-end-users' is assigned to a user who visits the website and fills up the form.
The role user wpcontactus-responders is assigned to a person from your company responds to with the end user.
+ Template Files
The folder ~/tempates/simple-html5 contains the template files which are in standard HTML5
The folder ~/templates/bootstrap contains similar files but with bootstrap 3.3 classes.
If you wish to use your own files, you can change the folder name in the General Settings screen.
Email templates are located in ~/tempates/simple-html5 and ~/templates/bootstrap.
+ How does it all work?
The plug-in indicates what 3rd party hook function to call when a form is submitted from the website.
So then when the form is submitted, the hooked function is called.
The plug-in extracts the fields required for the conversation from the form and calls the hook function tied to 'conversation_start'. This function is 'form_submitted'.
The form_submitted function records the fields for the conversation into a table in the database.
If you have written a custom PHP form, that is not using a 3rd party plug-in, simply call do_action('conversation_start', ... ) directly to record the fields of the form for the conversation, into the database.