WordPress Troubleshooting

When working with WordPress, you may encounter various issues that can affect your site's performance and functionality. These issues can range from minor glitches to major problems that affect your business operations, blocking sales and customer interactions. Solving these issues quickly is crucial to maintaining a positive user experience and ensuring your site runs smoothly.

This guide focuses on the general approach to troubleshooting WordPress issues and lists the most common problems and their solutions. It is not a comprehensive guide to every possible issue but rather a starting point for troubleshooting. The guide is structured to help you systematically identify and resolve problems, ensuring that you can get your WordPress site back up and running as quickly as possible. Here is a list of covered topics:

• Create Backups
• Enable Debugging
• Clear Cache
• Check for Plugin and Theme Conflicts
• Check for Updates
• Check Site Health
• Refresh Permalinks
• Update .htaccess File
• Fix Site URL
• Enable Indexing
• Use Security Plugins

Create Backups

It is good practice to create a backup of your WordPress site before making any changes, including troubleshooting. This ensures you have a restore point in case something goes wrong during troubleshooting. The Virtuozzo Application Management provides a dedicated Backup and Restore add-on that regularly creates backups according to a configured schedule and also offers on-demand backup. Your data is securely stored in a separate storage container outside the WordPress environment, ensuring it remains safe even if the WordPress environment is compromised or corrupted.

Enable Debugging

WordPress includes a built-in debugging system that logs error messages on your site. So, if you encounter any issues, the first step is to enable debugging. This will help you identify errors and warnings that may be affecting your site. You may also want to enable debugging during the development of your WordPress site to catch potential issues early. Checking your WordPress error logs can help you identify the source of issues, such as slow website performance, plugins that aren’t working properly, and website crashes.

WordPress debugging is turned off by default, so WordPress will not log any errors. If you can still log in to your WordPress site, you can enable debug mode using the WP Debugging plugin. Just go to the Plugins section in your WordPress admin panel, search for the plugin, install it, and activate it. It will automatically make the necessary changes to enable debugging in your WordPress installation.

Alternatively, you can manually enable debugging by editing the /var/www/webroot/ROOT/wp-config.php file in your WordPress installation directory. It can be done directly in the Virtuozzo Application Management dashboard via the built-in file manager or by connecting to the container via SSH. Add the following code just before the line that says /* That's all, stop editing! Happy blogging. */:

1
2

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

The The debug.log file will appear in the /var/www/webroot/ROOT/wp-content/ directory. You can view the file using the same file manager or via an SSH connection. However, the log file will not contain any error messages until the problem recurs on your site. You will need to recreate the problem on your site so the error messages can be saved to the log file. For example, you should revisit any posts or pages that are causing an error. Once you have the exact error message, you can search online for a solution.

If you still cannot find the exact solution, you can follow the general troubleshooting steps outlined below to identify and resolve the issue.

Clear Cache

If you see an outdated version of your site after making changes, you may just need to clear your cache. Caching is a common technique for speeding up website loading times by storing a static version of your site. However, sometimes, the cached version can become outdated, causing issues with your site.

First, try clearing your browser cache. Use the keyboard shortcut Ctrl + F5 (Windows) or Cmd + Shift + R (Mac) to force a full page refresh (without using the cache). If that doesn’t work, you can try clearing the cache manually by going to your browser settings. The exact steps will depend on the browser you are using.

If using a caching plugin, you can clear the cache from the plugin settings in your WordPress admin panel. Most caching plugins include a button to clear the cache, which removes the cached version of your site and lets you see the latest changes. In the case of the LiteSpeed Cache plugin, you can clear the cache by clicking on the Purge All button in the plugin quick access menu at the top of your WordPress admin panel or by going to the LiteSpeed Cache > Toolbox section.

Check for Plugin and Theme Conflicts

Plugins and themes can sometimes conflict with each other, causing issues on your site. If you have recently installed or updated a plugin or theme, it may be the cause of the problem. The easiest way to check for conflicts is to disable all plugins and switch to a default theme. If the issue is resolved, you can then re-enable your plugins and a theme one by one to identify the culprit.

To disable all plugins, go to the Plugins section in your WordPress admin panel and select all plugins. Then, choose the Deactivate option from the bulk actions dropdown menu and click Apply.

After deactivating all plugins, check if the issue is resolved. If it is, you can start re-enabling your plugins one by one, checking your site after each activation to see if the problem recurs. You can then uninstall the WordPress plugin that is causing the conflict and, if needed, search for an alternative.

