No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.txt Widget Boilerplate Aug 5, 2014
package.json Merge pull request #12 from jameswlane/renovate/grunt-1.x Feb 13, 2019
renovate.json Add renovate.json Dec 28, 2018

WordPress Widget Boilerplate

The WordPress Widget Boilerplate serves as a foundation off of which to build your WordPress widgets.


  • The Widget Boilerplate is fully-based on the WordPress Widget API
  • Uses PHPDoc conventions for easily following the code
  • Liberal use of TODO to guide you through what you need to change
  • Uses a strict file organization scheme to make sure the assets are easily maintainable


The WordPress Widget Boilerplate is ready to activate as-is (though it includes no real functionality).

  1. Copy the widget-boilerplate directory into your wp-content/plugins directory
  2. Navigate to the "Plugins" dashboard page
  3. Locate the menu item that reads "TODO"
  4. Click on "Activate"

This will activate the WordPress Widget Boilerplate. Because the Boilerplate has no real functionality, nothing will be added to WordPress; however, this demonstrates exactly how your widget should behave as you're working with it.


The WordPress Widget Boilerplate is licensed under the GPL v2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA


1.0 (29 November 2012)

  • Official Release

Author Information

The WordPress Widget Boilerplate was originally started and is maintained by Tom McFarlin.

The project is open-source and receives contributions from awesome WordPress Developers throughout the world.