diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml new file mode 100644 index 0000000..f8e96e9 --- /dev/null +++ b/.github/workflows/main.yml @@ -0,0 +1,11 @@ +name: Module CI + +on: + push: + pull_request: + +jobs: + ci: + uses: silverstripe/github-actions-ci-cd/.github/workflows/ci.yml@0.1.11 + with: + run_endtoend: true diff --git a/.travis.yml b/.travis.yml index 785d9ea..53088ed 100755 --- a/.travis.yml +++ b/.travis.yml @@ -1,4 +1,10 @@ version: ~> 1.0 import: - - silverstripe/silverstripe-travis-shared:config/provision/standard-jobs-range-npm.yml + - silverstripe/silverstripe-travis-shared:config/provision/standard-jobs-range-behat-npm.yml + +env: + global: + - COMPOSER_ROOT_VERSION=2.x-dev + # Required for behat testing + - REQUIRE_EXTRA="silverstripe/widgets:^2 silverstripe/comments:^3 silverstripe/content-widget:^2" diff --git a/behat.yml b/behat.yml new file mode 100644 index 0000000..0b699a4 --- /dev/null +++ b/behat.yml @@ -0,0 +1,29 @@ +default: + suites: + blog: + paths: + - "%paths.modules.blog%/tests/behat/features" + contexts: + - SilverStripe\Admin\Tests\Behat\Context\AdminContext + - SilverStripe\BehatExtension\Context\BasicContext + - SilverStripe\BehatExtension\Context\EmailContext + - SilverStripe\BehatExtension\Context\LoginContext + - SilverStripe\Framework\Tests\Behaviour\CmsFormsContext + - SilverStripe\Framework\Tests\Behaviour\CmsUiContext + - SilverStripe\Blog\Tests\Behat\Context\FeatureContext + - SilverStripe\Blog\Tests\Behat\Context\FixtureContext + - + SilverStripe\Blog\Tests\Behat\Context\FixtureContext: + - "%paths.modules.blog%/tests/behat/files/" + + extensions: + SilverStripe\BehatExtension\MinkExtension: + default_session: facebook_web_driver + javascript_session: facebook_web_driver + facebook_web_driver: + browser: chrome + wd_host: "http://127.0.0.1:9515" + + SilverStripe\BehatExtension\Extension: + screenshot_path: "%paths.base%/artifacts/screenshots" + bootstrap_file: vendor/silverstripe/framework/tests/behat/serve-bootstrap.php diff --git a/composer.json b/composer.json index 7db9426..bd21920 100755 --- a/composer.json +++ b/composer.json @@ -28,7 +28,8 @@ "autoload": { "psr-4": { "SilverStripe\\Blog\\": "src/", - "SilverStripe\\Blog\\Tests\\": "tests/" + "SilverStripe\\Blog\\Tests\\": "tests/php/", + "SilverStripe\\Blog\\Tests\\Behat\\Context\\": "tests/behat/src/" } }, "license": "BSD-2-Clause", diff --git a/tests/behat/_manifest_exclude b/tests/behat/_manifest_exclude new file mode 100644 index 0000000..e69de29 diff --git a/tests/behat/features/blog.feature b/tests/behat/features/blog.feature new file mode 100644 index 0000000..2630f27 --- /dev/null +++ b/tests/behat/features/blog.feature @@ -0,0 +1,121 @@ +Feature: Create a blog + As a website user + I want to create a blog + + Background: + Given the "group" "EDITOR group" has permissions "CMS_ACCESS_LeftAndMain" + And I add an extension "SilverStripe\Widgets\Extensions\WidgetPageExtension" to the "Page" class + And I add an extension "SilverStripe\Comments\Extensions\CommentsExtension" to the "Page" class + + Given I take a screenshot after every step + Given I dump the rendered HTML after every step + + And an "image" "Uploads/file1.jpg" + + # Login then logout to created member + And I am logged in with "EDITOR" permissions + And I go to "/Security/login" + And I press the "Log in as someone else" button + And I am logged in with "ADMIN" permissions + + # Create a new blog called "New Blog" + When I go to "/admin/pages" + And I press the "Add new" button + And I select the "Blog" radio button + And I press the "Create" button + + # Add widgets + And I click the "Widgets" CMS tab + And I uncheck "Inherit Sidebar From Parent" + And I add the "Content" widget + And I add the "Archive" widget + And I add the "Blog Tags" widget + And I fill in the "Content" widget field "Title" with "My content widget title" + And I fill in the "Content" widget HTML field "Content" with "

Content widget content

" + And I fill in the "Archive" widget field "Title" with "My archive widget title" + And I fill in the "Blog Tags" widget field "Title" with "My blog tags widget title" + And I press the "Save" button + + # Add EDITOR as an Editor + And I click the "Settings" CMS tab + And I click the "Users" CMS tab + And I select "EDITOR" from "Editors" + + # Publish and logout + And I press the "Publish" button + And I go to "/Security/login" + And I press the "Log in as someone else" button + + Scenario: Create a blog post + Given I log in with "EDITOR@example.org" and "Secret!123" + + # Create a new blog post called "New Post" + When I go to "/admin/pages" + And I follow "New Blog" + And I click the "Blog Posts" CMS tab + And I press the "Add new Blog Post" button + And I fill in "Post Title" with "New Post" + + # Add a "Featured image" + And I press the "Choose existing" button + + # Select file1.jpg - asset-admin FeatureContext is not available here so use css selector + And I click on the ".gallery__files .gallery-item" element + And I press the "Insert" button + + # Add categories and tags + And I click the "Post Options" CMS tab + And I add "My Category" to the "Categories" tag field + And I add "My Tag" to the "Tags" tag field + + # Publish the blog post + And I press the "Publish" button + + # Test the frontend + When I go to "/new-blog" + Then I should see "New Blog" + And I should see "New Post" + + # Widgets + And I should see "My content widget title" + And the rendered HTML should contain "

