{"id":14955139,"url":"https://github.com/jdgrimes/wpppb","last_synced_at":"2025-10-24T07:30:49.955Z","repository":{"id":56997519,"uuid":"67309334","full_name":"JDGrimes/wpppb","owner":"JDGrimes","description":"Bootstrap for integration testing WordPress plugins with PHPUnit","archived":false,"fork":false,"pushed_at":"2019-04-27T18:35:11.000Z","size":50,"stargazers_count":13,"open_issues_count":7,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-29T08:34:19.894Z","etag":null,"topics":["phpunit","testing","wordpress","wordpress-development"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JDGrimes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-09-03T20:04:08.000Z","updated_at":"2024-03-04T00:59:59.000Z","dependencies_parsed_at":"2022-08-21T11:10:12.797Z","dependency_job_id":null,"html_url":"https://github.com/JDGrimes/wpppb","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JDGrimes%2Fwpppb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JDGrimes%2Fwpppb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JDGrimes%2Fwpppb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JDGrimes%2Fwpppb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JDGrimes","download_url":"https://codeload.github.com/JDGrimes/wpppb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237932068,"owners_count":19389560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["phpunit","testing","wordpress","wordpress-development"],"created_at":"2024-09-24T13:10:34.534Z","updated_at":"2025-10-24T07:30:49.319Z","avatar_url":"https://github.com/JDGrimes.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WP Plugin PHPUnit Bootstrap [![Build Status](https://travis-ci.org/JDGrimes/wpppb.svg?branch=master)](https://travis-ci.org/JDGrimes/wpppb) [![Latest Stable Version](https://poser.pugx.org/jdgrimes/wpppb/version)](https://packagist.org/packages/jdgrimes/wpppb) [![License](https://poser.pugx.org/jdgrimes/wpppb/license)](https://packagist.org/packages/jdgrimes/wpppb)\n\nBootstrap for integration testing WordPress plugins with PHPUnit.\n\n## Installation\n\n```bash\ncomposer require --dev jdgrimes/wpppb\n```\n\n## Set Up\n\nFirst, you will need a local checkout of the WordPress development repo, including the `tests` directory. The recommended way to get this, particularly if you intend to contribute to WordPress core, is with [VVV](https://make.wordpress.org/core/handbook/tutorials/installing-a-local-server/installing-vvv/). WPPPB builds on the testing tools already included with WordPress core, so it won't work without them.\n\nOnce you have a local copy of WordPress's `tests` directory, you can run the set-up script for WPPPB:\n\n```bash\nvendor/bin/wpppb-init\n```\n\nAnswer the prompts, and you are ready to go!\n\nYour tests will be placed in the `tests` directory that will be created in the root of your project (i.e., alongside the `vendor` directory added by Composer). Your plugin's source (the part that would be zipped up and installed on a WordPress site) is expected to be in a `src` directory alonside these two, and not in the root of your project itself. Example file structure would look like this:\n\n```\n- src/\n  - my-plugin.php\n  - includes/\n  - etc.\n- tests/\n- vendor/\n```\n\nWith a few modifications, you could probably use WPPPB with a different directory structure, but this is what it expects by default.\n\n## Usage\n\nYou can run your PHPUnit tests just as you normally would:\n\n```bash\nphpunit\n```\n\nYou can also do other cool things like [test your plugin's uninstall routine](https://github.com/JDGrimes/wpppb/wiki/Testing-Uninstallation).\n\n(Note that the default bootstrap utilizes Composer's PHP autoloader, which requires\nPHP 5.3. See here for [instructions on usage with PHP 5.2](https://github.com/JDGrimes/wpppb/wiki/PHP-5.2).)\n\n## Purpose\n\nThe purpose of this project is to provide a bootstrap for plugin developers who want\nto perform integration tests for their plugin using WordPress core's testsuite. Its\naim is not only to make this easier, but also better, by providing an implementation\nthat makes the tests as realistic as possible.\n\nTo this end, the loader works by remotely activating the plugin(s), and letting\nWordPress load them just as it normally would. This provides more realistic testing\nthan manually including and activating the plugins on the `muplugins_loaded` action,\nas is usually done.\n\n## License\n\nThis project's code is provided under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdgrimes%2Fwpppb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjdgrimes%2Fwpppb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdgrimes%2Fwpppb/lists"}