If the issue persists after deactivating all plugins, try switching to a default theme. Go to the Appearance section in your WordPress admin panel, select the default theme (e.g., Twenty Twenty-Five), and activate it. Official WordPress themes are less likely to cause conflicts, so this can help you identify if the issue is related to your theme.

If the issue is resolved after switching to a default theme, you can:

• Re-activate your original theme and troubleshoot it further (check for updates, contact the theme developer for support, or look for known issues).
• Consider switching to a different theme that is compatible with your plugins and WordPress version.

Check for Updates

Keeping your WordPress site up to date is essential for security and performance. Outdated plugins, themes, or WordPress core files can cause issues on your site. Make sure to regularly check for updates and install them as needed. You can check for updates in the Dashboard section of your WordPress admin panel. If there are any updates available, you will see a notification at the top of the page. Click on the Updates link to view and install available updates.

Check Site Health

WordPress has a built-in Site Health feature that can help you identify potential issues with your site. It provides information about your site’s performance, security, and configuration. You can access the Site Health tool by going to the Tools > Site Health section in your WordPress admin panel.

Review the recommendations and critical issues listed in the Site Health report. It may suggest actions to improve your site’s performance, security, or configuration. Follow the recommendations to resolve any issues affecting your site.

Refresh Permalinks

If you are getting 404 errors on your pages or posts, it may be due to an issue with your permalinks. You can try regenerating your permalinks to fix the problem. Go to Settings > Permalinks in your WordPress admin panel, then click the Save Changes button at the bottom without making any changes. This will refresh your permalinks and may resolve the issue.

Update .htaccess File

Corrupted or misconfigured .htaccess file can cause various issues on your WordPress site, such as 500 Internal Server Error or redirect loops. If faced with such problems, you can try resetting your .htaccess file to its default settings.

The easiest way to do this is to rename the existing .htaccess file to something like .htaccess_old. This will effectively disable it while keeping a backup of the current file. You can do this using the file manager in the Virtuozzo Application Management dashboard or by connecting to your WordPress container via SSH. The file is located in the /var/www/webroot/ROOT/ directory of your WordPress installation.

After renaming the file, go to Settings > Permalinks in your WordPress admin panel, then click Save Changes without making any changes. This will generate a new .htaccess file with the default WordPress rules.

If the issue is resolved, you can delete the .htaccess_old file. If the problem persists, you can restore your original .htaccess file by swapping file names or contents.

Fix Site URL

Incorrect site URL settings can cause issues with accessing your WordPress site or admin panel, including “site not found” errors or redirect loops.

If you still have access to your WordPress admin panel, you can update the site URL by going to the Settings > General section. Here, you can change the WordPress Address (URL) and Site Address (URL) fields to the correct URL of your site. Make sure that both URLs are exactly the same and point to your custom domain (if you have set one up) or the default domain provided by the Virtuozzo Application Management. After making changes, click the Save Changes button at the bottom of the page.

If you are unable to access your WordPress admin panel, you can fix the site URL by editing the /var/www/webroot/ROOT/wp-config.php file. You can do this using the file manager in the Virtuozzo Application Management dashboard or by connecting to your WordPress container via SSH. Add the following lines to the file just before the line that says /* That's all, stop editing! Happy blogging. */:

1
2

define('WP_HOME', 'http://example.com');
define('WP_SITEURL', 'http://example.com');

Replace http://example.com with the correct URL of your site (including the protocol). Save the changes and try accessing your site again.

Enable Indexing

If your site is not appearing in search engine results, it may be due to indexing issues. WordPress has a built-in option to discourage search engines from indexing your site, which can be useful during development or if you want to keep your site private. However, for production sites, you want to ensure that your site is indexed by search engines.

To enable indexing, go to the Settings > Reading section in your WordPress admin panel. Find the Search Engine Visibility setting and make sure the Discourage search engines from indexing this site option is unchecked. This will allow search engines to index your site and display it in search results.

Use Security Plugins

If you are not using any security plugins, consider installing one to help protect your site from potential threats. Often, malware or malicious code can cause issues on your site, such as redirecting users to spam sites or displaying unwanted ads. Security plugins can help you scan your site for vulnerabilities, remove malware, and protect your site from future attacks. There are many security plugins available for WordPress, such as Wordfence Security, Solid Security, and Sucuri Security. You can install and activate a security plugin of your choice from the Plugins section in your WordPress admin panel.

Once activated, configure the plugin settings according to its documentation and your specific needs. Most security plugins offer features such as malware scanning, firewall protection, login security, and more. Regularly scan your site for vulnerabilities and keep the plugin up to date to ensure maximum protection.