A few months ago, I contributed an article to WPTuts on Writing Maintainable WordPress Widgets. The motivation for this series was driven largely by the fact that as much as I love the WordPress community, there are more than a few poorly constructed plugins.
In some cases, this is fine. If you’re planning to quickly throw something together with no plans to continue development after its initial release, you can probably get a way with throwing something functional together.
But if you’re looking to build a plugin that you’ll be maintaining over time, then I believe applying good software development practices is a must. That is, I think that developers should follow the platform’s API, use design patterns where applicable, and clearly organize their files.
Over the past year, I’ve written a number of WordPress plugins both for contract and for hobby. During that time, I began creating a boilerplate of code off of which I build most of my widgets.
The WordPress Widget Boilerplate features the following:
- File Organization. The Boilerplate ships with both JavaScript sources and stylesheets for both the administrator and the client-side views. It provides a basic localization file to make it easy to localize the plugin. It also includes a stubbed out README that follows WordPress conventions.
- Documented Code. Each file of the plugin and each method of the core code is clearly documented for its purpose in the overall plugin. Additionally, the core code includes various TODO’s to make it easy for your IDE to locate everything you need to populate when working on your plugin.
- API Implementation. The Boilerplate is based on the WordPress API in order to enforce best practices when building on top of the WordPress platform. This makes it easy to develop conventional, familiar code and makes it easy to compare your work with the recommendations of the Codex.
The WordPress Widget Boilerplate is available on GitHub and is under active development. Feel free to watch, fork, or contribute. I’m always looking to make it as solid as possible when it comes to plugin development.
This is, um, totally fantastic.
Thank you!
I’ve got one for plugins, too. Gonna write about it later.
This is very useful! Cant wait for the plug in one as well..
There are a few more changes that I want to make to the Widget Boilerplate then I’m going to revisit the Plugin Boilerplate
.
Great share. Thank you, I’ll use it. This should be included in the WordPress documentation.
Ah, I appreciate that. There are still a few changes that I need to make (so keep an eye on the GitHub project
.
Thanks Mr.Tom
You’re welcome!
Hello,
This look really interesting and I needed this kind of development for my own projects.
Thank you for that
Cheers
jeFFF
Awesome – thanks Jeff!
Can’t wait for the plugin boilerplate.
this is great. but is it me or is the body text on your site almost illegible?
looks like a very very light helvetica neue here, hurts my eyes!
Thanks!
Noted the styles – I’ll look into it later
.
Two words…Oh my.
Two more if you don’t mind…Thank you.
LOL – of course! Thanks for the comment
.
p.s. Any progress on the plug-in version?
Unfortunately not just yet – been working on other projects. Planning to try to have it out by the end of the year, though!
This gonna save hours and hours of time! Thanks for putting in your time in developing it Tom.
Sure thing – thanks for the comment, Dawson!
Great work
thanks
You’re welcome!
Thanks for this! On another note… your comments form tripped me out for a minute because the labels are below the boxes : )
Sure thing!
And which browser are you using (or can you shoot me a screen shot)?