Guide

How to install the seonumi Connector plugin

A step-by-step guide to downloading the plugin, installing it in WordPress, connecting it to your seonumi account and checking that it works.

Illustration with sample data: Connect WordPress

In short

  • A small WordPress plugin that you upload as a zip.
  • It needs WordPress 6.2 and PHP 7.4 or newer.
  • You don’t need it for titles and image alt text.
  • Every change has a snapshot and an undo.

seonumi applies only the fixes you allow, and every change can be undone.

Get started

By seonumiPublished

What the plugin is, and when you need it

The seonumi Connector is a small WordPress plugin. It lets seonumi apply the fixes you allow beyond titles and image alt text, with a snapshot before every change and an undo for each one.

You don’t need it for the basics. Titles and image alt text, and meta descriptions where WordPress allows it, are fixed through WordPress with an Application Password. The plugin adds the rest: social sharing tags, canonical tags, structured data, H1 headings, broken internal links, redirects for pages that moved, your sitemap and robots.txt, and some image and page speed settings. It’s included in every plan.

What it never does

  • It never makes a change you haven’t allowed in your seonumi account, and it accepts requests only from the one WordPress user you pair with it.
  • It never deletes anything for good.
  • It never touches your home page address, cart, checkout, account, login or sign-up pages.
  • It never runs code sent to it over the network. The only thing it downloads is a new version of itself, and WordPress installs that only when the signature and the checksum are right.

How it keeps changes safe

  • A snapshot is saved before every change. You can undo any change from the plugin screen or from your seonumi account.
  • Site-wide changes undo themselves after 15 minutes unless seonumi confirms that your site still works.
  • The plugin keeps its own daily limits and e-mails the site administrator about every high-risk or site-wide change.
  • A pause switch on the plugin screen stops every change at once. Undo still works while it is on.

What you need first

  • WordPress 6.2 or newer, and PHP 7.4 or newer.
  • A single WordPress site. The plugin refuses to activate on a multisite network.
  • A site on HTTPS, because WordPress offers Application Passwords only on HTTPS sites.
  • A WordPress user who can install plugins, such as an Administrator.
  • Your WordPress already connected in your seonumi account. The last step, the test, needs it.

Install and connect it in six steps

Menu names can differ a little by WordPress version, theme and language, and this guide has no screenshots because screens differ from site to site. Each step names the button or the setting as WordPress shows it.

1. Download the plugin

In your seonumi account, find the Connector card (in the setup steps, or under Settings, then Connections) and press Download the plugin. The card shows the version, the size, and the WordPress and PHP versions the file needs. Keep the file as a zip: don’t unzip it. The name of the newest file is also listed in a small public file.

2. Upload and activate it in WordPress

In WordPress, open Plugins, then Add New Plugin, then Upload Plugin. Choose the zip file, press Install Now, then Activate. Once it is active, WordPress has a new role called seonumi Connector and a new screen under Settings, then seonumi.

3. Create a user for seonumi

This step is recommended. In WordPress, open Users, then Add New User. Name the user seonumi and choose the role seonumi Connector. That role can work with posts, pages and files, but it can’t install plugins or manage users. Then open the user, scroll to Application Passwords, type a name such as seonumi and press Add New Application Password. Copy the password right away, because WordPress shows it once. The Application Passwords guide has the details.

4. Connect that user in seonumi

Back in seonumi, press Connect again in the WordPress connection above the Connector card, and enter the user name seonumi and its Application Password. Your earlier connection keeps working until you do this.

5. Create the pairing code

In WordPress, open Settings, then seonumi, and press Generate pairing code. The code has 26 letters and digits. WordPress shows it once and it is valid for 10 minutes, so copy it before you leave the screen. If you need another one, generate a new code: it replaces the old one.

6. Test the connector

In seonumi, paste the code into Pairing code and press Test the connector. When it works, the card says that the connector works and shows the installed version. From then on the plugin accepts requests from that one WordPress user only. If you leave the code empty, the button only checks the plugin again, without pairing.

Check the file you downloaded (optional)

The Connector card has a part called “Check the file (optional)”. It shows two things.

  • The SHA-256 of the file. Calculate it on your computer and compare. In Windows PowerShell: Get-FileHash FILE.zip -Algorithm SHA256. On a Mac: shasum -a 256 FILE.zip. FILE.zip is the name of the file you downloaded. If the two values differ, don’t install the file: download it again.
  • The fingerprint of the signing key. After you install the plugin, Settings, then seonumi lists the fingerprints of the keys that sign its updates. It should show the same fingerprint as the card: 272ae1d720c4f31e.

Update the plugin

  • From version 1.4.1. WordPress offers the update like any other plugin update: on the Plugins screen and under Dashboard, then Updates. You can also switch on automatic updates for this plugin. An update is installed only when its signature matches seonumi’s key that is built into the version you already run, its version is higher than yours, and the file has exactly the size and checksum named in the signed file. Anything else is refused and nothing changes.
  • Older versions. Version 1.4.0 and older don’t look for updates. Upload the newest zip once, in Plugins, then Add New Plugin, then Upload Plugin, and press Replace current with uploaded. From then on, updates come by themselves.

