It’s a place for people using the self-hosted version of WordPress (ie not WordPress.com) to ask questions and find solutions to their many problems.
The forum covers everything related to WordPress, and over the years, it’s provided me with many solutions.
It gets very busy. As you can imagine.
During the first week of joining I got very active, answering questions left, right and center. Since then I’ve had a lot of other projects to work on, so I’ve become less involved.
Within the first few days, I saw the same topics popping up over and over again. Often quite minor problems to somebody with a lot of experience, but major problems for the less experienced.
They gave me with some great ideas for tutorials for this site.
In fact, the forum inspired this post, which is about troubleshooting and fixing WordPress problems and finding solutions yourself, so you don’t have to wait for a member of the forum to answer your question.
Why is it a good idea to learn how to fix common WordPress problems?
Because the more you use the tools you need to build and run a successful website or blog, like premium themes, plugins and apps, the more problems you’ll encounter.
So, the more you know about the pitfalls, the easier they are to fix.
With that in mind, if you encounter problems with WordPress, here are a few things you should do before starting a thread in the forum, turning to Google for answers or hiring somebody to help you.
1. Stay calm
I know it’s easy for me say this from the comfort of my little office, but panicking will get you nowhere. You’ll end up stressed, filled with worry and you won’t be able to think straight.
Keep this in mind – As long as the database remains intact, it’s easy to fix most WordPress problems.
Let’s look at some of the basic solutions you can try before looking for more help.
2. Switch to one of the default themes
A WordPress user bought and installed a theme, it’s not particularly flash or advanced, but it looks nice.
After installing it he found the comments section on his live posts were missing, so nobody could leave a comment (sometimes a good thing) or read the ones already published.
After a bit of head-scratching and asking him to switch off Jetpack comments, I suggested he switched to one of the default themes.
Hey-presto, the comments reappeared.
The unlikely cause of the problem was the theme.
The theme author disabled the comments part of WordPress, so although the comments remained in the database, nobody could see them on the live site because the function to display didn’t exist in the theme.
Simple. But you can see why the guy was so worried.
Switching to one of the default themes lets you eliminate the theme as the cause.
3. Disable and enable plugins
WordPress is open source software so programmers use whatever code they need to make a plugin work.
Before switching to a mobile responsive theme many years ago, I had a minor ongoing problem with a conflict between WPTouchPro and Outbound Link Manager.
Both plugins worked and did what they were supposed to do.
But when WPTouchPro was active, the link to the Outbound Link Manager options disappeared from the internal navigation menu, so I couldn’t access them.
It took me a while to work out what was going on, and the way I figured it out was by deactivating and activating plugins until I replicated the error.
I started with the unpopular plugins, the ones I don’t use all the time, and slowly worked my way through to the ones everyone knows.
I deactivated one plugin at a time.
If the link to Outbound Link Manager didn’t reappear, I enabled the plugin again, made a note of it and moved on to the next one.
In this situation, I disabled and enabled almost 30 plugins before finding the culprit (WPTouchPro).
When I disabled it, the link to Outbound Link Manager reappeared.
If you find a problem occurs after installing a new plugin or updating an older one, a plugin is almost certainly causing the problem.
If the problem occurs randomly, it’s a case of disabling all (or some) plugins to see if you can find a solution.
It is frustrating and tedious, especially if you have a lot of plugins, but it’s worth the effort.
When you disable a plugin, almost always, WordPress remembers the settings when it again becomes active. You should always err on the side of caution if the plugin is important and note down any special options or settings.
4. Clear the WordPress cache
WP Super Cache is one of the most popular caching plugins around. It stores HTML versions of your pages on the server and displays them to your readers. It works really well.
Problems may occur when you change something like a CSS file, because when you view the site in a browser, it’s calling the cached page and not the new version.
It’s easily resolved by switching off the plugin (in the case of WP Super Cache, I don’t mean deactivating – I mean temporarily switching it off) and/or clearing the cache.
If you use a CDN (content delivery network), you may have to purge the problem file(s) on its server.
5. Check menu settings and options
Problems with menus usually occur because the settings are not quite right.
If you add a menu item and it doesn’t show, make sure you’ve hit save (it happens!), clear the WordPress or browser cache, then check your settings to make sure you have added the item to the active/correct menu.
Also, check the menu is where you think it is – some themes give you multiple menu options, so you may think it’s Menu A in Position A, when in fact, it’s Menu B in Position A.
Sometimes, not ticking a box or choosing the wrong menu causes the problem, and the solution is so obvious, and you’re so used to looking at the screen, it doesn’t jump out at you.
Go over your settings very carefully.
6. Walk away from your blog
A good trick for diagnosing problems with WordPress (and other software) is to walk away from your screen for a few minutes so you can reset your brain. This works especially well if you’ve spent way too long looking for a solution.
Make a coffee, take the dog for a walk or sit in the garden. When your brain resets, head back to the screen and take another look.
You might notice the problem/solution hits you straight away.
Worth mentioning: Always make a backup of the functions.php file before editing
You can make WordPress do a lot without ever touching code.
However, if you feel the need to dig deeper (it’s the best way to learn) and want to change the functions.php file, always, always make a backup before you start.
Make sure you have an FTP program (like FileZilla, which you can download and use for free) and the login details for your server. If you don’t know them, ask your hosting company for them before you start updating important files.
I can’t tell you how many times I’ve broken my site because of a change I’ve made to the functions.php file.
In my experience, when something goes wrong with this file, simply pasting the code via WordPress isn’t enough. I nearly always have to upload the file via FTP.
Once you’re done editing and you know the site’s working, delete the backup.
If you break your WordPress website, don’t panic. The chances of your content, your images and everything else being where they should be, and the database remaining intact, are high.
It’s just a matter of figuring out what’s wrong and fixing the problem.
Sometimes it’s human error, an incorrectly configured plugin, the theme’s settings or something else.
Whatever it is, before you head over to the forum or google the problem, try some of the ideas suggested in this post, you may find your problem disappears.
If you have any other suggestions, please leave a comment.
If you’re stuck and need a hand, drop me an email and I’ll do my best to help or try one of these services: