A boilerplate for Testing WordPress with Behat

Requires

PHP 5.6 or later
Composer 1.2 or later

How to try

If you have a VCCW based environment, it is easy to try.

But if you don't have it, please see customizing section.

Then git clone this repository and install dependencies.

$ git clone git@github.com:vccw-team/boilerplate-behat-wordpress.git
$ cd boilerplate-behat-wordpress
$ composer install
$ npm install

Finally, run behat tests.

$ npm test

Then you can see the result like following.

$ npm test

> wordpress-behat@1.0.0 test /Users/miyauchi/Desktop/boilerplate-behat-wordpress
> /usr/bin/env node bin/run-tests.js

Feature: Example Features

  Scenario: Login as the "administrator" role # features/sample.feature:3
    When I login as the "administrator" role  # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::login_as_the_role()
    And I am on "/wp-admin/"                  # Behat\MinkExtension\Context\MinkContext::visit()
    Then I should see "Dashboard"             # Behat\MinkExtension\Context\MinkContext::assertPageContainsText()

  Scenario: Take a screenshot                                          # features/sample.feature:9
    Given the screen size is 1440x900                                  # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::set_window_size()
    And I login as the "administrator" role                            # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::login_as_the_role()
    When I am on "/"                                                   # Behat\MinkExtension\Context\MinkContext::visit()
    Then take a screenshot and save it to "_out/1440x900.png"          # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::take_a_screenshot()
    When I am on "/wp-admin/"                                          # Behat\MinkExtension\Context\MinkContext::visit()
    Then take a screenshot and save it to "_out/1440x900-wp-admin.png" # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::take_a_screenshot()
    Given the screen size is 320x400                                   # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::set_window_size()
    When I am on "/"                                                   # Behat\MinkExtension\Context\MinkContext::visit()
    Then take a screenshot and save it to "_out/320x400.png"           # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::take_a_screenshot()
    When I am on "/wp-admin/"                                          # Behat\MinkExtension\Context\MinkContext::visit()
    Then take a screenshot and save it to "_out/320x400-wp-admin.png"  # VCCW\Behat\Mink\WordPressExtension\Context\WordPressContext::take_a_screenshot()

2 個のシナリオ (2 個成功)
14 個のステップ (14 個成功)
0m6.89s (10.84Mb)

And also, you can see the screenshot in the _out directory.

Customizing

Create a configuration

Please copy and edit the behat.yml.dist to behat.yml like following.

Update the user account information

Please update the user name and password for administrator.

https://github.com/vccw-team/boilerplate-behat-wordpress/blob/master/behat.yml.dist#L14-L15

If you want to add additional user please add like following.

extensions:
  VCCW\Behat\Mink\WordPressExtension:
    roles:
      administrator:
        username: admin
        password: admin
      me:
        username: me
        password: 1111

You can use me like following in the *.feature.

Given I login as the "me" role

Update the URL to run test

You can set the URL in the base_url section.

https://github.com/vccw-team/boilerplate-behat-wordpress/blob/master/behat.yml.dist#L17

Add your own tests

*.feature files in the features/ directory are files which are recipe for the tests, so you can add *.feature to this directory.

Additional examples are in the following.

https://github.com/vccw-team/wordpress-mink-extension/tree/master/features

License

MIT