Initial Set-Up

1. Install the plugin on each website that you want to search users on.
2. In your admin area of each website, navigate to Users > Cross-Site Search.
3. Enter your License ID and save changes.
4. Generate a new Secret Key and click the "Copy Secret Key" button (DO NOT SHARE THIS WITH OTHER PEOPLE).
5. Go to your other websites that you want to share with.
6. Where it says, "Your Other Sites' Secret Keys," paste the Secret Key including the domain name in parenthesis.
7. That's it for set-up.

Settings

Navigate to Users > Cross-Site Search and click on the Settings tab.

• License ID: Enter your license ID.
• This Site's Secret Key: This key should remain private only to you; it is used to give access to your other sites so they can search this site's users.
• Disable Sharing with Other Sites: This will pause allowing your other sites from being able to search this site's users. It completely disables the custom API we use so the site cannot be accessed.
• Your Other Sites' Secret Keys: This is where you will include your other sites' secret keys including the domain names (exactly as shown in the secret key box above). If you have multiple sites you want to search, add the keys on separate lines.
• Meta Keys to Omit: Enter meta keys on separate lines that you would like to omit when viewing user details in the comparison table. Use wildcards (*) to omit keys that match a pattern. For example, entering user_* will omit all keys that start with user_, and *_key will omit keys that end with _key. This does not omit keys from being shared with other sites; it is only for what you don't want to see in this site's search results.

Searching Users

Navigate to Users > Cross-Site Search and click on the Search tab.

Underneath the search bar, you should see checkboxes for "local" (which is the current site) along with all of the sites that you have correctly added to the Settings tab. You can deselect any sites that you do not want to search.

Enter an email address or name in the search box and hit "Search". Results will appear below.

Viewing Details & Comparing Results

From the results section, select the users you want to view details for. Their details will appear in a comparison table on the right. All WP User object meta and custom user meta will be included, excluding any meta keys that you omitted in settings.

Quick Fetch Admins

Clicking on the "Quick Fetch Admins" button will fetch all users with the administrator role across all of your connected websites. This allows you to quickly see if there are any admins that need to be updated without having to go to all of your sites one by one.

Editing User Data

For security purposes, the plugin does not allow for editing remotely. Instead, an "Edit" link is included on the search results that will take you to the user's profile on the other site, so long as you are logged in on the other site.

Troubleshooting

Error: Cannot connect to site.

Possible Reasons	Solutions
You did not copy and paste the Secret Key and domain name correctly.	Go to the remote site and click on the "Copy Secret Key" button, and then come back to the site you are seeing the error on and paste it into the Settings under "Your Other Sites' Secret Keys." The Secret Keys you paste into this field must include the domain name in parenthesis. If you have multiple keys to add, separate them on different lines.
The Secret Key on the remote site has been changed.	Update the Secret Key on the site you are seeing the error on.
You have disabled sharing on the remote site in Settings.	Re-enable sharing by deselecting the "Disable Sharing with Other Sites" option on the remote site.
Your domain name has changed.	Regenerate a new Secret Key on the remote site and update the one on the site you are seeing the error on.
Your site has a firewall or other security measures in place to prevent outside access.	Check your site's firewall settings (either from a plugin, your host, or customizations on your .htaccess file. You may be able to whitelist the custom APIs located at /wp-json/cross-site-user-search/v1/.