The Ten Commandments of WordPress Development

The Ten Commandments of WordPress Development

Do you incorporate best practices into your development process? Floris didn't used to. But after getting some help on the best approach for WordPress, he's got ten commandments that can help you to get better.

About a year ago I made an inventory of all the WordPress websites I created together with my colleagues over the past few years. I found out that we used a lot of different approaches. It lacked standardization. What we needed was a uniform approach to development and, of course, a philosophy. At first I was a little flabbergasted, I really did not know where to start. Of course we all knew about the Codex, the forums and tutorial websites, but we did not have any contact with the WordPress community at all.

This was something that needed to change. We decided to hire a local WordPress expert and invited him to give us some advice with respect to this matter – our expert came from Friesland. Do you feel yourself situated in the same position as I was one year ago? Then this might be your starting point too. WordPress is used all over the world. So you are bound to find an expert near you.  Good places to start searching are WordPress forums in your own language, WP Meetups and amongst WordCamp organizers.

I received a lot of tips and pointers to start my standardizing approach. I immediately started to draft a list of focus points, in fact a list of the most pressing points at that very moment. I chose to limit my list to ten focus points for me and my colleagues to work on and I called them: “The Ten Commandments”.  A short list, that is what I wanted, as well as a constantly evolving list of points, , raising the bar as we went along.

My first version of the Ten Commandments featured items like: “Enqueue your scripts correctly” and “Only use one stylesheet, and use the right one”. Nowadays I don’t feel I have to remind myself and my colleagues about these items, so other items were added to my list. A month ago I reworked the original list into a new one with new, more general, focal points. I wrote them down on a big whiteboard in our office, no developer can miss it. Here they are, my current ten commandments:

1. Always set WP_DEBUG to true during development

You would not believe how many plugins and themes, and how much custom code triggers notices and warnings. All these low level errors can cause memory leakage, causing your site to consume more memory than needed. WP_DEBUG is also a useful tool to find out if you are using any deprecated functionality.

2. Adhere to WordPress Coding & CSS-standards

Our expert, Remkus, also wrote a post about this some year ago. Wouldn’t it be nice if we all wrote our code as shown in the WordPress Coding Standards? The standards, as set by WordPress core developers, are the cumulation of years of experience. Adhering to these rules leaves you with a clean readable code other people would love to read to. There is a reason for the motto ‘code is poetry’.

3. Comment your code

Your code should not only be easily readable by others, but others should also be able to understand why you chose to write a bit of code in a certain manner. There are many ways to skin a cat, explain to your co-workers why you wrote it like that. There are documentation guidelines in the Codex.

4. Learn how the core works, read the actual lines of code

You should know how WordPress works internally. When are (mu)plugins loaded? When are database queries being performed, when are theme files loaded and so on? There is a great deal you can learn from reading the core. It’s inspiring!

5. Use WordPress internal functions and APIs whenever you can

I have written a lot of code in the past that could easily be substituted with a function or procedure that is already embedded in the core. If only I knew it was there… Browse through the core files (as stated in my previous commandment) and figure out how these all work. You will be amazed with what you can find in there. Like these utility functions.

6. Namespace your code

A lot of people write code for WordPress in themes and plugins. Chances are that your function name, or class of variable is the same as someone elses.  You should always namespace it. I use my inititals FPL, like: fpl_functioname();

7. Never trust user input! Sanitise & escape!

This remains a really important issue. Today and most probably forever. WordPress is loaded with tools enabling you to write secure sites. The best read for this is chapter 6 of this book. You do own that book, right?

8. Use nonces

This is an extension of my previous commandment. Using nonces secures all the functionality your forms need. Check out this page in the Codex; using nonces makes sense!

9. Internationalize your code

Living in Europe, we are used to talking and writing a lot in different languages.  Don’t be surprised when your client requests his plugin or theme be available in other languages or even dialects, either now or in the future. Do you write your code with localization in mind? That’s makes your task of adding another language easier in future. WPtuts has a nice tutorial about localization for themes and plugins.

10. Performance, performance, performance

We are building high-performance-sites. With everything that you write or include, be it a database query, PHP code, HTML, CSS, JavaScript or assets like images, you always should keep performance in mind. Simply each and every nanosecond counts.

Illustration by Sjors Trimbach



Leave a Reply