Installation

1. Install plugin from OctoberCMS Marketplace or clone the code from GitHub into /plugins/initbiz/selenium2tests directory.
2. Go to /plugins/initbiz/selenium2tests
3. Copy selenium.php.example to selenium.php and configure your environment

Testing OctoberCMS basics

It is a good practice not to use the same DB for testing and developing purposes.

In order to configure different database for testing purposes create directory testing in config directory and copy database.php to the newly created directory. Then change the default connection as you wish.

After that if you use APP_ENV=testing in your .env file, configuration from testing directory will be used.

Writing tests in Selenium 2

There are example tests in tests/example directory that use Ui2TestCase class.

Traits

There are some useful methods in traits SeleniumHelpers and OctoberSeleniumHelpers. SeleniumHelpers was mostly based on Modelizer/Laravel-Selenium.

Available methods for OctoberCMS:

• signInToBackend
• waitForFlashMessage
• checkFirstRowInBackend
• getRecordID
• clickRowInBackendList
• checkRowIdInBackend
• typeInBackendSearch

For more information about the methods see traits/OctoberSeleniumHelpers.php file.

Running tests

First of all, you have to run Selenium 2 server. It is included in the package. You have to have Java installed on the local machine. In order to start Selenium 2 server change directory to <project_root>/plugins/initbiz/selenium2tests and run java -jar selenium.jar.

You are ready to run tests using PHPUnit from OctoberCMS's vendor/bin/phpunit.

You can keep test files wherever you want, but .gitignore of the plugin will exclude all files from /tests except those in /tests/examples.

Troubleshooting

phpunit and phpunit-selenium version

Depending on version of phpunit and phpunit-selenium some typical errors may occur.

While working with the default phpunit and phpunit-selenium in OctoberCMS you can get must be an instance of Exception, instance of Error given error. The problem is with the old version phpunit and phpunit-selenium extension used by OctoberCMS.

It works best when you set in your root composer.json file versions as follows:

"require-dev": {
   ...
   "phpunit/phpunit": ">5.7",
   "phpunit/phpunit-selenium": "~4.1"
}

And run composer update.