Content widget content

" + And I should see "My blog tags widget title" + + # Hyperlink to "New Post" + Then the rendered HTML should contain "href=\"/new-blog/new-post" + + # Category + And the rendered HTML should contain "href=\"/new-blog/category/my-category\"" + + # Tag + And the rendered HTML should contain "href=\"/new-blog/tag/my-tag\"" + + # Test that blog post shows in category view + When I go to "/new-blog/category/my-category" + Then I should see "New Post" + + # Test that blog post shows in tag view + When I go to "/new-blog/tag/my-tag" + Then I should see "New Post" + + # Commenting + When I fill in "Your name" with "My Name" + And I fill in "Email" with "hello@example.com" + And I fill in "Comments" with "My comments" + When I press the "Post" button + Then I should see "New Post" + + # Moderation + When I go to "/admin/pages" + And I follow "New Blog" + And I click the "Blog Posts" CMS tab + # Click on the first blog post + And I click on the ".col-Title" element + And I click the "Comments" CMS tab + Then I should see "Approved (1)" + When I click the "Approved (1)" CMS tab + Then I should see "hello@example.com" + When I click on the ".action-menu__toggle" element + And I press the "Spam" button + And I wait for 2 seconds + Then I should not see "hello@example.com" diff --git a/tests/behat/files/file1.jpg b/tests/behat/files/file1.jpg new file mode 100644 index 0000000..beb5a91 Binary files /dev/null and b/tests/behat/files/file1.jpg differ diff --git a/tests/behat/src/FeatureContext.php b/tests/behat/src/FeatureContext.php new file mode 100644 index 0000000..e656ff2 --- /dev/null +++ b/tests/behat/src/FeatureContext.php @@ -0,0 +1,105 @@ +getSession()->getPage(); + $h3s = $page->findAll('css', '.availableWidgetsHolder h3'); + $found = false; + foreach ($h3s as $h3) { + if ($h3->getText() !== $widgetTitle) { + continue; + } + $found = true; + $h3->click(); + } + Assert::assertTrue($found, "Widget {$widgetTitle} was not found"); + } + + /** + * Fills in a field within a widget + * + * @Then /^I fill in the "([^"]+)" widget field "([^"]+)" with "([^"]+)"$/ + * @param $widgetTitle e.g. "Content" + * @param $htmlFragment e.g. "Title" + * @param $value e.g. "Lorem ipsum" + */ + public function iFillInTheWidgetField($widgetTitle, $fieldTitle, $value) + { + $page = $this->getSession()->getPage(); + $widget = $this->getWidget($widgetTitle); + $field = $widget->findField($fieldTitle); + Assert::assertNotNull($field, "Widget field {$fieldTitle} was not found"); + $field->setValue($value); + } + + /** + * Adapated from framework CmsFormsContext stepIFillInTheHtmlFieldWith + * + * @When /^I fill in the "([^"]+)" widget HTML field "([^"]+)" with "([^"]+)"$/ + */ + public function stepIFillInTheHtmlFieldWith($widgetTitle, $fieldTitle, $value) + { + $widget = $this->getWidget($widgetTitle); + $field = $this->getDescendantHtmlField($widget, $fieldTitle); + $this->getSession()->evaluateScript(sprintf( + "jQuery('#%s').entwine('ss').getEditor().setContent('%s')", + $field->getAttribute('id'), + addcslashes($value, "'") + )); + $this->getSession()->evaluateScript(sprintf( + "jQuery('#%s').entwine('ss').getEditor().save()", + $field->getAttribute('id') + )); + } + + /** + * @return NodeElement|null + */ + private function getWidget($widgetTitle) + { + $ret = null; + $widgets = $this->getSession()->getPage()->findAll('css', '.usedWidgets .Widget'); + foreach ($widgets as $widget) { + $h3 = $widget->find('css', 'h3'); + if (!$h3 || $h3->getText() !== $widgetTitle) { + continue; + } + $ret = $widget; + break; + } + Assert::assertNotNull($ret, "Widget edit form for {$widgetTitle} was not found"); + return $ret; + } + + /** + * @param NodeElement $ancestor + * @param string $locator + * @return NodeElement|null + */ + private function getDescendantHtmlField($element, $locator) + { + $textarea = $element->find('css', "textarea.htmleditor[name='{$locator}']"); + if (is_null($textarea)) { + $labels = $element->findAll('xpath', "//label[contains(text(), '{$locator}')]"); + Assert::assertCount(1, $labels, "Found more than one html field label containing the phrase '{$locator}}'"); + $label = array_shift($labels); + $textarea = $element->find('css', '#' . $label->getAttribute('for')); + } + Assert::assertNotNull($textarea, "HTML field {$locator} not found"); + return $textarea; + } +} diff --git a/tests/behat/src/FixtureContext.php b/tests/behat/src/FixtureContext.php new file mode 100644 index 0000000..5940466 --- /dev/null +++ b/tests/behat/src/FixtureContext.php @@ -0,0 +1,9 @@ +