You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
229 lines
10 KiB
229 lines
10 KiB
<?php
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// Moodle is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
/**
|
|
* Navigation step definition overrides for the Classic theme.
|
|
*
|
|
* @package theme_classic
|
|
* @category test
|
|
* @copyright 2019 Michael Hawkins
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
// NOTE: No MOODLE_INTERNAL test here, this file may be required by behat before including /config.php.
|
|
|
|
require_once(__DIR__ . '/../../../../lib/tests/behat/behat_navigation.php');
|
|
|
|
use Behat\Mink\Exception\ExpectationException as ExpectationException;
|
|
use Behat\Mink\Exception\ElementNotFoundException as ElementNotFoundException;
|
|
|
|
/**
|
|
* Step definitions and overrides to navigate through the navigation tree nodes in the Classic theme.
|
|
*
|
|
* @package theme_classic
|
|
* @category test
|
|
* @copyright 2019 Michael Hawkins
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class behat_theme_classic_behat_navigation extends behat_navigation {
|
|
/**
|
|
* Navigate to an item in a current page administration menu.
|
|
*
|
|
* @throws ExpectationException
|
|
* @param string $nodetext The navigation node/path to follow, eg "Course administration > Edit settings"
|
|
* @return void
|
|
*/
|
|
public function i_navigate_to_in_current_page_administration($nodetext) {
|
|
$parentnodes = array_map('trim', explode('>', $nodetext));
|
|
|
|
// Find the name of the first category of the administration block tree.
|
|
$xpath = "//section[contains(@class,'block_settings')]//div[@id='settingsnav']/ul[1]/li[1]/p[1]/span";
|
|
$node = $this->find('xpath', $xpath);
|
|
|
|
array_unshift($parentnodes, $node->getText());
|
|
$lastnode = array_pop($parentnodes);
|
|
$this->select_node_in_navigation($lastnode, $parentnodes);
|
|
}
|
|
|
|
/**
|
|
* Navigate to an item within the site administration menu.
|
|
*
|
|
* @throws ExpectationException
|
|
* @param string $nodetext The navigation node/path to follow, excluding "Site administration" itself, eg "Grades > Scales"
|
|
* @return void
|
|
*/
|
|
public function i_navigate_to_in_site_administration($nodetext) {
|
|
$parentnodes = array_map('trim', explode('>', $nodetext));
|
|
array_unshift($parentnodes, get_string('administrationsite'));
|
|
$lastnode = array_pop($parentnodes);
|
|
$this->select_node_in_navigation($lastnode, $parentnodes);
|
|
}
|
|
|
|
/**
|
|
* Helper function to get top navigation node in the tree.
|
|
*
|
|
* @throws ExpectationException if node not found.
|
|
* @param string $nodetext name of top navigation node in tree.
|
|
* @return NodeElement
|
|
*/
|
|
protected function get_top_navigation_node($nodetext) {
|
|
// Avoid problems with quotes.
|
|
$nodetextliteral = behat_context_helper::escape($nodetext);
|
|
$exception = new ExpectationException('Top navigation node "' . $nodetext . '" not found', $this->getSession());
|
|
|
|
$xpath = // Navigation block.
|
|
"//div[contains(concat(' ', normalize-space(@class), ' '), ' content ')]" .
|
|
"/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" .
|
|
"/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
|
|
"/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
|
|
"[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
|
|
"[span[normalize-space(.)={$nodetextliteral}] or a[normalize-space(.)={$nodetextliteral}]]]" .
|
|
"|" .
|
|
// Administration block.
|
|
"//div[contains(concat(' ', normalize-space(@class), ' '), ' content ')]/div" .
|
|
"/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" .
|
|
"/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
|
|
"/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
|
|
"[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
|
|
"/span[normalize-space(.)={$nodetextliteral}]]" .
|
|
"|" .
|
|
"//div[contains(concat(' ', normalize-space(@class), ' '), ' content ')]/div" .
|
|
"/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" .
|
|
"/li[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
|
|
"/span[normalize-space(.)={$nodetextliteral}]]" .
|
|
"|" .
|
|
"//div[contains(concat(' ', normalize-space(@class), ' '), ' content ')]/div" .
|
|
"/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" .
|
|
"/li[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
|
|
"/a[normalize-space(.)={$nodetextliteral}]]";
|
|
|
|
$node = $this->find('xpath', $xpath, $exception);
|
|
|
|
return $node;
|
|
}
|
|
|
|
/**
|
|
* Check that current page administration contains an element.
|
|
*
|
|
* @throws ElementNotFoundException
|
|
* @param string $element The locator of the specified selector.
|
|
* This may be a path, for example "Subscription mode > Forced subscription"
|
|
* @param string $selectortype The selector type (link or text)
|
|
* @return void
|
|
*/
|
|
public function should_exist_in_current_page_administration($element, $selectortype) {
|
|
$nodes = array_map('trim', explode('>', $element));
|
|
$nodetext = end($nodes);
|
|
|
|
// Find administration menu.
|
|
$rootxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu(true);
|
|
$menuxpath = $rootxpath . '/p/../ul[1]';
|
|
|
|
for ($i = 0; $i < (count($nodes) - 1); $i++) {
|
|
$menuxpath .= "/li/p/span[contains(text(), '{$nodes[$i]}')]/../../ul[1]";
|
|
}
|
|
|
|
if ($selectortype == 'link') {
|
|
$menuxpath .= "/li/p[a[contains(text(), '{$nodetext}')]";
|
|
$menuxpath .= "|a/span[contains(text(), '{$nodetext}')]]";
|
|
} else {
|
|
$menuxpath .= "/li/p/span[contains(text(), '{$nodes[$i]}')]";
|
|
}
|
|
|
|
$exception = new ElementNotFoundException($this->getSession(), "\"{$element}\" \"{$selectortype}\"");
|
|
$this->find('xpath', $menuxpath, $exception);
|
|
}
|
|
|
|
/**
|
|
* Check that current page administration does not contains an element.
|
|
*
|
|
* @throws ExpectationException
|
|
* @param string $element The locator of the specified selector.
|
|
* This may be a path, for example "Subscription mode > Forced subscription"
|
|
* @param string $selectortype The selector type (link or text)
|
|
* @return void
|
|
*/
|
|
public function should_not_exist_in_current_page_administration($element, $selectortype) {
|
|
try {
|
|
$menuxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu(true);
|
|
} catch (Exception $e) {
|
|
// If an exception was thrown, it means the root note does not exist, so we can conclude the test is a success.
|
|
return;
|
|
}
|
|
|
|
// Test if the element exists.
|
|
try {
|
|
$this->should_exist_in_current_page_administration($element, $selectortype);
|
|
} catch (ElementNotFoundException $e) {
|
|
|
|
// If an exception was thrown, it means the element does not exist, so the test is successful.
|
|
return;
|
|
}
|
|
|
|
// If the try block passed, the element exists, so throw an exception.
|
|
$exception = 'The "' . $element . '" "' . $selectortype . '" was found, but should not exist';
|
|
throw new ExpectationException($exception, $this->getSession());
|
|
}
|
|
|
|
/**
|
|
* Check that the page administration menu exists on the page.
|
|
*
|
|
* This confirms the existence of the menu, which authorised users should have access to.
|
|
* @Given /^I should see the page administration menu$/
|
|
*
|
|
* @throws ExpectationException
|
|
* @return void
|
|
*/
|
|
public function page_administration_exists() {
|
|
$menuxpath = "//section[contains(@class,'block_settings')]//div[@id='settingsnav']";
|
|
$this->ensure_element_exists($menuxpath, 'xpath_element');
|
|
}
|
|
|
|
/**
|
|
* Check that the page administration menu does not exist on the page.
|
|
*
|
|
* This confirms the absence of the menu, which unauthorised users should not have access to.
|
|
* @Given /^I should not see the page administration menu$/
|
|
*
|
|
* @throws ExpectationException
|
|
* @return void
|
|
*/
|
|
public function page_administration_does_not_exist() {
|
|
$menuxpath = "//section[contains(@class,'block_settings')]//div[@id='settingsnav']";
|
|
$this->ensure_element_does_not_exist($menuxpath, 'xpath_element');
|
|
}
|
|
|
|
/**
|
|
* Locate the administration menu on the page (but not in the header) and return its xpath.
|
|
*
|
|
* @throws ElementNotFoundException
|
|
* @param bool $mustexist If true, throws an exception if menu is not found
|
|
* @return null|string
|
|
*/
|
|
protected function find_page_administration_menu($mustexist = false) {
|
|
$menuxpath = "//section[contains(@class,'block_settings')]//div[@id='settingsnav']/ul[1]/li[1]";
|
|
|
|
if ($mustexist) {
|
|
$exception = new ElementNotFoundException($this->getSession(), 'Page administration menu is not found');
|
|
$this->find('xpath', $menuxpath, $exception);
|
|
|
|
} else if (!$this->getSession()->getPage()->find('xpath', $menuxpath)) {
|
|
return null;
|
|
}
|
|
|
|
return $menuxpath;
|
|
}
|
|
}
|
|
|