Wheremore Wordpress Plugin

Wheremore Sync connects a WordPress website to Wheremore so approved link changes can be applied from Link Management.


Overview

The plugin provides a secure connection between one WordPress website and its matching website record in Wheremore.


Once connected, Wheremore can send approved instructions to:


  • Insert a link into supported WordPress content
  • Update a previously managed link
  • Remove a previously managed link
  • Confirm the outcome of the instruction
  • Read a protected content snapshot when required for link handling

The plugin does not give Wheremore unrestricted access to WordPress. It accepts authenticated link-sync requests for the connected site and applies them through supported content editors.


Installing the plugin does not add links by itself. A user must create or approve a link in Wheremore before an instruction is queued.


Requirements

Before installing, confirm that:


  • The website runs WordPress 6.0 or later.
  • The server runs PHP 8.0 or later.
  • The public website uses HTTPS.
  • You have a WordPress administrator account.
  • The same website has already been added to a Wheremore workspace you can access.
  • You can create or obtain a Wheremore API key for that website.
  • WordPress REST API requests are not disabled.

Create a backup before installing or updating any plugin on a production website.


Supported editors

Wheremore Sync includes settings for:


  • Gutenberg and the Classic Editor
  • Elementor
  • Bricks

Keep Editor Detection set to Auto-detect unless link placement fails or Wheremore Support asks you to choose an editor manually.


Themes, custom fields, reusable components and third-party widgets can store content outside the normal editable fields. Test the connection on a non-critical page before using automatic sync widely.


Download the plugin

Download the current Wheremore Sync ZIP file from the installation area supplied by Wheremore.


Do not unzip the package before uploading it through WordPress. Keep the ZIP in a secure location and use only a package supplied through an official Wheremore source.


Install Wheremore Sync

  1. Sign in to WordPress as an administrator.
  2. Open Plugins → Add New Plugin.
  3. Select Upload Plugin.
  4. Choose the Wheremore Sync ZIP file.
  5. Select Install Now.
  6. When installation finishes, select Activate Plugin.

After activation, open wheremore in the WordPress administration menu.


If an earlier version is already installed, use the normal WordPress update when offered. If you are uploading a replacement ZIP manually, allow WordPress to replace the existing version. Do not uninstall the connected plugin merely to perform a normal update.


Create or obtain an API key

The plugin connects using a Wheremore API key.


  1. Sign in to Wheremore.
  2. Select the workspace containing the website.
  3. Open the API Keys area at Wheremore → API Keys.
  4. Create or copy an active key that has access to the website.

Treat the API key like a password:


  • Do not include it in screenshots, support tickets or shared documents.
  • Do not send it by email or chat.
  • Store it only in the plugin connection field.
  • Revoke and replace it if you think it has been exposed.

The website domain in WordPress must match a website available to the API key in Wheremore. Add the website in Wheremore before trying to connect.


Connect WordPress to Wheremore

  1. In WordPress, open wheremore → Settings.
  2. Confirm that the displayed Site URL is the website you intend to connect.
  3. Paste the API key into API Key.
  4. Select Connect to wheremore.
  5. Wait for the success message.

The connection section should show Connected to wheremore.


During connection, Wheremore validates the API key, matches the WordPress hostname to the correct website record and creates a site-specific secure connection. The plugin stores the resulting connection details in WordPress.


Do not refresh the page while the connection is being established.


Confirm the connection

Open the Status tab and check:


  • Connection Status shows Connected.
  • API Key Configured shows a masked key.
  • Site URL is correct.
  • Plugin Version is the expected release.
  • REST API is available.
  • Detected Editors is appropriate for the website.

The Status tab is visible only to authorised WordPress administrators. It should not be exposed through an unauthenticated public request.


Complete a practical test in Wheremore:


  1. Open Link Management.
  2. Select the connected project, cluster and a safe test page.
  3. Add a small internal link using anchor text already present on the page.
  4. Wait for the synchronisation to succeed.
  5. Open the live WordPress page and confirm the link.
  6. Remove the test link through Wheremore and confirm that it is removed from the page.

Configure editor detection

After connecting, open wheremore → Settings → Editor Settings.


Use:


  • Auto-detect for the normal recommended configuration.
  • Gutenberg / Classic for standard WordPress post content.
  • Elementor when the page content is managed with Elementor.
  • Bricks when the page content is managed with Bricks.

Select Save Settings after changing the editor.


An editor override affects how the plugin locates and updates content. Choosing the wrong editor can prevent the anchor text from being found or place the link in an unexpected field.


If different pages use different editing systems, keep Auto-detect enabled and test each page type before approving a large set of changes.


Enable troubleshooting logs

Logging is optional and normally remains off.


To enable it:


  1. Open wheremore → Settings.
  2. Find Debug Settings.
  3. Enable Log sync operations to database for debugging.
  4. Select Save Settings.

Use the Logs tab to review recent operations. Logs are automatically cleaned up after 30 days.


Turn logging off again after troubleshooting unless Wheremore Support asks you to leave it enabled.


Logs should be treated as administrative information. Do not publish them, and check them before sharing to ensure they do not contain website content or other sensitive operational details.


Understand the sync process

