Link

Installation

Connections Business Directory extensions are WordPress plugins, and their installation is the same process. To install the Link 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:

1. In the WordPress admin, under the Plugins menu, select Add New.

2. Click the Upload link and the top of the page.

3. Browse to where you downloaded the extension zip file and select it.

4. Click Install Now.
5. Upon successful installation, click Activate Plugin.

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 then 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

You need to give your user roles add/edit entry capabilities. How do you do this? Go to the Connections : Roles admin page. There you will find boxes, one for each role available on your site. Under each role is a list of all the capabilities available for Connections. Decide if you want your users to add and edit with or without moderation. Have you decided? Good.

• To allow users to add and edit without moderation check the boxes for Add Entry and Edit Entry and then click the Update button.
• To allow users to add and edit with moderation check the boxes for Add Entry Moderated and Edit Entry Moderated and then click the Update button.

Do this for each of the roles that you want to allow adding and editing.

The last step is to enable the “View My Directory Entry” action link and “Edit my Directory Entry” entry action.

Go to the Connections : Settings admin page and click the Display tab. Scroll down to the Result List Actions section and enable the “View My Directory Entry” option. You can optionally drag and drop the actions in the order you prefer.

• NOTE: If a user does not yet have an entry in the directory, they will instead see an “Add My Directory Entry” link.

Scroll down to the Entry Actions section and enable the “Edit My Directory Entry” action link. You can optionally drag and drop the actions in the order you prefer.

Lastly, click the Save Changes button.

Tools

Bulk Link

This tool can be used to link your existing WP Users to your existing Connections Entries. It is not required to run this tool as your WP Users will be linked when they login to your site automagically.

It is safe to run this tool at any time as it will only check existing WP Users who have not been linked to a Connections Entry when processing links.

Bulk Unlink

This tool can be run to unlink all WP Users. It can be useful to run after testing, and you want to reset it before deploying your site.

Shortcodes

View or Add User Entry Link

[connections_link_view]

Use this shortcode to add the “View My Directory Entry” in your pages or posts, anywhere shortcodes are supported. If the user has not been linked to an entry, it will instead display the “Add My Directory Entry” link.

This shortcode has the following two options:

• text_add :: Use this option to change the link text from the default of “Add My Directory Entry”
• text_view :: Use this option to change the link text from the default of “View My Directory Entry”

Examples of how to use this shortcode:

// Example 1: Change only the "View My Directory Entry" link text.
[connections_link_view text_view="View My Entry"]

// Example 2: Change only the "Add My Directory Entry" link text.
[connections_link_view text_add="Add My Entry"]

// Example 3: Change both link text.
[connections_link_view text_add="Add My Entry" text_view="View My Entry"]

Edit User Entry Link

[connections_link_edit]

This shortcode can be used to display the “Edit My Directory Entry” link on your pages, posts, anywhere shortcodes are supported. If the user has not been linked to an entry, it will not be displayed.

This shortcode has one option to configure the link text.

• text :: Use this option to change the link text from the default of”Edit My Directory Entry”

Here’s an example:

[connections_link_edit text="Edit My Entry"]

FAQs

Can I add the View/Add and Edit links to my menu?

• %entry_view_url% :: This is the URL token you will use to add the “View My Directory Entry” / “Add My Directory Entry”  link to your menu. This token will be replaced with the URL for viewing the user’s linked entry. If the user has not been linked to an entry the token will be replaced with the URL for the user to add their entry to the directory.
• %entry_edit_url% :: This is the URL token you will use to add the “Edit My Directory Entry” link to you menu. This token will be replaced with the URL for editing the user’s linked entry. If the user has not been linked to an entry the menu item will not be displayed.

"View My Directory Entry" / "Add My Directory Entry"

"Edit My Directory Entry"

How can I allow Linked Users to upload files to the Media Library?

1. Install and activate the User Role Editor plugin.
2. Editor the Role Capabilities each role you wish to allow Media Library access. Add the `upload_files` capability to each role.
3. Install and activate the Code Snippets plugin.
4. Download this zip file: code-snippet.zip
5. Unzip the downloaded file.
6. Import the unzipped file into the Code Snippets plugin and then activate the imported Code Snippet.

After the above steps are followed, the Media Library button for the Bio and Notes fields will be accessible to logged in WP Users editing their linked Connections Entry.

How can I change the upload file size limit by WP User Role?

1. Install and activate the WP Upload Restriction plugin.
2. Configure the plugin according to its documentation.

Why is Link not linking the user and entry?

