TSF v4.1 release – Common upgrade issues

The SEO Framework v4.1 is released! Although we took the utmost care of every single byte published, we are still human, and you may run into issues.

If you experience technical difficulties, for any reason whatsoever, please don’t panic! We are readily available in these support forums to help you out.

My admin area is all messed up!

There are two reasons for this, namely:

1. A plugin is active that removes query strings from scripts (disable that feature!).
2. Some cache has become stale, and needs a refresh.

The following key-combinations should quickly solve the issue for you. Access any admin page with a messed up interface, and press this:

• Hold CTRL (Windows), CMD (Mac), or SUPER (Linux) and click on the page refresh button.
• Windows: “CTRL+SHIFT+R”
• Mac: “CMD+R”
• Linux: “F5”

Alternatively, you may want to clear your browser cache after updating.

If neither of these solutions works for you, try using another browser, and see if everything’s OK there.

Although very unlikely, some service solutions cache static files from the server in memory. Litespeed and NGINX web servers may be configured this way. Reinstalling The SEO Framework may resolve this issue.

If none of the solutions mentioned above work for you, please open a support inquiry in the forums. Thank you!

I can’t access my administrative dashboard!

There are two accessible solutions.

First, WordPress v5.2 and later has PHP error protection; it allows you to enter a recovery mode. This mode can help you deactivate plugins that don’t behave well.

• To access this mode, you must be logged in as an administrator. You should see a message on your screen.
• If you weren’t logged in during the update process, keep an eye out on the site’s administrator’s email account. You should receive a link shortly.

If you can’t access the recovery mode, or if you’re on an older version of WordPress, follow these steps:

1. Take a deep breath.
2. Enter the file browser of your site, either via the tools your hosting provider gave you or via FTP.
3. Browse to /wp-content/plugins/
4. Delete the autodescription folder. That is where The SEO Framework should reside.
5. Your site should be available again. You can finally exhale.

Can I rollback?

Yes, it’s straightforward, and there are no caveats!

1. Deactivate and delete The SEO Framework v4.1 first.
2. Download the v4.0.7 ZIP file from here.
3. Log in to your WordPress Dashboard.
4. Go to “Plugins” > “Add New”.
5. Click “Upload Plugin” at the top.
6. Upload the autodescription.4.0.7.zip file.
7. Either network-activate the plugin or activate it on a single site.

Let us know how we can do better.

If you have the time, please inform us of the issues you have or are experiencing. We’re here for you. You can do so in these forums. Thanks!