Installation
Connections Business Directory extensions are WordPress plugins and their installation is the same process. To install the Contact 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 the Install Now button.
- Upon successful installation click Activate Plugin.
Important
License Activation
After you have successfully installed and activated this extension, you will need to activate your support license key in order to receive automatic updates.

First go to the Connections : Settings admin page and click the Licenses tab.

Enter the support license key that you received in your email receipt and click the Activate button. With your support license key activated, any time there is an update released, you will be notified in the WordPress admin with an opportunity to update to the latest version with a single click.
Configuration
Now that Contact is installed and activated, and the support license key is registered, let’s configure it.

Go to the Connections : Settings admin page and click the Display tab. Scroll to the Single Entry : Content Blocks section and enable the Email Entry option. You can optionally drag and drop the actions in the order you prefer.
Lastly, click the Save Changes button.
FAQs
How do I add a BCC recipient?
Add the following code to the Code Snippet plugin.
Change email@domain.tld and Your Name to the email address and name, you want to send the BCC.
add_filter(
'Connections_Directory/Contact/Email',
static function( $email ) {
$email->bcc( 'email@domain.tld', 'Your Name' );
return $email;
}
);
How do I change the “Email Entry” heading?
First, install the Say What? plugin.
After you install and activate the Say What? plugin, a new menu item will be added under the Tools admin menu named Text changes.
Navigate to the Tools : Text changes admin page and click the Add New button.
Enter the following settings:
- Original string:
Email Entry - Text domain:
connections_contact - Text context:
leave this field blank - Replacement string:
Email Me
Change the Email Me string to your desired text.
If you would like the “Email Entry” heading to be dynamic and display “Email Entry Name” where the “Entry Name” will be the name of the current directory entry, follow these steps.
- Install and activate the Code Snippets plugin.
- Download this zip file: code-snippet.zip
- Unzip the downloaded zip file.
- Import the file into Code Snippets.
- Activate the imported code snippet.
The Code Snippet will run the following code. Alternatively, by utilizing the Code Snippets plugin, you can add this code to the theme’s functions.php file or in a utility plugin.
add_filter(
'Connections_Directory/Content_Block/Heading',
static function( $heading, $key, $entry ) {
if ( 'email_entry' === $key ) {
$heading = "Email {$entry->getName()}";
}
return $heading;
},
10,
3
);
How do I display a link to the contact form?
Navigate to the Connections Settings admin page and click the Display tab. Scroll down to the Entry Actions section, enable the Email Entry, and save the changes.

When this option is enabled, a link to the contact form will be displayed at the top of the single-entry detail/profile page.

To display an “Email Entry” link in the result list view in place of the email addresses:
- Install and activate the Code Snippets plugin.
- Download this zip file: code-snippet.zip
- Unzip the downloaded zip file.
- Import the file into Code Snippets.
- Activate the imported code snippet.
Hooks
Actions
Connections_Directory/Contact/Email/BeforeConnections_Directory/Contact/Email/After
Filters
Connections_Directory/Contact/Email/From_NameConnections_Directory/Contact/Email/From_EmailConnections_Directory/Contact/Email/SubjectConnections_Directory/Contact/Email/Message
Examples
Example 1: Change the “from” email address from the default WordPress admin email address to the email address provided by the user sending the contact form submission.
add_filter(
'Connections_Directory/Contact/Email/From_Email',
static function( $fromEmail ) {
return sanitize_email( $_POST['email'] );;
}
);
Example 2: Override the user-supplied subject with a custom subject.
add_filter(
'Connections_Directory/Contact/Email/Subject',
static function( $subject ) {
$subject = 'Custom Override Email Subject';
return $subject;
}
);
Example 3: Prepend email subject with a custom message.
add_filter(
'Connections_Directory/Contact/Email/Subject',
static function( $subject ) {
$subject = 'From Website: ' . $subject;
return $subject;
}
);
Example 4: Append the email subject with a custom message.
add_filter(
'Connections_Directory/Contact/Email/Subject',
static function( $subject ) {
$subject = $subject . ' via Website';
return $subject;
}
);
Example 5: Add a BCC Recipient.
add_filter(
'Connections_Directory/Contact/Email',
static function( $email ) {
$email->bcc( 'email@domain.tld', 'Your Name' );
return $email;
}
);Example 6: Customize the “Email Entry” contact form heading using the directory entry name.
add_filter(
'Connections_Directory/Content_Block/Heading',
static function( $heading, $key, $entry ) {
if ( 'email_entry' === $key ) {
$heading = "Email {$entry->getName()}";
}
return $heading;
},
10,
3
);
