CiviCRM Web Tests

This repository contains Web Tests for CiviCRM.

Setup

• Clone the civicrm-webtests repository.
• Create a CiviCRM testing instance.
  • This testing repository is intended for use with real data, but some tests will need to be altered for variations in the data set.
• Install Codeception
• Codeception tests can be run with a local browser (Chrome or Firefox) or headless.
  • To watch the tests with a local browser, install Selenium Server and a WebDriver.
    • Download the latest Selenium .jar. Selenium 3.x requires Java 1.8. Selenium 2.x requires Java 1.7.
    • Download ChromeDriver to use Chrome, or download GeckoDriver to use Firefox. Anecdotally Chrome is faster. Be sure to check the Webdriver for their respective browser version requirements.
  • For headless testing, install PhantomJS. Note that PHP Browser testing isn't supported due to the amount of Javascript loaded on CiviCRM Pages for even basic functionality.
• Copy the local.tpl.yml template file to local.yml and complete with your testing environment settings. Note that some tests require a database connection.
• Run all the included tests with

  codecept run
  

  • Run a single Acceptance test, e.g. the Basic Search test, with

    codecept run tests/acceptance/Core/Authenticated/SearchBasicCept.php
    

• Write more tests and share them!