What the update check sends

WordPress looks for plugin updates in the background about twice a day, and when you open the Plugins or Updates screen. When it does, the plugin asks seonumi.com for a small file that names the newest version, and for that file’s signature. These are plain HTTPS requests. They carry only the usual headers of any web request and the plugin’s name and version as the user agent, for example seonumi-connector/1.4.1. They carry no account name, site address, WordPress or PHP version, list of plugins, cookie or data about your visitors or your content. Like any website, seonumi and its hosting provider see the network address of your web server and the time of the request. The plugin never sends anything else from your site to seonumi.

If you deactivate or delete the plugin

  • Deactivate. What the plugin adds when a page loads stops on the next page your server builds: social tags, structured data, redirects, image sizes, lighter image copies and the SEO texts it shows through your SEO plugin. A page whose address seonumi changed, or that it moved to the trash, answers “not found” at its old address again. A page kept by a cache or a CDN can keep the old version until that cache refreshes. Changes saved in WordPress itself stay. Before you deactivate, the plugin screen lists what will change and lets you download your redirects.
  • Delete. The plugin’s change history is removed, so undo is no longer possible. While it is installed, the plugin keeps that history for 180 days. Values saved in WordPress are not reverted, so press “Undo all seonumi changes” first if you want them undone. Your redirect list is kept unless you choose to remove it on the plugin screen. The FAQ answers the same question in short.

If something goes wrong

The upload or the installation fails

  • The upload is refused or stops. The file is just over 1 MB, and some hosts allow smaller uploads. Ask your host to raise the upload limit, or to put the folder seonumi-connector from inside the zip into wp-content/plugins.
  • WordPress says “Incompatible Archive” or “The package could not be installed”. The file was probably changed on its way, or it is not the zip itself. Upload the .zip file, not an unzipped folder and not a zip inside another zip. If it still fails, download the file again and compare its SHA-256, as described above.
  • WordPress says the plugin needs a newer WordPress or PHP. The plugin needs WordPress 6.2 and PHP 7.4 or newer. Update WordPress, or ask your host to move your site to a newer PHP.
  • “seonumi Connector does not support WordPress multisite yet, so it was not activated.” The plugin works on a single site only.

The test in seonumi does not pass

The card tells you the reason. These are the usual ones.

  • “We cannot see the plugin yet.” Check in WordPress, under Plugins, that seonumi Connector is activated.
  • A security plugin, the host firewall or bot protection blocks us. Allow seonumi’s servers in that tool, or ask your host, and test again.
  • Application Passwords are missing or turned off. See the Application Passwords guide: the usual causes are a site without HTTPS, a security plugin, and a host that removes the sign-in header.
  • “WordPress refused our connection to the plugin.” Check the WordPress connection above the card, and connect again if that fails too. If you pressed Reset connection on the plugin screen, the plugin revokes the Application Password it used: create a new one, connect again and generate a new pairing code.
  • “Not paired” or “Site address changed”. Generate a new pairing code on the plugin screen and paste it into the card. A code works once, and only for 10 minutes. After several wrong tries it stops working, so generate a new one.
  • “Paused in WordPress”. The pause switch on the plugin screen is on. Turn it off there and the fixes continue.
  • “Maintenance mode”. Your site is in maintenance mode or an update is running. Test again when it has finished.
  • “Update needed”. The installed version is too old. Upload the newest zip, as described under “Update the plugin”.

A fix does not show on your page

A page kept by a cache plugin or a CDN can keep showing the old version until that cache refreshes. For pages that carry an SEO text or a lighter image, the plugin asks the caching plugins it knows to forget them. If a page still shows the old version, clear the cache of your cache plugin or CDN yourself.

Where to get help

If you are stuck, write to us. Tell us which step you are on and what the card or WordPress says. Never send us an Application Password or a pairing code.

Questions about the plugin

Do I have to install the plugin?

No. Titles and image alt text, and meta descriptions where WordPress allows it, are fixed without it. Install it for the rest: social tags, structured data, H1 headings, redirects, broken internal links, the sitemap, robots.txt and some image and page speed settings.

Can I use my Administrator account instead of creating a seonumi user?

Yes, it works. But seonumi then holds more power than it needs, and the app marks the connection as over-privileged. A user with the Editor role can apply page fixes, but site-wide fixes need the seonumi user or an Administrator.

Does it work on a WordPress multisite network?

Not yet. The plugin refuses to activate on a multisite network.

Does the plugin send anything about my site to seonumi?

The only connection it makes to a service outside your site is to seonumi.com, to look for and download new versions of the plugin itself. That request carries the plugin’s name and version, and nothing that identifies your account or your site. The seonumi service connects to your site, with the WordPress user you paired, to apply the fixes you allow. That is a request to your site, not from it.

Next step

Let seonumi apply only the fixes you allow

Install the plugin once. Every change gets a snapshot and an undo.