SimpleTest for WordPress

Enables unit testing and integration testing for WordPress plugins, using SimpleTest

Author:Michael Toppa (profile at wordpress.org)
WordPress version required:3.0
WordPress version tested:3.4.2
Plugin version:1.1
Added to WordPress repository:14-06-2011
Last updated:30-07-2014
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:80
Rated by:1
Plugin URI:http://www.toppa.com/simpletest-for-wordpress
Total downloads:1 344
Active installs:10+
plugin download
Click to start download

I am currently no longer developing or supporting this plugin. I may resume development and support in the future, but I'm not sure when.

Overview

SimpleTest for WordPress is a tool for WordPress plugin developers who want to create and run automated tests for their plugins. It includes SimpleTest 1.1 and uses a shortcode to let you run unit tests on WordPress plugins, and see the results in a WordPress page. Since it runs within WordPress, you can also do integration testing of plugins (that is, custom WordPress functions used in the plugins will work correctly when the tests are run).

Installation of Toppa Plugin Libraries for WordPress is required for this plugin. Please download and install it first.

The "tests" subdirectory contains real, example unit and integration tests so you can see how tests are written for SimpleTest (it is very similar to PHPUnit, but I find its use of mock objects more straightforward, and since SimpleTest's native output is HTML, it integrates nicely with WordPress).

Usage is simple. Create a page or post where you want to display test results (you'll probably want to make this a private page). Then add a shortcode like this:

[simpletest name="SimpleTest Unit Tests" path="/simpletest-for-wordpress/tests/UnitWpSimpleTest.php" passes="y"]

  • name (optional): an optional name to show as a header in the test results
  • path (required): the path to your tests file, relative to the base plugin directory, written for use with SimpleTest.
  • passes (optional): "y" or "n" - whether to show passed tests in the output (defaults to n)

A css file is included for styling the test output results. Copy the css file to your active theme folder and customize to your heart's content.

Applying Agile Coding Practices to WordPress Plugin Development

The example shortcode above will work. It runs the unit tests I wrote for the plugin itself. I also included integration tests. Test coverage is limited however, given inherent limitations of testing the test harness itself. The differences between the unit tests and integration tests are that the unit tests use mock versions of the plugin's external dependencies (on WordPress functions and the filesystem), and the integration tests run against the actual dependencies. The former tell you if your plugin's internal logic is correct, the latter tell you if there are any problems interfacing with external dependencies. Don't write dirty hybrids that mix the two! Then it's hard to even tell what you're really testing.