Merge pull request #25 from pritalpatel/gherkin-feature-users

Adding users.feature scenarios using gherkin

.gitignore

@@ -26,7 +26,6 @@ tests/codeception/_output/*
 tests/codeception/vendor/*
 tests/codeception/testingsite*
 tests/codeception/tests/acceptance.suite.yml
-tests/codeception/tests/acceptance/*Tester.php
 tests/codeception/tests/functional/*Tester.php
 tests/codeception/tests/unit/*Tester.php
 

RoboFile.php

@@ -274,6 +274,15 @@ public function runTests($opts = ['use-htaccess' => false, 'env' => 'desktop'])
 			->stopOnFail();
 
 		$this->taskCodecept($pathToCodeception)
+			->arg('--steps')
+			->arg('--debug')
+			->arg('--fail-fast')
+			->arg('--env ' . $opts['env'])
+			->arg('tests/acceptance/users.feature')
+			->run()
+			->stopOnFail();
+
+	/*	$this->taskCodecept($pathToCodeception)
 			->arg('--steps')
 			->arg('--debug')
 			->arg('--fail-fast')
@@ -289,7 +298,7 @@ public function runTests($opts = ['use-htaccess' => false, 'env' => 'desktop'])
 			->arg('--env ' . $opts['env'])
 			->arg('tests/acceptance/frontend/')
 			->run()
-			->stopOnFail();
+			->stopOnFail();*/
 
 		/*
 		// Uncomment this lines if you need to debug selenium errors

tests/_support/AcceptanceTester.php

@@ -1,5 +1,8 @@
 <?php
 
+use Page\Acceptance\Administrator\LoginPage;
+
+use Page\Acceptance\Administrator\AdminPage;
 
 /**
  * Inherited Methods
@@ -12,15 +15,226 @@
  * @method void am($role)
  * @method void lookForwardTo($achieveValue)
  * @method void comment($description)
- * @method \Codeception\Lib\Friend haveFriend($name, $actorClass = NULL)
+ * @method \Codeception\Lib\Friend haveFriend($name, $actorClass = null)
  *
  * @SuppressWarnings(PHPMD)
-*/
+ */
 class AcceptanceTester extends \Codeception\Actor
 {
-    use _generated\AcceptanceTesterActions;
+	use _generated\AcceptanceTesterActions;
+
+	/**
+	 * Install joomla CMS
+	 *
+	 * @Given Joomla CMS is installed
+	 */
+	public function joomlaCMSIsInstalled()
+	{
+		// throw new \Codeception\Exception\Incomplete("Step `Joomla CMS is installed` is not defined");
+	}
+
+	/**
+	 * @When Login into Joomla administrator with username :arg1 and password :arg1
+	 */
+	public function loginIntoJoomlaAdministrator($username, $password)
+	{
+		$I = $this;
+		$I->amOnPage('administrator/');
+		$I->fillField(LoginPage::$usernameField, $username);
+		$I->fillField(LoginPage::$passwordField, $password);
+		$I->click(LoginPage::$loginButton);
+	}
+
+	/**
+	 * @Then I see administrator dashboard
+	 */
+	public function iSeeAdministratorDashboard()
+	{
+		$I = $this;
+		$I->waitForText(AdminPage::$controlPanelText, 4, AdminPage::$pageTitle);
+	}
+
+	/**
+	 * Method is to set Wait for page title
+	 *
+	 * @param   string   $title    Page Title text
+	 * @param   integer  $timeout  timeout time
+	 *
+	 * @return  void
+	 */
+	public function waitForPageTitle($title, $timeout = 60)
+	{
+		$I = $this;
+		$I->waitForText($title, $timeout, AdminPage::$pageTitle);
+	}
+
+	/**
+	 * Function to check for PHP Notices or Warnings
+	 *
+	 * @param string $page Optional, if not given checks will be done in the current page
+	 *
+	 * @note: doAdminLogin() before
+	 */
+	public function checkForPhpNoticesOrWarnings($page = null)
+	{
+		$I = $this;
+
+		if ($page)
+		{
+			$I->amOnPage($page);
+		}
+
+		$I->dontSeeInPageSource('Notice:');
+		$I->dontSeeInPageSource('<b>Notice</b>:');
+		$I->dontSeeInPageSource('Warning:');
+		$I->dontSeeInPageSource('<b>Warning</b>:');
+		$I->dontSeeInPageSource('Strict standards:');
+		$I->dontSeeInPageSource('<b>Strict standards</b>:');
+		$I->dontSeeInPageSource('The requested page can\'t be found');
+	}
+
+	/**
+	 * Function to select Toolbar buttons in Joomla! Admin Toolbar Panel
+	 *
+	 * @param   string  $button  The full name of the button
+	 *
+	 * @return  void
+	 */
+	public function clickToolbarButton($button)
+	{
+		$I = $this;
+		$input = strtolower($button);
+
+		// @todo Needs to find way to work with different window size.
+		$screenSize = explode("x", $this->getConfiguration('window_size'));
+
+		if ($screenSize[0] <= 480)
+		{
+			$I->click('Toolbar');
+		}
+
+		switch ($input)
+		{
+			case "new":
+				$I->click(['xpath' => "//div[@id='toolbar-new']//button"]);
+				break;
+			case "edit":
+				$I->click(['xpath' => "//div[@id='toolbar-edit']//button"]);
+				break;
+			case "publish":
+				$I->click(['xpath' => "//div[@id='toolbar-publish']//button"]);
+				break;
+			case "unpublish":
+				$I->click(['xpath' => "//div[@id='toolbar-unpublish']//button"]);
+				break;
+			case "archive":
+				$I->click(['xpath' => "//div[@id='toolbar-archive']//button"]);
+				break;
+			case "check-in":
+				$I->click(['xpath' => "//div[@id='toolbar-checkin']//button"]);
+				break;
+			case "batch":
+				$I->click(['xpath' => "//div[@id='toolbar-batch']//button"]);
+				break;
+			case "rebuild":
+				$I->click(['xpath' => "//div[@id='toolbar-refresh']//button"]);
+				break;
+			case "trash":
+				$I->click(['xpath' => "//div[@id='toolbar-trash']//button"]);
+				break;
+			case "save":
+				$I->click(['xpath' => "//div[@id='toolbar-apply']//button"]);
+				break;
+			case "save & close":
+				$I->click(['xpath' => "//div[@id='toolbar-save']//button"]);
+				break;
+			case "save & new":
+				$I->click(['xpath' => "//div[@id='toolbar-save-new']//button"]);
+				break;
+			case "cancel":
+				$I->click(['xpath' => "//div[@id='toolbar-cancel']//button"]);
+				break;
+			case "options":
+				$I->click(['xpath' => "//div[@id='toolbar-options']//button"]);
+				break;
+			case "empty trash":
+				$I->click(['xpath' => "//div[@id='toolbar-delete']//button"]);
+				break;
+			case "unblock":
+				$I->click(['xpath' => "//div[@id='toolbar-unblock']//button"]);
+				break;
+			case "delete":
+				$I->click(['xpath' => "//div[@id='toolbar-delete']//button"]);
+				break;
+			case "featured":
+				$I->click(['xpath' => "//div[@id='toolbar-featured']//button"]);
+				break;
+		}
+	}
+
+	/**
+	 * Function to select all the item in the Search results in Administrator List
+	 *
+	 * Note: We recommend use of checkAllResults function only after searchForItem to be sure you are selecting only the desired result set
+	 *
+	 * @return void
+	 */
+	public function checkAllResults()
+	{
+		$I = $this;
+		$this->comment("Selecting Checkall button");
+		$I->click(['xpath' => "//thead//input[@name='checkall-toggle' or @name='toggle']"]);
+	}
+
+	/**
+	 * Selects an option in a Chosen Selector based on its id
+	 *
+	 * @param   string  $selectId  The id of the <select> element
+	 * @param   string  $option    The text in the <option> to be selected in the chosen selector
+	 *
+	 * @return void
+	 */
+	public function selectOptionInChosenById($selectId, $option)
+	{
+		$chosenSelectID = $selectId . '_chzn';
+		$I = $this;
+		$this->comment("I open the $chosenSelectID chosen selector");
+		$I->click(['xpath' => "//div[@id='$chosenSelectID']/a/div/b"]);
+		$this->comment("I select $option");
+		$I->click(['xpath' => "//div[@id='$chosenSelectID']//li[text()='$option']"]);
+		$I->wait(1); // Gives time to chosen to close
+	}
+	/**
+	 * Function to Verify the Tabs on a Joomla! screen
+	 *
+	 * @param  Array  $expectedTabs   Expected Tabs on the Page
+	 * @param  Mixed  $tabsLocator    Locator for the Tabs in Edit View
+	 *
+	 * @return void
+	 */
+	public function verifyAvailableTabs($expectedTabs, $tabsLocator = ['xpath' => "//ul[@id='myTabTabs']/li/a"])
+	{
+		$I = $this;
+		$actualArrayOfTabs = $I->grabMultiple($tabsLocator);
+		$I->comment("Fetch the current list of Tabs in the edit view which is: " . implode(", ", $actualArrayOfTabs));
+		$url = $I->grabFromCurrentUrl();
+		$I->assertEquals($expectedTabs, $actualArrayOfTabs, "Tab Labels do not match on edit view of" . $url);
+		$I->comment('Verify the Tabs');
+	}
+	/**
+	 * Function to Logout from Administrator Panel in Joomla!
+	 *
+	 * @return void
+	 */
+	public function doAdministratorLogout()
+	{
+		$I = $this;
+		$I->click(['xpath' => "//ul[@class='nav nav-user pull-right']//li//a[@class='dropdown-toggle']"]);
+		$this->comment("I click on Top Right corner toggle to Logout from Admin");
+		$I->waitForElement(['xpath' => "//li[@class='dropdown open']/ul[@class='dropdown-menu']//a[text() = 'Logout']"], 60);
+		$I->click(['xpath' => "//li[@class='dropdown open']/ul[@class='dropdown-menu']//a[text() = 'Logout']"]);
+		$I->waitForElement(['id' => 'mod-login-username'], 60);
+		$I->waitForText('Log in', 60, ['xpath' => "//fieldset[@class='loginform']//button"]);
 
-   /**
-    * Define custom actions here
-    */
+	}
 }

