Installation
Connections Business Directory extensions are WordPress plugins, and their installation is the same process. To install the Form extension, first download the zip file from your Purchase History page under the Downloads tab or from the download link provided in the sales confirmation receipt email, and then follow these steps:
- In the WordPress admin, under the Plugins menu, select Add New.
- Click the Upload link and the top of the page.
- Browse to where you downloaded the extension zip file and select it.
- Click Install Now.
- On a successful installation, click Activate Plugin.
Important
Support License Activation
To receive updates for the extension, you must activate your support license key.
- Navigate to the Connections : Settings admin page and click the Licenses tab.
- Enter the support license key that you received in your email receipt, and then click the Activate button. With your support license key activated, and when there is an update, you will be notified by the WordPress admin. Now you can update to the latest version when notified with a single click.
Add the Submit Entry Link
The last step is enabling the “Submit New Entry” action link so visitors can submit entries to your directory for moderation.
Go to the Connections : Settings admin page and click the Display tab. Scroll to the Result List Actions section and enable the “Submit New Entry” option. You can optionally drag and drop the actions in the order you prefer. Lastly, click the Save Changes button.
Tip
Settings
After you have enabled the Result List Action, go to the Connections : Settings admin page. All the settings related to Form can be found under the Form tab.
Require Login
To require your visitors to log in before being able to submit an entry into the directory, enable the Login Required option. You can optionally configure the message to be displayed to visitors asking them to log in.
Configuration
Entry Type
Connections supports entering multiple entry types. Form support the Individual and Organization entry types. By default, Form allows the user to choose between the two when submitting an entry. You can turn off this choice by disabling the Entry Type option.
Default Entry Type
If you permit the user to choose the entry type, you can set which type to be the default selection.
Fieldsets
All the available fieldsets are displayed by default for the user to enter their information. This section lets you decide which fieldsets to display and in what order.
Redirect After Submit
By default, when a user submits an entry, the page will display a processing message and a thank you message. If needed, you can optionally redirect to another page on your site. To enable the redirect, enable the Redirect option and then choose the page to which the user should be redirected.
Email Notifications
By default, the user and the admin will receive an email notification about the entry submission. You can use these settings to configure these email notifications.
Note
- The user will only receive a submission notification if they provide an email address.
- If you, as the admin, are logged in while testing submissions, you will not receive notifications.
FAQs
How can I change the upload file size limit by WP User Role?
Important
- Install and activate the WP Upload Restriction plugin.
- Configure the plugin according to its documentation.
How can I disable the styling?
Install the Code Snippets plugin, add a new code snippet with the following code, save, and activate the new code snippet.
add_action(
'wp_enqueue_scripts',
static function() {
wp_deregister_style( 'cn-form-public' );
},
99999
);
How can I make the email address field required?
The only required fields when submitting a directory entry are the name fields (first and last for an individual and organization name for a business). To make an email field required, follow these few steps.
First, install the Code Snippets plugin.
Add a new code snippet with the following code, or download, unzip the code-snippet.zip file, and import the code snippet JSON file into the Code Snippets plugin.
add_action(
'wp_head',
static function() {
$process = cnQuery::getVar( 'cn-process' );
$view = cnQuery::getVar( 'cn-view' );
if ( ! in_array( $view, array( 'detail', 'submit' ) ) ) {
if ( 'detail' === $view && 'edit' !== $process ) {
return;
}
if ( 'submit' !== $view ) {
return;
}
}
?>
<style type="text/css">
#cn-form .primary-email-address {
padding: 5px !important;
margin: 2px 4px !important;
font-size: 1.3em !important;
}
#cn-form .primary-email-address.error {
background-color: #FDE9EA;
outline: none;
border-color: #FDCED0;
box-shadow: 0 0 8px #CE0000;
}
</style>
<?php
},
11
);
add_action(
'wp_footer',
static function() {
$process = cnQuery::getVar( 'cn-process' );
$view = cnQuery::getVar( 'cn-view' );
if ( ! in_array( $view, array( 'detail', 'submit' ) ) ) {
if ( 'detail' === $view && 'edit' !== $process ) {
return;
}
if ( 'submit' !== $view ) {
return;
}
}
?>
<script>
selector = '#email-addresses input[type="text"]';
target = document.querySelector(selector);
target.classList.add('required');
target.classList.add('primary-email-address');
target.type = 'email';
target.required = true;
</script>
<?php
},
11
);
Save and activate the new code snippet.
Next, navigate to the Connections Settings admin page and click the Fieldset Configuration tab. Scroll to the Address Fieldset options, disable the Repeatable option, and set the The minimum number of address fieldsets to display. option to 1.
Now the email field will be required before a directory entry can be submitted.
Why aren’t my submissions showing up in the moderation queue?
If you are logged in, your submissions may be bypassing the moderation queue because of permissions assigned to your role. See the “Roles” screen in the Connections admin to set and change the permissions for each role.
Is there a way for user submitted entries to be automatically approved?
Yes and no. If the user is an unregistered visitor to your website, their submission will be held in the moderation queue. However, if a user is a registered user on your website, logged in and they have been assigned a role, “Subscriber” by default, you can use the Connections : Roles admin page to give that role the permission to submit entries that do not require moderation.
Where do I find entries that have been submitted?
All user submitted entries are held in the “Moderate” queue. The moderate queue can be found on the Connections : Manage admin page. You can view the queue by clicking the “Moderate” link towards the upper left corner of the page.
Are entries automatically added to my directory?
No, all entries must be approved before they will show up in the directory.
Will this allow users to edit their own details?
No, this form is for users to submit new entries only. In order to enable this feature, you need the Link extension.
Plugin Conflicts
Easing Slider
http://wordpress.org/extend/plugins/easing-slider/
When this plugin is installed and activated the page Form is embedded on will refresh when the user clicks “Submit” instead of the form submission occurring via AJAX as it should which means the submission is never sent for moderation. A possible cause is that, by default, it loads an older version of jQuery instead of the current version bundled with WordPress. There is an option within Easing Slider to disable the loading of its version of jQuery. Please try this option to see if Form functions as expected.
NOTE: This FAQ was written based on Easing Slider 1.2.1
Nmedia Users File Uploader
http://wordpress.org/extend/plugins/nmedia-user-file-uploader/
This plugin hides the form submission button.
NOTE: This FAQ was written based on Nmedia Users File Uploader Plugin 2.1 / Pro 7.3