Yesterday I learned to update WordPress to the newest version that you plan to use, before setting up the new theme. (As of April 2008, I recommend updating to WordPress 2.3.3, not 2.5.)

One of my websites is on another server. And, like most good hosting services, they automatically installed WordPress when I asked them to. It was a fairly recent version of WordPress, so I didn’t update it before installing the Bradford Magazine theme myself.

Big mistake. My Categories didn’t work correctly. Four hours later, I ended up uninstalling WordPress. Then, I had my server reinstall it, and then totally overwrote everything (from the standard WordPress upgrade files) except the config.php file. Yes, I even overwrote everything in wp-content.

After that, I installed the Bradford Magazine theme. Then, step-by-step, I added the tweaks that I’d made in the original template. (I general change sidebar.php, index.php, header.php, style.css and ui.tabs.php. I also create my own header graphic, and sometimes a page background graphic as well*.)

Finally, I changed the Permalinks and header.php, as recommended in WordPress Search Engine Optimization. And, after every step–even tiny ones–I double-checked my site to be sure that everything was still working okay.

If you have a Categories problem after installing your theme, don’t spend four hours trying to fix it, as I did. If it doesn’t resolve with a few simple tweaks, rebuild from scratch.

While I’m talking about WordPress, here are a couple of other tips: If you change the Permalink to the recommended Custom link, your new .htaccess file goes in the WordPress root-level folder.

If you’ve never written an .htaccess file and there is none in your WordPress root folder, create a blank document. In it, paste the code provided on the WordPress page where you made the Permalink change. Upload that to your WordPress root; generally, you’ll call the created file .htaccess.html and then, after upload, rename it to .htaccess (If this sounds like a totally foreign language, do not change the Permalink, unless you can get someone else to handle the .htaccess issue for you.)

I am getting better at this process, and feel more confident recommending both WordPress and the magazine-style themes. Remember, I knew HTML and some (very limited) CSS before this, but I had zero PHP experience.

It’s taken a lot of trial-and-error to get this figured out, but… well, if I can do it, most people probably can. Then again, that’s why I wrote Sites that Soar, so no one has to reinvent the wheel.

—

* Yes, you can apply a background image and overlay a header (branding) graphic as well. That’s in the CSS. Just get the repeats right, or it’ll look funky.