tests/_support/Page/Acceptance/Administrator/AdminPage.php

@@ -0,0 +1,11 @@
+<?php
+namespace Page\Acceptance\Administrator;
+
+class AdminPage extends \AcceptanceTester
+{
+    public static $systemMessageContainer = ['id' => 'system-message-container'];
+
+    public static $pageTitle = ['class' => 'page-title'];
+
+    public static $controlPanelText = "Control Panel";
+}

tests/_support/Page/Acceptance/Administrator/Login.php

@@ -4,14 +4,33 @@
 class Login extends \AcceptanceTester
 {
 	/**
-     * @When I login into Joomla Administrator with username :arg1 and password :arg1
-     */
-    public function login($username, $password)
-    {
-			$I = $this;
-			$I->amOnPage('administrator/');
-			$I->fillField(['css' => 'input[data-tests="username"]'], $username);
-			$I->fillField(['css' => 'input[data-tests="password"]'], $password);
-			$I->click(['css' => 'button[data-tests="log in"]']);
-    }
+	 * Install joomla CMS
+	 *
+	 * @Given Joomla CMS is installed
+	 */
+	public function joomlaCMSIsInstalled()
+	{
+		// throw new \Codeception\Exception\Incomplete("Step `Joomla CMS is installed` is not defined");
+	}
+
+	/**
+	 * @When Login into Joomla administrator with username :arg1 and password :arg1
+	 */
+	public function loginIntoJoomlaAdministrator($username, $password)
+	{
+		$I = $this;
+		$I->amOnPage('administrator/');
+		$I->fillField(['css' => 'input[data-tests="username"]'], $username);
+		$I->fillField(['css' => 'input[data-tests="password"]'], $password);
+		$I->click(['css' => 'button[data-tests="log in"]']);
+	}
+
+	/**
+	 * @Then I see administrator dashboard
+	 */
+	public function iSeeAdministratorDashboard()
+	{
+		$I = $this;
+		$I->waitForPageTitle('Control Panel', 4);
+	}
 }

