Troubleshooting and support
Most problems on a WordPress site come from a plugin conflict, a cached file or an outdated PHP version. Work through the checks below in order: they apply to the Stax theme, BuddyBuilder and Visibility Logic alike, and they produce the details support needs if you still have to ask for help.
Back up before you update
Section titled “Back up before you update”Take a full backup (files and database) before you update WordPress, a theme or a plugin, and before you run the tests on this page on a live site.
- Use the backup tool of your hosting provider, or a backup plugin such as UpdraftPlus.
- Download a copy of the backup, or store it off the server.
- If you can, run the tests on a staging copy of the site instead of the live one.
Update everything
Section titled “Update everything”- Go to Dashboard > Updates.
- Update WordPress, then your plugins and themes.
- Check the problem again.
Many reported bugs are already fixed in the current version.
Clear the caches
Section titled “Clear the caches”An old cached file is the usual reason a change “does not show”.
- Clear the cache of your caching plugin and of your host or CDN, if you use one.
- In Elementor, go to Elementor > Tools and clear the files and data cache, if the problem is on an Elementor page.
- Reload the page with a hard refresh, or open it in a private browser window.
Test for a plugin conflict
Section titled “Test for a plugin conflict”- Go to Plugins > Installed Plugins.
- Deactivate every plugin except the ones involved in the problem (for example Elementor and BuddyBuilder).
- Check whether the problem is gone.
- If it is, reactivate the plugins one at a time, checking after each one. The plugin that brings the problem back is the conflict.
Deactivating a plugin does not delete its settings.
Test with another theme
Section titled “Test with another theme”- Go to Appearance > Themes.
- Activate a default WordPress theme, such as Twenty Twenty-Four.
- Check whether the problem is gone, then switch back to your theme.
If the problem disappears with the default theme, it comes from your theme or from the code in your child theme. If you use a child theme, also test with the parent theme active. Your Customizer settings come back when you reactivate your theme.
Check the PHP version
Section titled “Check the PHP version”- Go to Tools > Site Health > Info.
- Expand Server and read PHP version.
The Stax theme, BuddyBuilder and Visibility Logic need PHP 7.4 or newer and WordPress 5.0 or newer. Your hosting provider can switch the PHP version for you.
Enable the debug log
Section titled “Enable the debug log”The debug log records PHP errors with the file and line they come from.
-
Connect to your site over FTP or the file manager of your host.
-
Open
wp-config.phpin the WordPress root folder. -
Find this line:
define( 'WP_DEBUG', false ); -
Replace it with:
define( 'WP_DEBUG', true );define( 'WP_DEBUG_LOG', true );define( 'WP_DEBUG_DISPLAY', false ); -
Save the file, then load the page that has the problem.
-
Open
wp-content/debug.logand look at the newest lines.
Set WP_DEBUG back to false when you are done. The log can contain file paths of your server, so remove them or share the log privately.
Fix: you cannot reach the dashboard
Section titled “Fix: you cannot reach the dashboard”When a fatal error locks you out, deactivate the cause by renaming its folder over FTP:
- A plugin: in
wp-content/plugins, rename the plugin folder, for examplemy-plugintomy-plugin-off. WordPress deactivates it. - The theme: in
wp-content/themes, rename the active theme folder, for examplestaxtostax-off. WordPress falls back to a default theme if one is installed.
Rename the folder back after you fix the cause, then reactivate it in the dashboard.
Get help
Section titled “Get help”Include your WordPress, PHP, theme and plugin versions, the steps to reproduce the problem, the result of the conflict tests and the relevant lines of the debug log.
| Product | Where to ask |
|---|---|
| Stax theme (free) | WordPress.org forum for Stax |
| Free plugins | The support forum of the plugin on WordPress.org |
| BuddyBuilder Pro, Visibility Logic Pro | StaxWP support, priority support for customers with an active license |
Licenses, downloads and billing are in your StaxWP account. For license questions, see License and account.