{"id":13458420,"url":"https://github.com/lucatume/wp-browser","last_synced_at":"2026-02-23T11:41:35.005Z","repository":{"id":441469,"uuid":"20884729","full_name":"lucatume/wp-browser","owner":"lucatume","description":"The easy and reliable way to test WordPress with Codeception. 10 years of proven success.","archived":false,"fork":false,"pushed_at":"2025-05-08T08:37:31.000Z","size":56640,"stargazers_count":623,"open_issues_count":1,"forks_count":87,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-05-08T09:26:22.369Z","etag":null,"topics":["codeception-module","php","tdd","testing","wordpress"],"latest_commit_sha":null,"homepage":"https://wpbrowser.wptestkit.dev/","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/lucatume.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["lucatume"]}},"created_at":"2014-06-16T12:53:35.000Z","updated_at":"2025-05-05T08:21:02.000Z","dependencies_parsed_at":"2024-01-08T09:41:21.222Z","dependency_job_id":"f71a5009-6f40-48ab-9b80-8f29fd9f1828","html_url":"https://github.com/lucatume/wp-browser","commit_stats":{"total_commits":2926,"total_committers":52,"mean_commits":56.26923076923077,"dds":0.06971975393028029,"last_synced_commit":"38e15758d2960d31ce6347bff843574f147d2630"},"previous_names":[],"tags_count":397,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatume%2Fwp-browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatume%2Fwp-browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatume%2Fwp-browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatume%2Fwp-browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucatume","download_url":"https://codeload.github.com/lucatume/wp-browser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254235700,"owners_count":22036964,"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":["codeception-module","php","tdd","testing","wordpress"],"created_at":"2024-07-31T09:00:52.382Z","updated_at":"2026-02-19T12:03:20.949Z","avatar_url":"https://github.com/lucatume.png","language":"PHP","readme":"# wp-browser\n\nYou can use wp-browser to test WordPress sites, plugins and themes.\n\nAn easy and quick setup, with a default configuration that will work for most projects, run end-to-end tests, integration tests and unit tests all with the same tool.\n\n\u003e This document refers to version `4` of the project.\n\u003e If you're using version `3` or version `3.5`, and are looking for the migration and troubleshooting guide, you can find it [here][6]\n\n## Requirements\n\nDepending on the nature of your project, there are different requirements it will need to satisfy before getting started.\n\n### Site\n\n* Ensure you're running the `vendor/bin/codecept init wpbrowser` command from the root directory of your WordPress site.\n* Ensure the directory contains the WordPress installation files. In a standard scenario you should have extracted WordPress files in this directory.\n* Ensure your installation is configured: it should contain a `wp-config.php` file.\n\n### Plugin\n\n* Ensure you're running the `vendor/bin/codecept init wpbrowser` command from the root directory of your plugin; this should be the directory that contains the PHP file defining the [plugin header][6].\n\n### Theme\n\n* Ensure you're running the `vendor/bin/codecept init wpbrowser` command from the root directory of your theme; this should be the directory that contains the `style.css` file defining [the theme header][7].\n\nIf you decide to use the quick installation, then your PHP version should have the `sqlite3` extensions installed and activated. You can check this using the `php -m` command and verifying the `sqlite3` extension is among the active extensions.\n\n## Installation\n\nAdd wp-browser to your project as a development dependency using [Composer][1]\n\n```bash\ncd my-wordrpess-project\ncomposer require --dev lucatume/wp-browser\n```\n\nInitialize wp-browser to quickly configured to suite your project and setup:\n\n```bash\nvendor/bin/codecept init wpbrowser\n```\n\nThe command will set up your project to run integration and end-to-end tests using:\n\n* SQLite as the database engine, leveraging the [SQLite Database Integration plugin][2]\n* PHP built-in web server to serve the WordPress site on localhost (e.g. `http://localhost:8080`)\n* Chromedriver to drive the local version of Chrome installed on your machine\n\nIf you're working on a plugin or theme project, the default configuration will add some extra steps:\n\n* install the latest version of WordPress in the `tests/_wordpress` directory\n* create a `tests/_plugins` directory: any file or directory in this directory will be symlinked into the WordPress\n  installation in `tests/_wordpress/wp-content/plugins`\n* create a `tests/_themes` directory: any file or directory in this directory will be symlinked into the WordPress\n  installation in `tests/_wordpress/wp-content/themes`\n\nFor most projects this configuration will be enough to get started with testing.\n\nYou can run your tests immediately using the `vendor/bin/codecept run` command.\n\n[Read more about the commands provided by the library here.](https://wpbrowser.wptestkit.dev/commands/)\n\n### Using a custom configuration\n\nIf you decide to skip the default configuration, you will be able to set up `wp-browser` to suit your needs and local\nsetup by editing the `tests/.env` file.\nThe inline documentation in the file will guide you through the configuration process.\n\n[Read more about using a custom configuration here.](https://wpbrowser.wptestkit.dev/commands/)\n\n## Getting support for wp-browser configuration and usage\n\nThe best place to get support for wp-browser is [the project documentation](https://wpbrowser.wptestkit.dev).  \nSince this project builds on top of [PHPUnit][3] and [Codeception][4], you can also refer to their documentation.\n\nIf you can't find the answer to your question here you can ask on\nthe [\"Issues\" section of the wp-browser repository][5] taking care to provide as much information as possible.\n\nFinally, you can \u003ca href=\"mailto:luca@theaveragedev.com\"\u003econtact me directly\u003c/a\u003e to set up a call to discuss your\nproject needs and how wp-browser can help you.\n\n## Sponsors\n\nA thanks to my sponsors: you make maintaining this project easier.\n\n[1]: https://getcomposer.org/\n\n[2]: https://wordpress.org/plugins/sqlite-database-integration/\n\n[3]: https://phpunit.de/\n\n[4]: https://codeception.com/\n\n[5]: https://github.com/lucatume/wp-browser/issues/new/choose\n\n[6]: https://wpbrowser.wptestkit.dev/migration\n","funding_links":["https://github.com/sponsors/lucatume"],"categories":["Tools","WordPress Plugins","Helper library, code snippet"],"sub_categories":["Testing","2. Sage"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucatume%2Fwp-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucatume%2Fwp-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucatume%2Fwp-browser/lists"}