If you are new to the project or Behat, we recommend that you first read through our documentation. For any questions, feedback, or to contribute, you can get in contact with us via Github or our Slack.
- If you are using the WP-CLI driver to connect to a remote WordPress site over SSH, WordHat assumes the remote server is Linux-like, with a shell that provides GNU Coreutils.
- To configure WordHat to use a specific driver, set
- As of v1.1.0, it is possible to use multiple drivers at the same time. This should be considered an experimental feature for advanced users only. To enable it, tag a scenario with the name of the driver to use (e.g.
- On a Mac, Selenium is incompatible with the default Apple Java; error messages look like “Unsupported major.minor version 52.0”. To fix, install Oracle Java Platform JDK.
- With Selenium, some environments may require a “webdriver”; error messages may refer to “GeckoWebDriver” or “ChromeWebDriver”, etc. Good solutions include vvo/selenium-standalone or joomla-projects/selenium-server-standalone.
- WordHat supports MacOS, most flavours of Linux, and Windows. We use Travis-CI and Appveyor to test on Ubuntu and Windows, respectively, and require modern versions of PHP.
Virtual machines (Vagrant)¶
- If you are using a Vagrant-powered virtual machine to run Behat via the WP-CLI driver, you will need to
vagrant sshinto the box once. This will set up password-less authentication; otherwise, WordHat will prompt you for the SSH password frequently.
- If your WordPress is installed in a subdirectory, you need to set the
site_urloption to the value of the “WordPress address (URL)” option (found in WordPress > Settings > General). For more information, consult the WordHat documentation.