Copy WordHat's sample configuration file into your project folder and rename it:
@@ -41,7 +41,7 @@ cd project
To confirm that everything is set up correctly, run:
-
vendor/bin/behat -dl
+
vendor/bin/behat --definitions i
If it worked, you will see a list of text that looks a little like the following (but much longer):
Given I am an anonymous user
Given I am not logged in
@@ -60,6 +60,3 @@ Now that you have WordHat set up, we recommend reading our [introduction to Beha
[^1]:
The WP-CLI executable *must* be named `wp` and be within your system's $PATH.
-
-[^2]:
- Selenium is recommended for testing websites that require Javascript. Behat requires the [Mink Selenium2 library](https://packagist.org/packages/behat/mink-selenium2-driver), which we include in the installation instructions above.
diff --git a/docs/getting-started/wordhat-intro.md b/docs/getting-started/wordhat-intro.md
index 7902e2d1..60df19b2 100644
--- a/docs/getting-started/wordhat-intro.md
+++ b/docs/getting-started/wordhat-intro.md
@@ -10,7 +10,7 @@ Otherwise, if you are unsure how to proceed, first check the [FAQ](/recipes/faq.
One of the fun things about using Behat is seeing it control your web browser and navigating your site. Behat relies on a library called [Mink](http://mink.behat.org/en/latest/) to interface with your web browser. Mink has its own driver system, with [each driver supporting a different combination of browser features](http://mink.behat.org/en/latest/guides/drivers.html#driver-feature-support).
-Some Mink drivers run headless web browsers (e.g. Goutte), and these tend to be the fastest, though notably, most do not support Javascript. WordHat's sample configuration file is configured to use [Selenium](http://www.seleniumhq.org/), which supports a broad range of browser features for most use cases. Selenium is fiddly to set up, so we recommend using [vvo/selenium-standalone](https://github.com/vvo/selenium-standalone#command-line-interface).
+Some Mink drivers run headless web browsers (e.g. Goutte), and these tend to be the fastest, though notably, most do not support Javascript. WordHat's sample configuration file is configured to use Google Chrome by default, which supports a broad range of browser features for most use cases.
For tests requiring Javascript interactions, mark the scenario or feature with the `@javascript` [tag](http://behat.org/en/latest/user_guide/organizing.html#tags).
diff --git a/docs/recipes/faq.md b/docs/recipes/faq.md
index 9c561d88..de845397 100644
--- a/docs/recipes/faq.md
+++ b/docs/recipes/faq.md
@@ -4,7 +4,7 @@ description: WordHat frequently asked questions and answers
If you are new to the project or Behat, we recommend that you first [read through our documentation](https://wordhat.info/). For any questions, feedback, or to contribute, you can get in contact with us via Github or our [Slack](https://wordhat.herokuapp.com).
## Browsers
-* If you are using [Selenium](http://docs.seleniumhq.org/download/) to run Javascript tests, and you access your WordPress site over HTTPS, *and* it has a self-signed certificate, you will need to manually configure the web browser to accept that certificate.
+* If you are using [Selenium](http://docs.seleniumhq.org/download/) to run Javascript tests, and you access your WordPress site over HTTPS, *and* your site is using a self-signed HTTPS certificate, you will need to manually configure the web browser to accept that certificate.
## Drivers
* If you are using the WP-CLI driver to [connect to a remote WordPress site over SSH](https://make.wordpress.org/cli/handbook/running-commands-remotely/), WordHat assumes the remote server is Linux-like, with a shell that provides [GNU Coreutils](https://www.gnu.org/software/coreutils/coreutils.html).
@@ -13,13 +13,14 @@ If you are new to the project or Behat, we recommend that you first [read throug
## Selenium
* 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](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
-* With Selenium, some environments may require a "webdriver"; error messages may refer to "GeckoWebDriver" or "ChromeWebDriver", etc. Good solutions include [vvo/selenium-standalone](https://github.com/vvo/selenium-standalone#command-line-interface) or [joomla-projects/selenium-server-standalone](https://github.com/joomla-projects/selenium-server-standalone).
+* Selenium is fiddly to set up, so we recommend using [vvo/selenium-standalone](https://github.com/vvo/selenium-standalone#command-line-interface) to install and run it.
## Supported platforms
-* WordHat supports MacOS, most flavours of Linux, and Windows. We use [Travis-CI](https://travis-ci.org/paulgibbs/behat-wordpress-extension) and [Appveyor](https://ci.appveyor.com/project/PaulGibbs/behat-wordpress-extension) to test on Ubuntu and Windows, respectively, and require modern versions of PHP.
+* WordHat supports MacOS, most flavours of Linux, and Windows. We use [Travis-CI](https://travis-ci.org/paulgibbs/behat-wordpress-extension) to test on Ubuntu, 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](../features/overview.html#wp-cli), you will need to `vagrant ssh` into 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 Vagrant-powered WordPress site over SSH](https://make.wordpress.org/cli/handbook/running-commands-remotely/), you will probably have better performance by switching to use the WP-PHP driver. This is because [WP-CLI is slow at opening SSH connections to Vagrant boxes](https://github.com/wp-cli/wp-cli/pull/5235).
## WordPress
-* If your WordPress is installed in a subdirectory, you need to set the `site_url` option to the value of the "WordPress address (URL)" option (found in WordPress > Settings > General). For more information, [consult the WordHat documentation](/configuration/settings.md).
+* If your WordPress is installed in a subdirectory, you need to set the `site_url` option to the value of the "WordPress address (URL)" option (found in WordPress > Settings > General). For more information, [consult the WordHat documentation](/configuration/settings.html).
diff --git a/features/toolbar.feature b/features/toolbar.feature
index 1db48649..cf19e9b7 100644
--- a/features/toolbar.feature
+++ b/features/toolbar.feature
@@ -9,7 +9,7 @@ Feature: Toolbar
And I am on the homepage
Scenario: I can go to the support forums
- When I follow the toolbar link "WordPress > Support Forums"
+ When I follow the toolbar link "WordPress > Support"
Then I should be on "https://wordpress.org/support/"
Scenario: I can add a new page
diff --git a/i18n/template.xliff b/i18n/template.xliff
new file mode 100644
index 00000000..fbacb4a4
--- /dev/null
+++ b/i18n/template.xliff
@@ -0,0 +1,383 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+ [^"]+)"$/]]>
+
+
+
+ [^"]+)"$/]]>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)" with "(?P(?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)" with:$/]]>
+
+
+
+ (?:[^"]|\\")*)" for "(?P(?:[^"]|\\")*)"$/]]>
+
+
+
+
+
+
+
+ (?:[^"]|\\")*)" from "(?P
+
+
+
+ (?:[^"]|\\")*)" from "(?P
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ [^"]*)" to "(?P(?:[^"]|\\")*)"$/]]>
+
+
+
+ [^"]+)"$/]]>
+
+
+
+
+
+
+
+ "(?:[^"]|\\")*")$/]]>
+
+
+
+ \d+)$/]]>
+
+
+
+ \d+)$/]]>
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ "(?:[^"]|\\")*")$/]]>
+
+
+
+ "(?:[^"]|\\")*")$/]]>
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)" in the "(?P[^"]*)" element$/]]>
+
+
+
+ (?:[^"]|\\")*)" in the "(?P[^"]*)" element$/]]>
+
+
+
+ [^"]*)" element should contain "(?P(?:[^"]|\\")*)"$/]]>
+
+
+
+ [^"]*)" element should not contain "(?P(?:[^"]|\\")*)"$/]]>
+
+
+
+ [^"]*)" element$/]]>
+
+
+
+ [^"]*)" element$/]]>
+
+
+
+ (?:[^"]|\\")*)" field should contain "(?P(?:[^"]|\\")*)"$/]]>
+
+
+
+ (?:[^"]|\\")*)" field should not contain "(?P(?:[^"]|\\")*)"$/]]>
+
+
+
+ \d+) "(?P[^"]*)" elements?$/]]>
+
+
+
+ (?:[^"]|\\")*)" checkbox should be checked$/]]>
+
+
+
+ (?:[^"]|\\")*)" checkbox is checked$/]]>
+
+
+
+ (?:[^"]|\\")*)" (?:is|should be) checked$/]]>
+
+
+
+ (?:[^"]|\\")*)" checkbox should (?:be unchecked|not be checked)$/]]>
+
+
+
+ (?:[^"]|\\")*)" checkbox is (?:unchecked|not checked)$/]]>
+
+
+
+ (?:[^"]|\\")*)" should (?:be unchecked|not be checked)$/]]>
+
+
+
+ (?:[^"]|\\")*)" is (?:unchecked|not checked)$/]]>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ [^"]*)"$/]]>
+
+
+
+ [^"]*)"$/]]>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/mkdocs.yml b/mkdocs.yml
index 4cf351bc..8651ad3e 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -87,7 +87,6 @@ nav:
- Errors W800-899: recipes/errors/w800-899.md
- Open Source:
- Contributing: contributing/open-source.md
- - Build Process: contributing/build.md
- Credits: credits.md
- License: license.md
- News: changelog.md
diff --git a/readme.md b/readme.md
index 4d3fafcd..eccdf925 100644
--- a/readme.md
+++ b/readme.md
@@ -1,6 +1,6 @@
# WordHat: Behat for WordPress
-WordHat is an integration layer between [Behat](http://behat.org), [Mink](https://github.com/Behat/MinkExtension), and [WordPress](https://wordpress.org). It provides WordPress-specific functionality for common testing scenarios specific to WordPress sites.
+WordHat is a [Behat](http://behat.org) extension for [WordPress](https://wordpress.org). It provides WordPress-specific functionality for common testing scenarios specific to WordPress sites.
[](https://travis-ci.com/paulgibbs/behat-wordpress-extension)
[](https://packagist.org/packages/paulgibbs/behat-wordpress-extension)
diff --git a/scripts/extract-translations.sh b/scripts/extract-translations.sh
new file mode 100755
index 00000000..7573d95c
--- /dev/null
+++ b/scripts/extract-translations.sh
@@ -0,0 +1,47 @@
+#!/bin/bash
+
+IFS=$'\n' BEHAT_STEPS=($(vendor/bin/behat --definitions l --no-colors))
+XLIFF_OUTPUT=template.xliff
+
+# Replace all non-alnum characters with a hypen.
+function sanitise() {
+ local name="$1"
+ name="${name//[^[:alnum:]]/-}"
+
+ # Convert to lowercase, strip repeated hypens.
+ echo "$name" | tr -s '[:upper:]' '[:lower:]' | tr -s '-'
+}
+
+# Header.
+(cat <
+
+
+
+TEMPLATE
+) > $XLIFF_OUTPUT
+
+# Translation strings.
+for STEP in "${BEHAT_STEPS[@]}"; do
+ # Remove "default | | from step definition.
+ STEP=${STEP##*| }
+ STEP_ID=$(sanitise $STEP)
+
+ (cat <
+
+
+
+TEMPLATE
+) >> $XLIFF_OUTPUT
+done
+
+# Footer.
+(cat <
+
+
+TEMPLATE
+) >> $XLIFF_OUTPUT
+
+echo "Done!"
diff --git a/src/Context/RawWordpressContext.php b/src/Context/RawWordpressContext.php
index e6a1c262..3bf820a9 100644
--- a/src/Context/RawWordpressContext.php
+++ b/src/Context/RawWordpressContext.php
@@ -2,6 +2,7 @@
declare(strict_types=1);
namespace PaulGibbs\WordpressBehatExtension\Context;
+use Behat\Behat\Context;
use Behat\MinkExtension\Context\RawMinkContext;
use PaulGibbs\WordpressBehatExtension\WordpressDriverManager;
use PaulGibbs\WordpressBehatExtension\Context\Traits\PageObjectAwareContextTrait;
@@ -13,7 +14,7 @@
*
* Does not contain any step defintions.
*/
-class RawWordpressContext extends RawMinkContext implements WordpressAwareInterface, PageObjectAware
+class RawWordpressContext extends RawMinkContext implements WordpressAwareInterface, PageObjectAware, Context\TranslatableContext
{
use PageObjectAwareContextTrait;
@@ -135,7 +136,7 @@ public function getDriver(string $name = ''): DriverInterface
*/
public function resetBrowser()
{
- $this->getSession()->reset();
+ $this->getSession()->stop();
}
/**
@@ -158,4 +159,14 @@ public function getRandomString(int $length = 64): string
return $random;
}
+
+ /**
+ * Return translation resource paths.
+ *
+ * @return string[] Path to translations.
+ */
+ public static function getTranslationResources()
+ {
+ return glob(__DIR__ . '/../../i18n/*.xliff');
+ }
}
diff --git a/src/Context/Traits/FilesystemAwareContextTrait.php b/src/Context/Traits/FilesystemAwareContextTrait.php
new file mode 100644
index 00000000..cd88cd4a
--- /dev/null
+++ b/src/Context/Traits/FilesystemAwareContextTrait.php
@@ -0,0 +1,21 @@
+getDriver()->filesystem->deleteFile($abspath);
+ }
+}
diff --git a/src/Context/Traits/UserAwareContextTrait.php b/src/Context/Traits/UserAwareContextTrait.php
index ecfee3f9..4bde464a 100644
--- a/src/Context/Traits/UserAwareContextTrait.php
+++ b/src/Context/Traits/UserAwareContextTrait.php
@@ -48,19 +48,22 @@ public function logIn(string $username, string $password, string $redirect_to =
$this->logOut();
}
- // Start a session.
$session = $this->getSession();
- // Go to the login form.
+ /*
+ * Ensure log-in page is not the first loaded page in the session. We believe
+ * this to be a cause of form field manipulation intermittently failng, causing
+ * the log-in step to fail -- as "Given I am logged in as a user" is often the
+ * the first line in a scenario!
+ *
+ * See https://github.com/Behat/MinkExtension/issues/286
+ */
+ $this->visitPath('/');
$this->visitPath('wp-login.php?redirect_to=' . urlencode($this->locatePath($redirect_to)));
- // Fill in username.
$this->login_page->setUserName($username);
-
- // Fill in password.
$this->login_page->setUserPassword($password);
-
- // Submit the login form.
+ $this->login_page->setRememberMe();
$this->login_page->submitLoginForm();
if (! $this->loggedIn()) {
diff --git a/src/Context/WordpressContext.php b/src/Context/WordpressContext.php
index d449125d..f5057b48 100644
--- a/src/Context/WordpressContext.php
+++ b/src/Context/WordpressContext.php
@@ -4,9 +4,11 @@
use Behat\Behat\Hook\Scope\AfterScenarioScope;
use Behat\Behat\Hook\Scope\BeforeScenarioScope;
+use Behat\Behat\Event;
use Behat\Mink\Driver\Selenium2Driver;
use PaulGibbs\WordpressBehatExtension\Context\Traits\CacheAwareContextTrait;
use PaulGibbs\WordpressBehatExtension\Context\Traits\DatabaseAwareContextTrait;
+use PaulGibbs\WordpressBehatExtension\Context\Traits\FilesystemAwareContextTrait;
use PaulGibbs\WordpressBehatExtension\Context\Traits\PageObjectAwareContextTrait;
/**
@@ -14,7 +16,7 @@
*/
class WordpressContext extends RawWordpressContext
{
- use PageObjectAwareContextTrait, CacheAwareContextTrait, DatabaseAwareContextTrait;
+ use PageObjectAwareContextTrait, CacheAwareContextTrait, DatabaseAwareContextTrait, FilesystemAwareContextTrait;
/**
* Constructor.
@@ -45,7 +47,7 @@ public function maybeBackupDatabase(BeforeScenarioScope $scope)
* Otherwise, we would use the (static) BeforeSuiteScope hook.
*/
$backup_file = $this->getWordpress()->getSetting('database_backup_file');
- if ($backup_file) {
+ if (! empty($backup_file)) {
return;
}
@@ -55,6 +57,7 @@ public function maybeBackupDatabase(BeforeScenarioScope $scope)
// If the path specified is not a file, use it as the preferred folder to store a new backup.
if (! $file || ! is_file($file) || ! is_readable($file)) {
$file = $this->exportDatabase(['path' => $file]);
+ $this->getWordpress()->setSetting('built_database_backup', true);
}
// Note: $file may be either an absolute OR relative file path.
@@ -118,10 +121,35 @@ public function maybeRestoreDatabase(AfterScenarioScope $scope)
}
$file = $this->getWordpress()->getSetting('database_backup_file');
- if (! $file) {
+ if (empty($file)) {
return;
}
$this->importDatabase(['path' => $file]);
}
+
+ /**
+ * If WordHat created its own database dump, delete it after the test suite has completed.
+ *
+ * @AfterSuite @db
+ *
+ * @param Event\SuiteEvent $scope
+ */
+ public function maybeRemoveDatabaseDump(Event\SuiteEvent $event)
+ {
+ $delete_backup = $this->getWordpress()->getSetting('built_database_backup');
+ if ($delete_backup === null) {
+ return;
+ }
+
+ $file = $this->getWordpress()->getSetting('database_backup_file');
+ if (empty($file)) {
+ return;
+ }
+
+ $this->getWordpress()->setSetting('database_backup_file', null);
+ $this->getWordpress()->setSetting('built_database_backup', null);
+
+ $this->deleteFile($file);
+ }
}
diff --git a/src/Driver/Element/Wpcli/ContentElement.php b/src/Driver/Element/Wpcli/ContentElement.php
index b2651d6e..ef2e6830 100644
--- a/src/Driver/Element/Wpcli/ContentElement.php
+++ b/src/Driver/Element/Wpcli/ContentElement.php
@@ -50,7 +50,7 @@ public function create($args)
'ID', 'post_author', 'post_date', 'post_date_gmt', 'post_content', 'post_content_filtered', 'post_title',
'post_excerpt', 'post_status', 'post_type', 'comment_status', 'ping_status', 'post_password', 'post_name',
'to_ping', 'pinged', 'post_modified', 'post_modified_gmt', 'post_parent', 'menu_order', 'post_mime_type',
- 'guid', 'post_category',
+ 'guid', 'post_category', 'page_template',
),
$args
);
diff --git a/src/Driver/Element/Wpcli/FilesystemElement.php b/src/Driver/Element/Wpcli/FilesystemElement.php
new file mode 100644
index 00000000..fd4bddc9
--- /dev/null
+++ b/src/Driver/Element/Wpcli/FilesystemElement.php
@@ -0,0 +1,28 @@
+drivers->getDriver()->wpcli('eval', $delete_cmd, ['--skip-wordpress']);
+ }
+}
+
diff --git a/src/Driver/Element/Wpphp/FilesystemElement.php b/src/Driver/Element/Wpphp/FilesystemElement.php
new file mode 100644
index 00000000..b0392f13
--- /dev/null
+++ b/src/Driver/Element/Wpphp/FilesystemElement.php
@@ -0,0 +1,26 @@
+add_role($role);
}
- return $this->get($user);
+ return $this->get($user_id);
}
/**
diff --git a/src/PageObject/Element/TinyMCEEditor.php b/src/PageObject/Element/TinyMCEEditor.php
index 2426018e..8970ea6f 100644
--- a/src/PageObject/Element/TinyMCEEditor.php
+++ b/src/PageObject/Element/TinyMCEEditor.php
@@ -57,11 +57,9 @@ public function getMode(): string
public function setContent(string $content)
{
if (self::VISUAL === $this->getMode()) {
- $this->getDriver()->switchToIFrame(self::$wysiwyg_iframe_id);
$this->getDriver()->executeScript(
- ';document.body.innerHTML = \'
\';'
);
- $this->getDriver()->switchToIFrame();
} else {
$this->fillField(self::$textarea_id, $content);
}
diff --git a/src/PageObject/LoginPage.php b/src/PageObject/LoginPage.php
index 0a936061..c73c3890 100644
--- a/src/PageObject/LoginPage.php
+++ b/src/PageObject/LoginPage.php
@@ -1,43 +1,37 @@
getSession();
+ $url = $session->getCurrentUrl();
- // Get the session.
- $session = $this->verifySession();
-
- // Get the url.
- $url = $session->getCurrentUrl();
-
- // If the login path isn't in the current URL.
if (false === strrpos($url, $this->path)) {
- // We aren't on the login screen.
throw new ExpectationException(
sprintf(
'Expected screen is the wp-login form, instead on "%1$s".',
@@ -47,22 +41,14 @@ protected function verifyLoginPage()
);
}
- // Get the page.
- $page = $session->getPage();
-
- // Login form CSS selector
- $login_form_selector = '#loginform';
-
- // Search for the login form exists.
- $login_form = $page->find('css', $login_form_selector);
+ $selector = '#loginform';
+ $login_form = $session->getPage()->find('css', $selector);
- // If the login form was not found.
if (null === $login_form) {
- // We aren't on the login screen.
throw new ExpectationException(
sprintf(
'Expected to find the login form with the selector "%1$s" at the current URL "%2$s".',
- $login_form_selector,
+ $selector,
$url
),
$this->getDriver()
@@ -71,174 +57,90 @@ protected function verifyLoginPage()
}
/**
- * Fills the user_login field of the login form with a given username.
+ * Fills the user_login field of the log-in form with a given username.
*
- * @param string $username the username to fill into the login form
+ * @param string $username the username to fill into the log-in form
*
- * @throws \Behat\Mink\Exception\ExpectationException
+ * @throws ExpectationException
*/
public function setUserName(string $username)
{
+ $session = $this->getSession();
+ $field = $session->getPage()->find('css', '#user_login');
- // Get the session.
- $session = $this->verifySession();
-
- // Verify we are on the login page.
- $this->verifyLoginPage();
-
- // Get the page.
- $page = $session->getPage();
-
- // Find the user_login field.
- $user_login_field = $page->find('css', '#user_login');
-
- // Try to focus the user_login field.
try {
- $user_login_field->focus();
+ $field->focus();
} catch (UnsupportedDriverActionException $e) {
// This will fail for GoutteDriver but neither is it necessary.
}
- // Set the value of $username in the user_login field.
- $user_login_field->setValue($username);
- // The field can be stubborn, so we use fillField also.
- $page->fillField('user_login', $username);
+ $field->setValue($username);
- // Attempt to fill the user_login field with JavaScript.
try {
- $session->executeScript(
- "document.getElementById('user_login').value='$username'"
- );
+ $session->executeScript("document.getElementById('user_login').value='$username'");
} catch (UnsupportedDriverActionException $e) {
- // This will fail for drivers without JavaScript support
- }
-
- // Get the actual value of the user_login field.
- $username_actual = $user_login_field->getValue();
-
- // Verify the username was filled in correctly.
- if ($username_actual !== $username) {
- throw new ExpectationException(
- sprintf(
- 'Expected the username field to be "%1$s", found "%2$s".',
- $username,
- $$username_actual
- ),
- $this->getDriver()
- );
+ // This will fail for drivers without JavaScript support.
}
}
/**
- * Fills the user_pass field of the login form with a given password.
+ * Fills the user_pass field of the log-in form with a given password.
*
- * @param string $password the password to fill into the login form
+ * @param string $password the password to fill into the log-in form
*
- * @throws \Behat\Mink\Exception\ExpectationException
+ * @throws ExpectationException
*/
public function setUserPassword(string $password)
{
+ $session = $this->getSession();
+ $field = $session->getPage()->find('css', '#user_pass');
- // Get the session.
- $session = $this->verifySession();
-
- // Verify we are on the login page.
- $this->verifyLoginPage();
-
- // Get the page.
- $page = $session->getPage();
-
- // Find the user_pass field.
- $user_pass_field = $page->find('css', '#user_pass');
-
- // Try to focus the user_pass field.
try {
- $user_pass_field->focus();
+ $field->focus();
} catch (UnsupportedDriverActionException $e) {
// This will fail for GoutteDriver but neither is it necessary.
}
- // Set the value of $password in the user_pass field.
- $user_pass_field->setValue($password);
- // The field can be stubborn, so we use fillField also.
- $page->fillField('user_pass', $password);
+ $field->setValue($password);
- // Attempt to fill the user_pass field with JavaScript.
try {
- $session->executeScript(
- "document.getElementById('user_pass').value='$password'"
- );
+ $session->executeScript("document.getElementById('user_pass').value='$password'");
} catch (UnsupportedDriverActionException $e) {
// This will fail for drivers without JavaScript support
}
-
- // Get the actual value of the user_pass field.
- $password_actual = $user_pass_field->getValue();
-
- // Verify the password was filled in correctly.
- if ($password_actual !== $password) {
- throw new ExpectationException(
- sprintf(
- 'Expected the password field to be "%1$s", found "%2$s".',
- $password,
- $$password_actual
- ),
- $this->getDriver()
- );
- }
}
/**
- * Submit the WordPress login form
+ * Mark the "remember me" input box on the log-in form.
*/
- public function submitLoginForm()
+ public function setRememberMe()
{
+ $session = $this->getSession();
+ $field = $session->getPage()->find('css', '#rememberme');
- // Get the session.
- $session = $this->verifySession();
-
- // Verify we are on the login page.
- $this->verifyLoginPage();
-
- // Get the page.
- $page = $session->getPage();
-
- // Find the submit button.
- $submit_button = $page->find('css', '#wp-submit');
-
- // Try to focus the submit button.
try {
- $submit_button->focus();
+ $field->focus();
} catch (UnsupportedDriverActionException $e) {
// This will fail for GoutteDriver but neither is it necessary.
}
- // Click the submit button.
- $submit_button->click();
+ $field->check();
}
- /**
- * Verify and return a properly started Mink session
- *
- * @return \Behat\Mink\Session Mink session.
+ /**
+ * Submit the log-in form.
*/
- protected function verifySession()
+ public function submitLoginForm()
{
- // Get the session.
$session = $this->getSession();
+ $button = $session->getPage()->find('css', '#wp-submit');
- // Start the session if needed.
- if (! $session->isStarted()) {
- $session->start();
- }
-
- // If we aren't on a valid page
- if ('about:blank' === $session->getCurrentUrl()) {
- // Go to the home page
- $session->visit('/');
+ try {
+ $button->focus();
+ } catch (UnsupportedDriverActionException $e) {
+ // This will fail for GoutteDriver but neither is it necessary.
}
- // Return the session.
- return $session;
+ $button->click();
}
}
diff --git a/src/ServiceContainer/config/drivers/wpcli.yml b/src/ServiceContainer/config/drivers/wpcli.yml
index 96fee3b9..ed4cf9e1 100755
--- a/src/ServiceContainer/config/drivers/wpcli.yml
+++ b/src/ServiceContainer/config/drivers/wpcli.yml
@@ -4,6 +4,7 @@ parameters:
wordpress.element.wpcli.comment.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpcli\CommentElement
wordpress.element.wpcli.content.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpcli\ContentElement
wordpress.element.wpcli.database.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpcli\DatabaseElement
+ wordpress.element.wpcli.filesystem.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpcli\FilesystemElement
wordpress.element.wpcli.plugin.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpcli\PluginElement
wordpress.element.wpcli.term.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpcli\TermElement
wordpress.element.wpcli.theme.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpcli\ThemeElement
@@ -49,6 +50,13 @@ services:
tags:
- { name: wordpress.element, alias: database, driver: wpcli }
+ wordpress.element.wpcli.filesystem:
+ class: "%wordpress.element.wpcli.filesystem.class%"
+ arguments:
+ - "@wordpress.wordpress"
+ tags:
+ - { name: wordpress.element, alias: filesystem, driver: wpcli }
+
wordpress.element.wpcli.plugin:
class: "%wordpress.element.wpcli.plugin.class%"
arguments:
diff --git a/src/ServiceContainer/config/drivers/wpphp.yml b/src/ServiceContainer/config/drivers/wpphp.yml
index 7454a726..2e318aa8 100755
--- a/src/ServiceContainer/config/drivers/wpphp.yml
+++ b/src/ServiceContainer/config/drivers/wpphp.yml
@@ -4,6 +4,7 @@ parameters:
wordpress.element.wpphp.comment.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpphp\CommentElement
wordpress.element.wpphp.content.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpphp\ContentElement
wordpress.element.wpphp.database.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpphp\DatabaseElement
+ wordpress.element.wpphp.filesystem.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpphp\FilesystemElement
wordpress.element.wpphp.plugin.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpphp\PluginElement
wordpress.element.wpphp.term.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpphp\TermElement
wordpress.element.wpphp.theme.class: PaulGibbs\WordpressBehatExtension\Driver\Element\Wpphp\ThemeElement
@@ -46,6 +47,13 @@ services:
tags:
- { name: wordpress.element, alias: database, driver: wpphp }
+ wordpress.element.wpphp.filesystem:
+ class: "%wordpress.element.wpphp.filesystem.class%"
+ arguments:
+ - "@wordpress.wordpress"
+ tags:
+ - { name: wordpress.element, alias: filesystem, driver: wpphp }
+
wordpress.element.wpphp.plugin:
class: "%wordpress.element.wpphp.plugin.class%"
arguments:
diff --git a/tests/app/behat-ci.yml b/tests/app/behat-ci.yml
new file mode 100644
index 00000000..8ff1f179
--- /dev/null
+++ b/tests/app/behat-ci.yml
@@ -0,0 +1,52 @@
+default:
+ suites:
+ default:
+ paths:
+ - '%paths.base%/../../features'
+ contexts:
+ - PaulGibbs\WordpressBehatExtension\Context\WordpressContext
+ - Behat\MinkExtension\Context\MinkContext
+ - PaulGibbs\WordpressBehatExtension\Context\ContentContext
+ - PaulGibbs\WordpressBehatExtension\Context\DashboardContext
+ - PaulGibbs\WordpressBehatExtension\Context\SiteContext
+ - PaulGibbs\WordpressBehatExtension\Context\UserContext
+ - PaulGibbs\WordpressBehatExtension\Context\EditPostContext
+ - PaulGibbs\WordpressBehatExtension\Context\WidgetContext
+ - PaulGibbs\WordpressBehatExtension\Context\ToolbarContext
+ - PaulGibbs\WordpressBehatExtension\Context\DebugContext
+ - FailAid\Context\FailureContext
+
+ extensions:
+ DMore\ChromeExtension\Behat\ServiceContainer\ChromeExtension: ~
+
+ Behat\MinkExtension:
+ base_url: http://localhost:8000
+ browser_name: chrome
+ default_session: headless
+ javascript_session: javascript
+ sessions:
+ headless:
+ goutte:
+ guzzle_parameters:
+ verify: false
+ javascript:
+ chrome:
+ api_url: http://localhost:9222
+ validate_certificate: false
+
+ PaulGibbs\WordpressBehatExtension:
+ path: tests/app/www/
+ users:
+ -
+ roles:
+ - administrator
+ username: admin
+ password: password
+ database:
+ restore_after_test: true
+ wpcli:
+ binary: vendor/bin/wp
+
+ FailAid\Extension:
+ screenshotDirectory: '%paths.base%/../artifacts'
+ screenshotMode: default
diff --git a/tests/artifacts/.gitkeep b/tests/artifacts/.gitkeep
new file mode 100644
index 00000000..e8e7b62c
--- /dev/null
+++ b/tests/artifacts/.gitkeep
@@ -0,0 +1 @@
+# Folder is required for test suite.
diff --git a/wp-cli.yml b/wp-cli.yml
new file mode 100644
index 00000000..779af82c
--- /dev/null
+++ b/wp-cli.yml
@@ -0,0 +1,3 @@
+@dev:
+ ssh: vagrant@behat.local
+ path: /vagrant/wp