When a link is saved in Wheremore:


  1. Wheremore creates a link instruction.
  2. The instruction enters a background queue.
  3. Wheremore sends the instruction to the connected WordPress site.
  4. The plugin authenticates the request.
  5. The plugin locates the source page and its supported editable content.
  6. It inserts, updates or removes the link.
  7. WordPress returns the result to Wheremore.

The Link Management sync state then changes to successful or failed.


The plugin avoids blindly rewriting an entire page. It uses the supplied source, destination, anchor text and nearby context to find the intended content.


Security

Wheremore Sync uses a site-specific authenticated connection. Public visitors cannot use its link-management endpoints without the required site credential.


For a secure installation:


  • Keep WordPress, PHP and the plugin updated.
  • Use HTTPS for the website and WordPress REST API.
  • Limit WordPress administrator access.
  • Never expose the Wheremore API key or connection credential.
  • Use a unique API key and revoke it when it is no longer required.
  • Install the plugin only from an official Wheremore package.
  • Keep regular WordPress backups.
  • Review successful link changes on the live website.
  • Disconnect the site before transferring it to another owner or Wheremore account.

Do not weaken a firewall or security plugin globally to make the connection work. Allow the required authenticated WordPress REST requests using the narrowest suitable rule.


Update the plugin

Keep Wheremore Sync updated to receive security, compatibility and reliability fixes.


Update through WordPress

  1. Open Dashboard → Updates or Plugins.
  2. Review the available Wheremore Sync version.
  3. Back up the website.
  4. Select Update now.
  5. Open wheremore → Status and confirm that the new version is active and the connection remains Connected.

Replace the plugin ZIP manually

If a normal update is not available:


  1. Download the current official ZIP.
  2. Open Plugins → Add New Plugin → Upload Plugin.
  3. Upload the ZIP.
  4. Confirm that WordPress should replace the installed version.
  5. Check the connection and perform a small sync test.

A normal update preserves the connection and settings. Do not disconnect before updating unless instructed to do so.


Disconnect Wheremore

Disconnect when the website should no longer accept Wheremore link instructions.


  1. Open wheremore → Settings.
  2. Select Disconnect.
  3. Confirm the warning.

Disconnecting:


  • Stops new automatic link synchronisation
  • Removes the local site connection
  • Requires the API key to be entered again before reconnecting

It does not remove links already present on the website.


If the plugin is being permanently removed, disconnect it first, then deactivate and delete it through WordPress.


Troubleshooting

The plugin will not install

Confirm that you uploaded the ZIP rather than an extracted folder. Check the WordPress and PHP requirements and ensure the administrator account can install plugins.


The website is not found in Wheremore

Add the website to the correct Wheremore workspace first. Confirm that the WordPress Site URL and Wheremore website use the same hostname, allowing for the normal www  variation.


The API key is rejected

Confirm that the complete active key was copied without spaces and that it belongs to an account with access to the website. Create a replacement key if necessary.


Connection fails

Check:


  1. The website uses HTTPS.
  2. Outbound HTTPS requests from WordPress are allowed.
  3. WordPress REST API is available.
  4. A firewall or security plugin is not blocking authenticated requests.
  5. The WordPress Site URL is correct.
  6. The website exists in Wheremore.

Enable temporary logging and review the Status and Logs tabs if the problem continues.


Confirm that the plugin remains active, the source page exists and the correct editor is selected. The exact anchor phrase must still be present in a supported editable field.


Scan the page again in Wheremore before retrying an instruction based on older content.


Remove or correct the link, scan the page again and choose a more distinctive anchor phrase. Repeated phrases can make the intended placement ambiguous.


Clear WordPress, page-builder, server and CDN caches. Check the page in a private browser window.


The REST API shows an authentication error in a browser

This is expected when a protected Wheremore Sync endpoint is opened without the site credential. Use the plugin Status tab and a Wheremore sync test to check the authenticated connection.


The editor is not supported

Use Link Management to record and plan the link, then implement it manually in WordPress. Contact Wheremore Support before relying on automatic changes for a custom editor.


An update removed the connection

Open wheremore → Status. If it shows Not Connected, return to Settings and connect again using an active API key. Do not create multiple connections for different Wheremore website records that represent the same WordPress site.


Frequently asked questions

Does the plugin publish content?

No. It applies approved link instructions to existing supported content. It does not publish new posts or pages.


No. Links are added only after they are created or approved in Wheremore and sent through the sync queue.


Can non-administrators configure the plugin?

No. The settings page requires WordPress administrator-level permissions.


Can I use Wheremore without the plugin?

Yes. Link analysis and planning can still be used, but website changes must be implemented manually.


No. It stops future synchronisation. Existing website content remains unchanged.


Should logging stay enabled?

Usually not. Enable it temporarily when diagnosing a connection or synchronisation problem.


What happens to the API key after connection?

The plugin uses it to register the website and establish its site-specific connection. Keep the key private and revoke it if it may have been exposed.

Wheremore | click to conversion. Developed by Tigerlily Group. Wheremore connects search performance, content engagement, user behaviour, and conversion data to show exactly where you lose prospects — and how to win them back.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Related Articles