The entry should be in Connections prior to the user logging in. Otherwise, the user should use the “Edit My Directory Entry” admin page added by Link to add their entry. This is the intended workflow.

What trips people up in testing is that links are checked for only once and they are persistent. Link will check once when the user logs in and if no email address match is found, that user is not checked for a match again no matter how often you change the email address in the user or Connections entry. The reason links are persistent is that users change email addresses fairly often; you wouldn’t want a link to break because of an email address change in either the user profile of the entry. You also wouldn’t want it easy to hijack the links.

Because links are persistent, they are also difficult to break. If you need to for any reason, you have to delete both the user and the their entry in Connections and re-add both.

I hope that makes sense!

This is the suggested testing methodology:

Create a new entry in Connections with an email address.
Create a new user in WordPress with the same email address.
Log out of WordPress.
Login as the new user.
Go to the Edit My Directory Entry admin page.
The user should now be linked to the Connections entry.

If a link is not being created perhaps you are using a membership type plugin. If you are, it is possible it is hijacking the login process before Link has the opportunity to run. If that is the case, please contact support.

I’ve installed Link, but how do users add or edit their entry?

There are two places in the admin where they can find the form to add or edit their entry.

The first is under the the user’s “Profile” page, Link adds a new sub-page called, “Your Directory Entry”. This will be right under the “Your Profile” admin page.

The second place can be found under the “Howdy, Some User” menu on the top right of all admin pages. It’ll be the link named “Edit My Directory Entry”. Both of these links go to the same admin page for Link where the user can add and edit their entry.

QuickTip: Do you require that you users add and edit their entries in the front-end? Checkout Form. Link and Form have been designed to provide a seamless easy to use experience.

NOTE: It’s important to point out that even though this looks like the same form as found under the Connections : Add Entry admin page, it is actually a completely different admin page. Typically users will not be able to see or access the main Connections admin pages unless you’ve setup their role to grant them capabilities which give them access. The “Why are my users receiving the “You are not authorized to edit entries.” error?” FAQ has more details on how to setup your user roles with the correct capabilities for Link.

Why are my users receiving the “You are not authorized to edit entries.” error?

If your users are receiving this error it is because the role they have been assigned does not have add or edit entry capabilities for Connections. Huh? What did you just say? Let me explain. Every registered user is assigned a user role. These roles define what a user is permitted to do and not do once they are logged in. By default all users are a “Subscriber”. Ok, so how do I give my “Subscribers” the add/edit capability? This is really easy. Go to the Connections : Roles admin page, there you will find all the roles that are available and under each a list of every capability that is available for Connections. The capabilities you’re interesting in are two pairs of options; “Add Entry” / “Edit Entry” and “Add Entry Moderated” / “Edit Entry Moderated”. If you check “Add Entry” and “Edit Entry”, the users assigned to the “Subscriber” role will be able to add and edit their entry for Connections without admin moderation. Similarly, if you check “Add Entry Moderated” / “Edit Entry Moderated”, the users assigned to the “Subscriber” role will be able to add and edit their entry for Connections with admin moderation. While you here, make sure to add the add and edit capabilities the other user roles. Once you set the options, don’t forget to save them by clicking the “Update” button. That’s it, your users will not longer receive that nasty error message and they’ll be able to add and edit their own entry. Easy, right?

Can I edit which user is linked to which entry?

Sorry, no, because Link was designed to work as silently in the background. It is possible this functionality will be added based on user feedback.

I already have users, how do they get linked?

Link has a feature called “Link on Login”. What does this do? As your registered users log in Link will search the Connections entries for their email address, if one is found, that entry is automatically linked.

Plugin Conflicts

WishList Member

When using Link with WishList Member logged in users will not be able to add or update their entries. This is because of this code found in the wpm.php file:

// Do not allow access to Dashboard for non-admins
if ($wpm_current_user->ID && basename(dirname($_SERVER['PHP_SELF'])) . '/' . basename($_SERVER['PHP_SELF']) == 'wp-admin/index.php' && !(current_user_can('edit_post') || current_user_can('edit_posts')) && !current_user_can('level_8')) {
    header('Location:profile.php');
    exit;
}

Basically what this code does is if the logged in user is not an admin user, the page is redirected the admin User Profile page. This redirect occurs before Connections admin add/edit functions have an opportunity to run. The fix for this is to reprioritize the the Connections admin add/edit code to run sooner, before the redirect in WishList Member. Here’s how.

Install the Code Snippets plugin and add a new snippet with the following code:

