Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/walisc/wpselenium
WPSelenium is a library that allows you to quickly get up and running testing your site with selenium and phpunit.
https://github.com/walisc/wpselenium
composer driver facebook php phpunit selenium
Last synced: 2 months ago
JSON representation
WPSelenium is a library that allows you to quickly get up and running testing your site with selenium and phpunit.
- Host: GitHub
- URL: https://github.com/walisc/wpselenium
- Owner: walisc
- License: mit
- Created: 2019-01-28T11:52:11.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-01-16T13:33:46.000Z (almost 5 years ago)
- Last Synced: 2024-10-07T23:10:02.296Z (3 months ago)
- Topics: composer, driver, facebook, php, phpunit, selenium
- Language: PHP
- Homepage: https://wpselenium.centridsol.tech/
- Size: 184 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# WPSelenium
## WPSelenium is a library that allows you to quickly get up and running testing your site with selenium and phpunit.
WPSelenium is a library that quickly gets you up and running when you want to test your site using selenium and phpunit. It does this by installing and configuring [phpunit](https://phpunit.de/), the [selenium server](https://www.seleniumhq.org/download/), the [php client webdriver (by facebook)](https://github.com/facebook/php-webdriver) and the correct drivers for the browser you want to test on. Once installed all you have to worry about is writing your selenium php tests.
WPSelenium also includes support for testing WordPress plugins and themes. It does this by providing WordPress specific hooks and configuration end points you can use.
**Usage**
```bash
Operand browser is required
Usage: vendor/bin/wpselenium [options]
Example: vendor/bin/wpselenium chrome --type wordpress
Operands:
Brower you want to test on. Chrome and Firefox supported by default. See documenation if you want to add
others.
Options:
--type The type of site you are testing. e.g --type wordpress
--loglevel Console loglevel - info, warn, error, debug.
-?, --help Show this help and quit.
```
## Getting Started
### Requirements
In order to run WPSelenium you will need to have the following installed
* [Java](https://java.com/en/download/help/download_options.xml) (and make sure its on your system path. Type java in your terminal or command line window to check)
* [Php >= 7.2 ](https://www.php.net/downloads.php)
* [Composer](https://getcomposer.org/doc/00-intro.md)
* [Chrome](https://www.google.com/chrome/) or [Firefox](https://www.mozilla.org/en-US/firefox/new/) or any other browser you want to test on (given you have the drivers)
### 1. Install
To get started with WPselenium install it using composer using the following command:-
`composer require --dev devchid/wpselenium`
> **Note:-** This command assumes that the working directory you are running it from is a composer project. If not, you can easily make it one buy running
`composer init` or adding a `composer.json` file.
> **Note:-** WPSelnenium curently downloads the **76.0.3809.126 chrome drivers** and the **0.24 firefox gecko drivers**. If your browser needs a newer or older vesion of a driver (you will get error suggesting this if unsure) please specify an updated download url for the driver in the wpselenium.xml config file. Please see the [documentation site](http://wpselenium.devchid.com/) for more details.
### 2. Configure
Having installed wpselenium you need to create a wpselenium.xml config file. This file should be in the same location as you `composer.json` file.
Below if a very basic sample configuration to get you going.
```xml
http://localhost:3000
vendor/devchid/wpselenium/src/Sample/SampleTest.php
```
You will need to replace siteUrl, with you own site you are trying to test.
> Note:- The WPSelenium.xml can embed the phpunit config, using the phpunit endpoint (like above). This specified config is then loaded when testing your project with phpunit. However if you want to create your own phpunit config file (phpunit.xml) you can also do this (and not include it here). See [documentation site](https://wpselenium.centrid.tech/) for more details.
### 3. Run Tests
After this previous step you are in essence done. You can run the following command from the same location as your `composer.json` file (were browser_driver can either be chrome or firefox)
`/vendor/bin/wpselenium [brower_driver]`
If everything was configured properly you should see a browser window opened up to your site's home page (Example below). This window will close after about 10s .
> Note:-
> 1. On first run WPSelenium will download the required files and configure those appropriately. This means your first run will take a little bit long to start testing your site.
> 2. WPSelenium currently comes with only support for chrome and firefox. However if there is another browser you want to test you can specify the link to the browser drivers in you wpselenium config. From there you can rerun the above command using the specified name of your driver (I.e /vendor/bin/wpselenium opera). See Configuration section for more details.
If you managed to see the home page of your site like the above example, everything is set up correct. You can now go ahead and write your tests.
## WordPress Support
WPSelenium comes with inbuilt support for WordPress sites. This is particularly useful when building custom plugins or themes that might require UI testing. Please see [documentation site](https://wpselenium.centridsol.tech/) for more details.
## Documentation
The WPSelenium library is fully documented at [https://wpselenium.centridsol.tech/](https://wpselenium.centridsol.tech/). If you think of anything else that should be documented that's not there, please do give a shout.
## Contributing
WPSelenium is an opensource project and contributions are valued.
If you are contributing a bug fix, please create a pull request with the following details
* The problem/bug you are addressing
* The version of WPSelenium the fix is for
* How you tested the fix
If it's a new feature, please add it as a issue with the label enhancement, detailing the new feature and why you think it's needed. Will discuss it there and once it's agreed upon you can create a pull request with the details highlighted above.
## Authors
* **Chido Warambwa** - *Initial Work* - [[email protected]](mailto:[email protected])
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details