If you can’t seem to get past the blue “api loading” screen, or the blue screen seems to get stuck at some point before the editor comes up, you can find out more on how to solve this issue in this guide below.
There are a few things to quickly try before going too far in the troubleshooting process
1) Clear all cache on the site, CDN, and browser
Sometimes clearing all cache will help. Here is what to do:
- Login to your WordPress dashboard
- Go to “OptimizePress3 > Settings > Advanced” and click the “clear cache” button
- If you have a site caching plugin, clear the cache there as well
- Clear cache from your CDN (such as cloudflare) if you are using one.
- Clear your browser cache
Can you edit pages now? If so, that is great and you’ll just need to clear cache sometimes. The most likely time you’ll encounter this kind of issue with cache is just after updating plugins or themes or WordPress on your site since scripts can be stored in cache. You need not do this each time you edit a page – only if the issue comes up again. If you have to do this constantly then you may have configuration problems either on the hosting, CDN, or cache plugins.
The OptimizePress cache does not need to be configured (there is actually no way to do that). It is a very limited cache and only pertains mostly to the editor. Sometimes due to conflicts with 3rd party caching tools is why sometimes it is necessary to clear the OptimizePress cache to solve this problem with not getting past the blue screen while launching the editor.
2) Make sure you are meeting the minimum requirements to run WordPress and OptimizePress
You’ll want to be sure you are meeting the minimum required hosting settings. Please refer to our guide here (opens in new tab) to view the requirements. You can give that link to your web host and they should be able to check that for you:
https://docs.optimizepress.com/article/2020-optimizepress-3-minimum-requirements
You can also see the minimums for WordPress here: https://wordpress.org/about/requirements/
3) Plugin Conflicts (the most common cause of most issues)
OptimizePress 3.0 was developed to the latest coding standards and WordPress recommendations. This means that OptimizePress should not have any issues using 3rd party plugins so long as those plugins are also following WordPress guidelines. Unfortunately with the huge plugin libraries out there (for both free and paid plugins), there is no way for us to control how 3rd party plugins are coded, and unfortunately this means that despite our best efforts, there may still be plugins that will cause problems.
Compatibility issues are common for Open Source platforms such as WordPress, and are unfortunately unavoidable in some cases and the problems that can come up due to using a poorly coded or outdated plugin can vary greatly. Even if a plugin is coded perfectly, there may still be collisions with CSS classes, PHP functions, or other scripts that just can not live together on the same site (for whatever reasons). In this case the only solution is to find an alternative plugin to replace the one that is causing problems with OptimizePress.
Here is how to find which plugin is causing the problem if clearing cache doesn’t help:
To find the plugin causing the issue, you’ll first want to put your site in maintenance mode. A plugin such as this one will work nice for putting the site in maintenance mode:
https://wordpress.org/plugins/wp-maintenance-mode
Just activate that plugin and turn on the maintenance mode and it will show a simple message to visitors which are not logged into your site. If your site will not be deeply impacted by deactivating plugins then you can skip this step.
You can of course also clone your site to a staging site as well if you know how to do that. Some web hosts such as WP Engine and Kinsta offer free staging sites, or if you are hosting on cloudways they have a way to easily clone a site. This will allow you to test things out without causing your main site to be dysfunctional to the public. Of course if your site doesn’t have any ad campaigns or heavy traffic yet (if you are still building it) then you can proceed without worrying about maintenance mode or staging sites.
Step 1: Disable all plugins other than plugins that were provided to you by OptimizePress
Step 2: See if you can edit a page in OptimizePress (If not, then try clearing cache as mentioned in the previous section above). If you have got this far and still can’t edit, then please submit a support ticket so our team can try to help solve this for you. You may re-activate your plugins and clear cache again on the site before reaching out if you need to.
Step 3: If you can edit your page after deactivating plugins, then we know it definitely is a plugin conflict. To find the bad plugin, please activate only one plugin at a time. After activating each plugin, please clear site cache (if using a cache plugin) and then try to edit a page in the OptimizePress Builder. If you can still edit, please repeat this process by activating another plugin and testing the editor again.
If you activate a plugin and then the issue happens where you can not edit a page (ie… can’t get past the blue screen), then deactivate the plugin you just activated and test again. If you can edit without that plugin active, then that plugin is causing the problem and you’ll need to reach out to the plugin developers for that specific plugin or find an alternate plugin.
Continue this process until you reach the end of your plugins list. Any plugins that stopped the page from being edited will need to be deactivated or replaced with compatible plugins in order to use the OptimizePress Builder.
4) Make sure WordPress, and all plugins/themes are updated
Outdated plugins, themes, and WordPress can cause problems not only with compatibility, but also security. You will want to be sure that you keep everything updated.
5) Change WordPress Theme to the default theme
While it is not as common to have theme issues, we do still see this occasionally and in some cases can be fixed easily, or by reaching out to the theme developers who created the theme you are using.
To change your theme, simply go to “Appearance > Themes” and choose another theme or one of the default WordPress themes. If you do not have any themes installed besides the one you are actively using, then click “add new” and select the default theme:
Type “Twenty” in the search box and usually the first and 2nd themes will be the default themes that you can try.
After you install the default theme, simply click “Activate”
After you activate the default theme, try to edit an OptimizePress page. If you can, then your theme was causing the problem. If you can’t, then it still must be something else, and it is probably best to reach out to us if you have tried all the other things above in this guide and still can’t edit your pages.
How to get help if you still can’t solve this issue
If you still can not solve the problem, simply create a support ticket and our team will be glad to help you further with this.
Please be sure to include your site and hosting logins so we can fully troubleshoot the issues and solve the problem for you.