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.
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 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
- 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, the latter of which we use to set up Selenium on Travis-CI.
- 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.
- 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.