tests/_support/Page/Acceptance/Administrator/LoginPage.php

@@ -0,0 +1,17 @@
+<?php
+namespace Page\Acceptance\Administrator;
+
+use Page\Acceptance\Administrator\AdminPage;
+
+class LoginPage extends AdminPage
+{
+    public static $usernameField = ['css' => 'input[data-tests="username"]'];
+
+    public static $passwordField = ['css' => 'input[data-tests="password"]'];
+
+    public static $pageTitle = ['class' => 'page-title'];
+
+    public static $loginButton = ['css' => 'button[data-tests="log in"]'];
+
+    public static $pageURL = "/administrator/index.php";
+}

tests/_support/Page/Acceptance/Administrator/UserManagerPage.php

@@ -0,0 +1,30 @@
+<?php
+namespace Page\Acceptance\Administrator;
+
+use Page\Acceptance\Administrator\AdminPage;
+
+class UserManagerPage extends AdminPage
+{
+    public static $nameField = ['id' => 'jform_name'];
+
+    public static $usernameField = ['id' => 'jform_username'];
+
+    public static $passwordField = ['id' => 'jform_password'];
+
+    public static $password2Field = ['id' => 'jform_password2'];
+
+    public static $emailField = ['id' => 'jform_email'];
+
+    public static $filterSearch = ['id' => 'filter_search'];
+
+    public static $iconSearch = ['class' => 'icon-search'];
+
+    public static $title = ['id' => 'jform_title'];
+
+    public static $pageURL = "administrator/index.php?option=com_users&view=users";
+
+    public static $groupPageURL = "administrator/index.php?option=com_users&view=groups";
+
+    public static $aclPageURL = "administrator/index.php?option=com_users&view=levels";
+
+}