function cn_wishlist_link_compatibility_snippet() {
 
  if ( ! current_user_can('edit_posts') ) {
 
	remove_action( 'admin_init', array( 'cnAdminFunction', 'init' ) );
  	add_action( 'init', array( 'cnAdminFunction', 'init' ), 9.9 );
  }
}
add_action( 'plugins_loaded', 'cn_wishlist_link_compatibility_snippet' );

Save and Activate the new snippet. Your users should now be able to add and update their entries.

NOTE: This FAQ was written based on WishList Member 2.80.2947

s2Member

This plugin will “wipe” or “reset” the custom role and capabilities of plugins such as Connections, Easy Digital Downloads and Events Manager add on each update that is released for it. So if you receive the this error “You do not have sufficient privileges to access this page.” and have s2Member installed, here’s how to fix it.

Since custom roles in WordPress are persistent so Connections sets a “flag” in the options that if it exists will not attempt to recreate them which would reset them. Once this flag is set, there is no point and click way to force reset the Connections custom roles. Not even deactivating and deleting will reset this “flag”. With that said, there is a solution.

Install the Code Snippets plugin:

https://wordpress.org/plugins/code-snippets/

Create new snippet.

Add the following code to the new snippet:

add_action( 'init', 'cn_reset_role_capabilities' );
 
function cn_reset_role_capabilities() {
 
    if ( ! is_admin() ) return;
 
    // Class used for managing role capabilities.
    if ( ! class_exists( 'cnRole' ) ) require_once CN_PATH . 'includes/admin/class.capabilities.php';
 
    cnRole::reset();
}

Save and activate the snippet.

You should now be able to view all of Connections admin page.

! Important ! Deactivate the snippet.

Read more:

• http://connections-pro.com/support/topic/role-settings-disappear/#post-304801
• https://wordpress.org/support/topic/resetting-roles-every-time

Pie Register

Registration Forms – User Registration Forms, Invitation-Based Registrations, Front-end User Profile, Login Form & Content Restriction

The Pie Register plugin is calling a core WordPress action, wp_login on login which Link hooks into but it is not passing both of the required parameters so when other plugin such as Link hook into it, it will fail with errors. This is a bug with Pie register.

Here are the lines of code that contain the bug:

1. https://plugins.trac.wordpress.org/browser/pie-register/tags/2.0.14/pie-register.php#L972
2. https://plugins.trac.wordpress.org/browser/pie-register/tags/2.0.14/pie-register.php#L1007
3. https://plugins.trac.wordpress.org/browser/pie-register/tags/2.0.14/pie-register.php#L1020

Pie register should either not call the wp_login action hook at all or they should pass the $user object as a second variable like so:

do_action( 'wp_login', $user->user_login, $user );

The only fix right now .. You’d have to edit that file, all three instances, to either remove the call or add the second variable. The safest solution is the latter because it might be possible that “Pie Register” may run in a way the core WordPress action wp_login is never run and it needs to run for Link and any other plugin that may rely on it.

UPDATE: From the plugin developer please see this: https://wordpress.org/support/topic/wp_login-second-parameter-missing

NOTE: This FAQ was written based on Pie Register 2.0.14

CalPress

http://wordpress.org/plugins/calpress-event-calendar/

When this plugin is active Link fails to link a user to an entry. The reason is the plugin removes the wp_login action that is required to trigger the linking.

There is a fix, but it requires editing the plugin. The instructions follow:

Open this file and go to line 639:

\calpress-pro\app\controller\class-calp-app-controller.php

You’ll find this:

// s2Member login fix
remove_all_actions('wp_login');

This just might fix an issue with S2member, but it also will remove the action Link requires to run on the wp_login hook.

If you do not have s2member installed, try commenting it out like so:

// s2Member login fix
// remove_all_actions('wp_login');

NOTE: This FAQ was written based on CalPress 1.5.0.1

Theme Conflicts

Penny Auction

There is a bug with its custom login that can cause third party plugins such as Link to fail. The bug is in the login.php file found here: ../PennyTheme/lib/login_register/login.php.

On line 385 the theme is calling the wp_login WordPress action, but the action is not passing the $user object which will cause Link to fail as it requires that object. This will break any third party plugin that relies on that object calling this action.

I fixed the file by changing this:

do_action('wp_login', $user_login);

To this:

do_action('wp_login', $user_login, $user);

That should fix it.

NOTE: This FAQ written based on Penny Auction Theme 1.2.4 by SiteMile.