mirror of
https://github.com/moodle/moodle.git
synced 2025-08-06 09:26:35 +02:00
2263 lines
96 KiB
PHP
2263 lines
96 KiB
PHP
<?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/>.
|
|
|
|
/**
|
|
* Behat course-related steps definitions.
|
|
*
|
|
* @package core_course
|
|
* @category test
|
|
* @copyright 2012 David Monllaó
|
|
* @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/behat/behat_base.php');
|
|
|
|
use Behat\Gherkin\Node\TableNode as TableNode,
|
|
Behat\Mink\Exception\ExpectationException as ExpectationException,
|
|
Behat\Mink\Exception\DriverException as DriverException,
|
|
Behat\Mink\Exception\ElementNotFoundException as ElementNotFoundException;
|
|
|
|
/**
|
|
* Course-related steps definitions.
|
|
*
|
|
* @package core_course
|
|
* @category test
|
|
* @copyright 2012 David Monllaó
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class behat_course extends behat_base {
|
|
|
|
/**
|
|
* Return the list of partial named selectors.
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_partial_named_selectors(): array {
|
|
return [
|
|
new behat_component_named_selector(
|
|
'Activity chooser screen', [
|
|
"%core_course/activityChooser%//*[@data-region=%locator%][contains(concat(' ', @class, ' '), ' carousel-item ')]"
|
|
]
|
|
),
|
|
new behat_component_named_selector(
|
|
'Activity chooser tab', [
|
|
"%core_course/activityChooser%//*[@data-region=%locator%][contains(concat(' ', @class, ' '), ' tab-pane ')]"
|
|
]
|
|
),
|
|
new behat_component_named_selector(
|
|
'initials bar',
|
|
[".//*[contains(concat(' ', @class, ' '), ' initialbar ')]//span[contains(., %locator%)]/parent::div"]
|
|
),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Return a list of the Mink named replacements for the component.
|
|
*
|
|
* Named replacements allow you to define parts of an xpath that can be reused multiple times, or in multiple
|
|
* xpaths.
|
|
*
|
|
* This method should return a list of {@link behat_component_named_replacement} and the docs on that class explain
|
|
* how it works.
|
|
*
|
|
* @return behat_component_named_replacement[]
|
|
*/
|
|
public static function get_named_replacements(): array {
|
|
return [
|
|
new behat_component_named_replacement(
|
|
'activityChooser',
|
|
".//*[contains(concat(' ', @class, ' '), ' modchooser ')][contains(concat(' ', @class, ' '), ' modal-dialog ')]"
|
|
),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Creates a new course with the provided table data matching course settings names with the desired values.
|
|
*
|
|
* @Given /^I create a course with:$/
|
|
* @param TableNode $table The course data
|
|
*/
|
|
public function i_create_a_course_with(TableNode $table) {
|
|
|
|
// Go to course management page.
|
|
$this->i_go_to_the_courses_management_page();
|
|
// Ensure you are on course management page.
|
|
$this->execute("behat_course::i_should_see_the_courses_management_page", get_string('categoriesandcourses'));
|
|
|
|
// Select default course category.
|
|
$this->i_click_on_category_in_the_management_interface(get_string('defaultcategoryname'));
|
|
$this->execute("behat_course::i_should_see_the_courses_management_page", get_string('categoriesandcourses'));
|
|
|
|
// Click create new course.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
array(get_string('createnewcourse'), "link", "#course-listing", "css_element")
|
|
);
|
|
|
|
// If the course format is one of the fields we change how we
|
|
// fill the form as we need to wait for the form to be set.
|
|
$rowshash = $table->getRowsHash();
|
|
$formatfieldrefs = array(get_string('format'), 'format', 'id_format');
|
|
foreach ($formatfieldrefs as $fieldref) {
|
|
if (!empty($rowshash[$fieldref])) {
|
|
$formatfield = $fieldref;
|
|
}
|
|
}
|
|
|
|
// Setting the format separately.
|
|
if (!empty($formatfield)) {
|
|
|
|
// Removing the format field from the TableNode.
|
|
$rows = $table->getRows();
|
|
$formatvalue = $rowshash[$formatfield];
|
|
foreach ($rows as $key => $row) {
|
|
if ($row[0] == $formatfield) {
|
|
unset($rows[$key]);
|
|
}
|
|
}
|
|
$table = new TableNode($rows);
|
|
|
|
// Adding a forced wait until editors are loaded as otherwise selenium sometimes tries clicks on the
|
|
// format field when the editor is being rendered and the click misses the field coordinates.
|
|
$this->execute("behat_forms::i_expand_all_fieldsets");
|
|
|
|
$this->execute("behat_forms::i_set_the_field_to", array($formatfield, $formatvalue));
|
|
}
|
|
|
|
// Set form fields.
|
|
$this->execute("behat_forms::i_set_the_following_fields_to_these_values", $table);
|
|
|
|
// Save course settings.
|
|
$this->execute("behat_forms::press_button", get_string('savechangesanddisplay'));
|
|
|
|
}
|
|
|
|
/**
|
|
* Goes to the system courses/categories management page.
|
|
*
|
|
* @Given /^I go to the courses management page$/
|
|
*/
|
|
public function i_go_to_the_courses_management_page() {
|
|
|
|
$parentnodes = get_string('courses', 'admin');
|
|
|
|
// Go to home page.
|
|
$this->execute("behat_general::i_am_on_homepage");
|
|
|
|
// Navigate to course management via system administration.
|
|
$this->execute("behat_navigation::i_navigate_to_in_site_administration",
|
|
array($parentnodes . ' > ' . get_string('coursemgmt', 'admin'))
|
|
);
|
|
|
|
}
|
|
|
|
/**
|
|
* Convert page names to URLs for steps like 'When I am on the "[identifier]" "[page type]" page'.
|
|
*
|
|
* Recognised page names are:
|
|
* | Section | coursename > section | The selected course section. First it searchs by section name, then by section number. |
|
|
*
|
|
* Examples:
|
|
*
|
|
* When I am on the "Course 1 > Section 1" "course > section" page logged in as "admin"
|
|
* When I am on the "Course 1 > Named section" "course > section" page logged in as "admin"
|
|
*
|
|
* @param string $type
|
|
* @param string $identifier
|
|
* @return moodle_url
|
|
*/
|
|
protected function resolve_page_instance_url(string $type, string $identifier): moodle_url {
|
|
$type = strtolower($type);
|
|
|
|
$sectionpage = 'section.php';
|
|
switch ($type) {
|
|
case 'section settings':
|
|
$sectionpage = 'editsection.php';
|
|
case 'section':
|
|
$identifiers = explode('>', $identifier);
|
|
$identifiers = array_map('trim', $identifiers);
|
|
if (count($identifiers) < 2) {
|
|
throw new Exception("The specified section $identifier is not valid and should be coursename > section.");
|
|
}
|
|
[$courseidentifier, $sectionidentifier] = $identifiers;
|
|
|
|
$section = $this->get_section_and_course_by_id($courseidentifier, $sectionidentifier);
|
|
if (!$section) {
|
|
// If section is not found by name, search it by section number.
|
|
$sectionno = preg_replace("/^section (\d+)$/i", '$1', $sectionidentifier);
|
|
$section = $this->get_section_and_course_by_sectionnum($courseidentifier, (int) $sectionno);
|
|
}
|
|
if (!$section) {
|
|
throw new Exception("The specified section $identifier does not exist.");
|
|
}
|
|
return new moodle_url('/course/' . $sectionpage, ['id' => $section->id]);
|
|
}
|
|
throw new Exception('Unrecognised core page type "' . $type . '."');
|
|
}
|
|
|
|
/**
|
|
* Adds the selected activity/resource filling the form data with the specified field/value pairs.
|
|
*
|
|
* Sections 0 and 1 are also allowed on frontpage.
|
|
*
|
|
* @Given I add a :activity activity to course :coursefullname section :sectionnum and I fill the form with:
|
|
* @Given I add an :activity activity to course :coursefullname section :sectionnum and I fill the form with:
|
|
* @param string $activity The activity name
|
|
* @param string $coursefullname The course full name of the course.
|
|
* @param int $section The section number
|
|
* @param TableNode $data The activity field/value data
|
|
*/
|
|
public function i_add_to_course_section_and_i_fill_the_form_with($activity, $coursefullname, $section, TableNode $data) {
|
|
|
|
// Add activity to section.
|
|
$this->execute(
|
|
"behat_course::i_add_to_course_section",
|
|
[$this->escape($activity), $this->escape($coursefullname), $this->escape($section)]
|
|
);
|
|
|
|
// Wait to be redirected.
|
|
$this->execute('behat_general::wait_until_the_page_is_ready');
|
|
|
|
// Set form fields.
|
|
$this->execute("behat_forms::i_set_the_following_fields_to_these_values", $data);
|
|
|
|
// Save course settings.
|
|
$this->execute("behat_forms::press_button", get_string('savechangesandreturntocourse'));
|
|
}
|
|
|
|
/**
|
|
* Open a add activity form page.
|
|
*
|
|
* @Given I add a :activity activity to course :coursefullname section :sectionnum
|
|
* @Given I add an :activity activity to course :coursefullname section :sectionnum
|
|
* @throws coding_exception
|
|
* @param string $activity The activity name.
|
|
* @param string $coursefullname The course full name of the course.
|
|
* @param string $sectionnum The section number.
|
|
*/
|
|
public function i_add_to_course_section(string $activity, string $coursefullname, string $sectionnum): void {
|
|
$addurl = new moodle_url('/course/modedit.php', [
|
|
'add' => $activity,
|
|
'course' => $this->get_course_id($coursefullname),
|
|
'section' => intval($sectionnum),
|
|
]);
|
|
$this->execute('behat_general::i_visit', [$addurl]);
|
|
}
|
|
|
|
/**
|
|
* Opens the activity chooser and opens the activity/resource link form page. Sections 0 and 1 are also allowed on frontpage.
|
|
*
|
|
* This step require javascript enabled and it is used mainly to click activities or resources by name,
|
|
* not by plugin name. Use the standard behat_course::i_add_to_course_section step instead unless the
|
|
* plugin create extra entries into the activity chooser (like LTI).
|
|
*
|
|
* @Given I add a :activityname to section :sectionnum using the activity chooser
|
|
* @Given I add an :activityname to section :sectionnum using the activity chooser
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param string $activityname
|
|
* @param int $sectionnum
|
|
*/
|
|
public function i_add_to_section_using_the_activity_chooser($activityname, $sectionnum) {
|
|
|
|
$this->require_javascript('Please use the \'the following "activity" exists:\' data generator instead.');
|
|
|
|
$infrontpage = false;
|
|
if ($this->getSession()->getPage()->find('css', 'body#page-site-index') && (int) $sectionnum <= 1) {
|
|
// We are on the frontpage.
|
|
$infrontpage = true;
|
|
if ($sectionnum) {
|
|
// Section 1 represents the contents on the frontpage.
|
|
$sectionxpath = "//body[@id='page-site-index']" .
|
|
"/descendant::div[contains(concat(' ',normalize-space(@class),' '),' sitetopic ')]";
|
|
} else {
|
|
// Section 0 represents "Site main menu" block.
|
|
$sectionxpath = "//*[contains(concat(' ',normalize-space(@class),' '),' block_site_main_menu ')]";
|
|
}
|
|
} else {
|
|
// We are inside the course.
|
|
$sectionxpath = "//li[@id='section-" . $sectionnum . "']";
|
|
}
|
|
|
|
// Clicks add activity or resource section link.
|
|
$sectionnode = $this->find('xpath', $sectionxpath);
|
|
if (!$infrontpage) {
|
|
$this->execute('behat_general::i_click_on_in_the', [
|
|
"//button[@data-action='open-addingcontent' and not(@data-beforemod)]",
|
|
'xpath',
|
|
$sectionnode,
|
|
'NodeElement',
|
|
]);
|
|
}
|
|
$this->execute('behat_general::i_click_on_in_the', [
|
|
"//button[@data-action='open-chooser' and not(@data-beforemod)]",
|
|
'xpath',
|
|
$sectionnode,
|
|
'NodeElement',
|
|
]);
|
|
|
|
// Clicks the selected activity if it exists.
|
|
$activityliteral = behat_context_helper::escape(ucfirst($activityname));
|
|
$activityxpath = "//div[contains(concat(' ', normalize-space(@class), ' '), ' modchooser ')]" .
|
|
"/descendant::div[contains(concat(' ', normalize-space(@class), ' '), ' optioninfo ')]" .
|
|
"/descendant::div[contains(concat(' ', normalize-space(@class), ' '), ' optionname ')]" .
|
|
"[normalize-space(.)=$activityliteral]" .
|
|
"/parent::a";
|
|
|
|
$this->execute('behat_general::i_click_on', [$activityxpath, 'xpath']);
|
|
}
|
|
|
|
/**
|
|
* Opens a section edit menu if it is not already opened.
|
|
*
|
|
* @Given /^I open section "(?P<section>(?:[^"]|\\")*)" edit menu$/
|
|
* @throws DriverException The step is not available when Javascript is disabled
|
|
* @param string|int $section
|
|
*/
|
|
public function i_open_section_edit_menu($section) {
|
|
if (!$this->running_javascript()) {
|
|
throw new DriverException('Section edit menu not available when Javascript is disabled');
|
|
}
|
|
|
|
// Wait for section to be available, before clicking on the menu.
|
|
$this->i_wait_until_section_is_available($section);
|
|
|
|
// If it is already opened we do nothing.
|
|
$xpath = $this->section_exists($section);
|
|
$xpath .= "/descendant::div[contains(@class, 'section-actions')]/descendant::a[@data-toggle='dropdown']";
|
|
|
|
$exception = new ExpectationException('Section "' . $section . '" was not found', $this->getSession());
|
|
$menu = $this->find('xpath', $xpath, $exception);
|
|
$menu->click();
|
|
$this->i_wait_until_section_is_available($section);
|
|
}
|
|
|
|
/**
|
|
* Deletes course section.
|
|
*
|
|
* @Given /^I delete section "(?P<section_number>\d+)"$/
|
|
* @param int $sectionnumber The section number
|
|
*/
|
|
public function i_delete_section($sectionnumber) {
|
|
// Ensures the section exists.
|
|
$xpath = $this->section_exists($sectionnumber);
|
|
|
|
// We need to know the course format as the text strings depends on them.
|
|
$courseformat = $this->get_course_format();
|
|
if (get_string_manager()->string_exists('deletesection', $courseformat)) {
|
|
$strdelete = get_string('deletesection', $courseformat);
|
|
} else {
|
|
$strdelete = get_string('deletesection');
|
|
}
|
|
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($sectionnumber);
|
|
}
|
|
|
|
// Click on delete link.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
array($strdelete, "link", $this->escape($xpath), "xpath_element")
|
|
);
|
|
|
|
}
|
|
|
|
/**
|
|
* Turns course section highlighting on.
|
|
*
|
|
* @Given /^I turn section "(?P<section_number>\d+)" highlighting on$/
|
|
* @param int $sectionnumber The section number
|
|
*/
|
|
public function i_turn_section_highlighting_on($sectionnumber) {
|
|
|
|
// Ensures the section exists.
|
|
$xpath = $this->section_exists($sectionnumber);
|
|
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($sectionnumber);
|
|
}
|
|
|
|
// Click on highlight topic link.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
array(get_string('highlight'), "link", $this->escape($xpath), "xpath_element")
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Turns course section highlighting off.
|
|
*
|
|
* @Given /^I turn section "(?P<section_number>\d+)" highlighting off$/
|
|
* @param int $sectionnumber The section number
|
|
*/
|
|
public function i_turn_section_highlighting_off($sectionnumber) {
|
|
|
|
// Ensures the section exists.
|
|
$xpath = $this->section_exists($sectionnumber);
|
|
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($sectionnumber);
|
|
}
|
|
|
|
// Click on un-highlight topic link.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
array(get_string('highlightoff'), "link", $this->escape($xpath), "xpath_element")
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Shows the specified hidden section. You need to be in the course page and on editing mode.
|
|
*
|
|
* @Given /^I show section "(?P<section>(?:[^"]|\\")*)"$/
|
|
* @param int|string $section
|
|
*/
|
|
public function i_show_section($section) {
|
|
// Ensures the section exists.
|
|
$xpath = $this->section_exists($section);
|
|
// We need to know the course format as the text strings depends on them.
|
|
$courseformat = $this->get_course_format();
|
|
$strshow = get_string('showfromothers', $courseformat);
|
|
|
|
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($section);
|
|
}
|
|
|
|
// Ensure the click is using the action menu and not the visibility badge.
|
|
$xpath .= "//*[@role='menu']";
|
|
|
|
// Click on hide link.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
[$strshow, "link", $this->escape($xpath), "xpath_element"]
|
|
);
|
|
|
|
if ($this->running_javascript()) {
|
|
$this->getSession()->wait(self::get_timeout() * 1000, self::PAGE_READY_JS);
|
|
$this->i_wait_until_section_is_available($section);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Hides the specified visible section. You need to be in the course page and on editing mode.
|
|
*
|
|
* @Given /^I hide section "(?P<section>(?:[^"]|\\")*)"$/
|
|
* @param int|string $section
|
|
*/
|
|
public function i_hide_section($section) {
|
|
// Ensures the section exists.
|
|
$xpath = $this->section_exists($section);
|
|
// We need to know the course format as the text strings depends on them.
|
|
$courseformat = $this->get_course_format();
|
|
if (get_string_manager()->string_exists('hidefromothers', $courseformat)) {
|
|
$strhide = get_string('hidefromothers', $courseformat);
|
|
} else {
|
|
$strhide = get_string('hidesection');
|
|
}
|
|
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($section);
|
|
}
|
|
|
|
// Click on hide link.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
array($strhide, "link", $this->escape($xpath), "xpath_element")
|
|
);
|
|
|
|
if ($this->running_javascript()) {
|
|
$this->getSession()->wait(self::get_timeout() * 1000, self::PAGE_READY_JS);
|
|
$this->i_wait_until_section_is_available($section);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Go to editing section page for specified section number. You need to be in the course page and on editing mode.
|
|
*
|
|
* @Given /^I edit the section "(?P<section_number>\d+)"$/
|
|
* @param int $sectionnumber
|
|
*/
|
|
public function i_edit_the_section($sectionnumber) {
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($sectionnumber);
|
|
}
|
|
|
|
// We need to know the course format as the text strings depends on them.
|
|
$courseformat = $this->get_course_format();
|
|
if (get_string_manager()->string_exists('editsection', $courseformat)) {
|
|
$stredit = get_string('editsection', $courseformat);
|
|
} else {
|
|
$stredit = get_string('editsection');
|
|
}
|
|
|
|
// Click on un-highlight topic link.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
array($stredit, "link", "#section-" . $sectionnumber . " .action-menu", "css_element")
|
|
);
|
|
|
|
}
|
|
|
|
/**
|
|
* Edit specified section and fill the form data with the specified field/value pairs.
|
|
*
|
|
* @When /^I edit the section "(?P<section_number>\d+)" and I fill the form with:$/
|
|
* @param int $sectionnumber The section number
|
|
* @param TableNode $data The activity field/value data
|
|
*/
|
|
public function i_edit_the_section_and_i_fill_the_form_with($sectionnumber, TableNode $data) {
|
|
|
|
// Edit given section.
|
|
$this->execute("behat_course::i_edit_the_section", $sectionnumber);
|
|
|
|
// Set form fields.
|
|
$this->execute("behat_forms::i_set_the_following_fields_to_these_values", $data);
|
|
|
|
// Save section settings.
|
|
$this->execute("behat_forms::press_button", get_string('savechanges'));
|
|
}
|
|
|
|
/**
|
|
* Checks if the specified course section hightlighting is turned on. You need to be in the course page on editing mode.
|
|
*
|
|
* @Then /^section "(?P<section_number>\d+)" should be highlighted$/
|
|
* @throws ExpectationException
|
|
* @param int $sectionnumber The section number
|
|
*/
|
|
public function section_should_be_highlighted($sectionnumber) {
|
|
|
|
// Ensures the section exists.
|
|
$xpath = $this->section_exists($sectionnumber);
|
|
|
|
$this->execute('behat_general::should_exist_in_the', ['Highlighted', 'text', $xpath, 'xpath_element']);
|
|
// The important checking, we can not check the img.
|
|
$this->execute('behat_general::should_exist_in_the', ['Unhighlight', 'link', $xpath, 'xpath_element']);
|
|
}
|
|
|
|
/**
|
|
* Checks if the specified course section highlighting is turned off. You need to be in the course page on editing mode.
|
|
*
|
|
* @Then /^section "(?P<section_number>\d+)" should not be highlighted$/
|
|
* @throws ExpectationException
|
|
* @param int $sectionnumber The section number
|
|
*/
|
|
public function section_should_not_be_highlighted($sectionnumber) {
|
|
|
|
// We only catch ExpectationException, ElementNotFoundException should be thrown if the specified section does not exist.
|
|
try {
|
|
$this->section_should_be_highlighted($sectionnumber);
|
|
} catch (ExpectationException $e) {
|
|
// ExpectedException means that it is not highlighted.
|
|
return;
|
|
}
|
|
|
|
throw new ExpectationException('The "' . $sectionnumber . '" section is highlighted', $this->getSession());
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified section is visible. You need to be in the course page. It can be used being logged as a student and as a teacher on editing mode.
|
|
*
|
|
* @Then /^section "(?P<section_number>\d+)" should be hidden$/
|
|
* @throws ExpectationException
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param int $sectionnumber
|
|
*/
|
|
public function section_should_be_hidden($sectionnumber) {
|
|
|
|
$sectionxpath = $this->section_exists($sectionnumber);
|
|
|
|
// Preventive in case there is any action in progress.
|
|
// Adding it here because we are interacting (click) with
|
|
// the elements, not necessary when we just find().
|
|
$this->i_wait_until_section_is_available($sectionnumber);
|
|
|
|
// Section should be hidden.
|
|
$exception = new ExpectationException('The section is not hidden', $this->getSession());
|
|
$this->find('xpath', $sectionxpath . "[contains(concat(' ', normalize-space(@class), ' '), ' hidden ')]", $exception);
|
|
}
|
|
|
|
/**
|
|
* Checks that all actiities in the specified section are hidden. You need to be in the course page. It can be used being logged as a student and as a teacher on editing mode.
|
|
*
|
|
* @Then /^all activities in section "(?P<section_number>\d+)" should be hidden$/
|
|
* @throws ExpectationException
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param int $sectionnumber
|
|
*/
|
|
public function section_activities_should_be_hidden($sectionnumber) {
|
|
$sectionxpath = $this->section_exists($sectionnumber);
|
|
|
|
// Preventive in case there is any action in progress.
|
|
// Adding it here because we are interacting (click) with
|
|
// the elements, not necessary when we just find().
|
|
$this->i_wait_until_section_is_available($sectionnumber);
|
|
|
|
// The checking are different depending on user permissions.
|
|
if ($this->is_course_editor()) {
|
|
|
|
// The section must be hidden.
|
|
$this->show_section_link_exists($sectionnumber);
|
|
|
|
// If there are activities they should be hidden and the visibility icon should not be available.
|
|
if ($activities = $this->get_section_activities($sectionxpath)) {
|
|
|
|
$dimmedexception = new ExpectationException('There are activities that are not hidden', $this->getSession());
|
|
foreach ($activities as $activity) {
|
|
// Hidden from students.
|
|
$this->find('named_partial', array('badge', get_string('hiddenfromstudents')), $dimmedexception, $activity);
|
|
}
|
|
}
|
|
} else {
|
|
// There shouldn't be activities.
|
|
if ($this->get_section_activities($sectionxpath)) {
|
|
throw new ExpectationException('There are activities in the section and they should be hidden', $this->getSession());
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified section is visible. You need to be in the course page. It can be used being logged as a student and as a teacher on editing mode.
|
|
*
|
|
* @Then /^section "(?P<section_number>\d+)" should be visible$/
|
|
* @throws ExpectationException
|
|
* @param int $sectionnumber
|
|
*/
|
|
public function section_should_be_visible($sectionnumber) {
|
|
|
|
$sectionxpath = $this->section_exists($sectionnumber);
|
|
|
|
// Section should not be hidden.
|
|
$xpath = $sectionxpath . "[not(contains(concat(' ', normalize-space(@class), ' '), ' hidden '))]";
|
|
if (!$this->getSession()->getPage()->find('xpath', $xpath)) {
|
|
throw new ExpectationException('The section is hidden', $this->getSession());
|
|
}
|
|
|
|
// Edit menu should be visible.
|
|
if ($this->is_course_editor()) {
|
|
$xpath = $sectionxpath .
|
|
"/descendant::div[contains(@class, 'section-actions')]" .
|
|
"/descendant::a[contains(@data-toggle, 'dropdown')]";
|
|
if (!$this->getSession()->getPage()->find('xpath', $xpath)) {
|
|
throw new ExpectationException('The section edit menu is not available', $this->getSession());
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Moves up the specified section, this step only works with Javascript disabled. Editing mode should be on.
|
|
*
|
|
* @Given /^I move up section "(?P<section_number>\d+)"$/
|
|
* @throws DriverException Step not available when Javascript is enabled
|
|
* @param int $sectionnumber
|
|
*/
|
|
public function i_move_up_section($sectionnumber) {
|
|
|
|
if ($this->running_javascript()) {
|
|
throw new DriverException('Move a section up step is not available with Javascript enabled');
|
|
}
|
|
|
|
// Ensures the section exists.
|
|
$sectionxpath = $this->section_exists($sectionnumber);
|
|
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($sectionnumber);
|
|
}
|
|
|
|
// Follows the link
|
|
$moveuplink = $this->get_node_in_container('link', get_string('moveup'), 'xpath_element', $sectionxpath);
|
|
$moveuplink->click();
|
|
}
|
|
|
|
/**
|
|
* Moves down the specified section, this step only works with Javascript disabled. Editing mode should be on.
|
|
*
|
|
* @Given /^I move down section "(?P<section_number>\d+)"$/
|
|
* @throws DriverException Step not available when Javascript is enabled
|
|
* @param int $sectionnumber
|
|
*/
|
|
public function i_move_down_section($sectionnumber) {
|
|
|
|
if ($this->running_javascript()) {
|
|
throw new DriverException('Move a section down step is not available with Javascript enabled');
|
|
}
|
|
|
|
// Ensures the section exists.
|
|
$sectionxpath = $this->section_exists($sectionnumber);
|
|
|
|
// If javascript is on, link is inside a menu.
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_section_edit_menu($sectionnumber);
|
|
}
|
|
|
|
// Follows the link
|
|
$movedownlink = $this->get_node_in_container('link', get_string('movedown'), 'xpath_element', $sectionxpath);
|
|
$movedownlink->click();
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified activity is visible. You need to be in the course page. It can be used being logged as a student and as a teacher on editing mode.
|
|
*
|
|
* @Then /^"(?P<activity_or_resource_string>(?:[^"]|\\")*)" activity should be visible$/
|
|
* @param string $activityname
|
|
* @throws ExpectationException
|
|
*/
|
|
public function activity_should_be_visible($activityname) {
|
|
|
|
// The activity must exists and be visible.
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
|
|
if ($this->is_course_editor()) {
|
|
|
|
// The activity should not be hidden from students.
|
|
try {
|
|
$this->find('named_partial', array('badge', get_string('hiddenfromstudents')), null, $activitynode);
|
|
throw new ExpectationException('"' . $activityname . '" is hidden', $this->getSession());
|
|
} catch (ElementNotFoundException $e) {
|
|
// All ok.
|
|
}
|
|
|
|
// Additional check if this is a teacher in editing mode.
|
|
if ($this->is_editing_on()) {
|
|
// The 'Hide' button should be available.
|
|
$nohideexception = new ExpectationException('"' . $activityname . '" doesn\'t have a "' .
|
|
get_string('hide') . '" icon', $this->getSession());
|
|
$this->find('named_partial', array('link', get_string('hide')), $nohideexception, $activitynode);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified activity is visible. You need to be in the course page.
|
|
* It can be used being logged as a student and as a teacher on editing mode.
|
|
*
|
|
* @Then /^"(?P<activity_or_resource_string>(?:[^"]|\\")*)" activity should be available but hidden from course page$/
|
|
* @param string $activityname
|
|
* @throws ExpectationException
|
|
*/
|
|
public function activity_should_be_available_but_hidden_from_course_page($activityname) {
|
|
|
|
if ($this->is_course_editor()) {
|
|
|
|
// The activity must exists and be visible.
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
|
|
// Should not have the "Hidden from students" badge.
|
|
try {
|
|
$this->find('named_partial', array('badge', get_string('hiddenfromstudents')), null, $activitynode);
|
|
throw new ExpectationException('"' . $activityname . '" is hidden', $this->getSession());
|
|
} catch (ElementNotFoundException $e) {
|
|
// All ok.
|
|
}
|
|
|
|
// Should have the "Available but not shown on course page" badge.
|
|
$exception = new ExpectationException('"' . $activityname . '" is not Available', $this->getSession());
|
|
$this->find('named_partial', array('badge', get_string('hiddenoncoursepage')), $exception, $activitynode);
|
|
|
|
// Additional check if this is a teacher in editing mode.
|
|
if ($this->is_editing_on()) {
|
|
// Also has either 'Hide' or 'Make unavailable' edit control.
|
|
$nohideexception = new ExpectationException('"' . $activityname . '" has neither "' . get_string('hide') .
|
|
'" nor "' . get_string('makeunavailable') . '" icons', $this->getSession());
|
|
try {
|
|
$this->find('named_partial', array('link', get_string('hide')), false, $activitynode);
|
|
} catch (ElementNotFoundException $e) {
|
|
$this->find('named_partial', array('link', get_string('makeunavailable')), $nohideexception, $activitynode);
|
|
}
|
|
}
|
|
|
|
} else {
|
|
|
|
// Student should not see the activity at all.
|
|
try {
|
|
$this->get_activity_node($activityname);
|
|
throw new ExpectationException('The "' . $activityname . '" should not appear', $this->getSession());
|
|
} catch (ElementNotFoundException $e) {
|
|
// This is good, the activity should not be there.
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified activity is hidden. You need to be in the course page. It can be used being logged as a student and as a teacher on editing mode.
|
|
*
|
|
* @Then /^"(?P<activity_or_resource_string>(?:[^"]|\\")*)" activity should be hidden$/
|
|
* @param string $activityname
|
|
* @throws ExpectationException
|
|
*/
|
|
public function activity_should_be_hidden($activityname) {
|
|
if ($this->is_course_editor()) {
|
|
// The activity should exist.
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
|
|
// Should be hidden.
|
|
$exception = new ExpectationException('"' . $activityname . '" is not hidden', $this->getSession());
|
|
$this->find('named_partial', array('badge', get_string('hiddenfromstudents')), $exception, $activitynode);
|
|
|
|
// Additional check if this is a teacher in editing mode.
|
|
if ($this->is_editing_on()) {
|
|
// Also has either 'Show' or 'Make available' edit control.
|
|
$noshowexception = new ExpectationException('"' . $activityname . '" has neither "' . get_string('show') .
|
|
'" nor "' . get_string('makeavailable') . '" icons', $this->getSession());
|
|
try {
|
|
$this->find('named_partial', array('link', get_string('show')), false, $activitynode);
|
|
} catch (ElementNotFoundException $e) {
|
|
$this->find('named_partial', array('link', get_string('makeavailable')), $noshowexception, $activitynode);
|
|
}
|
|
}
|
|
|
|
} else {
|
|
// It should not exist at all.
|
|
try {
|
|
$this->get_activity_node($activityname);
|
|
throw new ExpectationException('The "' . $activityname . '" should not appear', $this->getSession());
|
|
} catch (ElementNotFoundException $e) {
|
|
// This is good, the activity should not be there.
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified label is hidden from students. You need to be in the course page.
|
|
*
|
|
* @Then /^"(?P<activity_or_resource_string>(?:[^"]|\\")*)" label should be hidden$/
|
|
* @param string $activityname
|
|
* @throws ExpectationException
|
|
*/
|
|
public function label_should_be_hidden($activityname) {
|
|
if ($this->is_course_editor()) {
|
|
// The activity should exist.
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
|
|
// Should be hidden.
|
|
$exception = new ExpectationException('"' . $activityname . '" is not hidden', $this->getSession());
|
|
$this->find('named_partial', array('badge', get_string('hiddenfromstudents')), $exception, $activitynode);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Moves the specified activity to the first slot of a section.
|
|
*
|
|
* Editing mode should be on.
|
|
*
|
|
* @Given /^I move "(?P<activity_name_string>(?:[^"]|\\")*)" activity to section "(?P<section_number>\d+)"$/
|
|
* @param string $activityname The activity name
|
|
* @param int $sectionnumber The number of section
|
|
*/
|
|
public function i_move_activity_to_section($activityname, $sectionnumber): void {
|
|
$this->require_javascript('Moving activities requires javascript.');
|
|
|
|
// Ensure the destination is valid.
|
|
$sectionxpath = $this->section_exists($sectionnumber);
|
|
|
|
// TODO: remove this if clause as part of MDL-83627 when YUI is removed from course.
|
|
// Not all formats are compatible with the move tool.
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
if (!$activitynode->find('css', "[data-action='moveCm']", false, false, 0)) {
|
|
// Execute the legacy YUI move option.
|
|
$this->i_move_activity_to_section_yui($activityname, $sectionnumber);
|
|
return;
|
|
}
|
|
|
|
$this->i_open_actions_menu($activityname);
|
|
$this->execute(
|
|
'behat_course::i_click_on_in_the_activity',
|
|
[get_string('move'), "link", $this->escape($activityname)]
|
|
);
|
|
$this->execute("behat_general::i_click_on_in_the", [
|
|
"[data-for='section'][data-number='$sectionnumber']",
|
|
'css_element',
|
|
"[data-region='modal-container']",
|
|
'css_element',
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Moves the specified activity to the first slot of a section using the YUI course format.
|
|
*
|
|
* This step is experimental when using it in Javascript tests. Editing mode should be on.
|
|
*
|
|
* @todo remove this module as part of MDL-83627.
|
|
* @param string $activityname The activity name
|
|
* @param int $sectionnumber The number of section
|
|
*/
|
|
public function i_move_activity_to_section_yui($activityname, $sectionnumber): void {
|
|
// Ensure the destination is valid.
|
|
$sectionxpath = $this->section_exists($sectionnumber);
|
|
|
|
// JS enabled.
|
|
if ($this->running_javascript()) {
|
|
$activitynode = $this->get_activity_element('Move', 'icon', $activityname);
|
|
$destinationxpath = $sectionxpath . "/descendant::ul[contains(concat(' ', normalize-space(@class), ' '), ' yui3-dd-drop ')]";
|
|
$this->execute(
|
|
"behat_general::i_drag_and_i_drop_it_in",
|
|
[
|
|
$this->escape($activitynode->getXpath()), "xpath_element",
|
|
$this->escape($destinationxpath), "xpath_element",
|
|
]
|
|
);
|
|
} else {
|
|
// Following links with no-JS.
|
|
// Moving to the fist spot of the section (before all other section's activities).
|
|
$this->execute(
|
|
'behat_course::i_click_on_in_the_activity',
|
|
["a.editing_move", "css_element", $this->escape($activityname)]
|
|
);
|
|
$this->execute(
|
|
'behat_general::i_click_on_in_the',
|
|
["li.movehere a", "css_element", $this->escape($sectionxpath), "xpath_element"]
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Edits the activity name through the edit activity; this step only works with Javascript enabled. Editing mode should be on.
|
|
*
|
|
* @Given /^I change "(?P<activity_name_string>(?:[^"]|\\")*)" activity name to "(?P<new_name_string>(?:[^"]|\\")*)"$/
|
|
* @throws DriverException Step not available when Javascript is disabled
|
|
* @param string $activityname
|
|
* @param string $newactivityname
|
|
*/
|
|
public function i_change_activity_name_to($activityname, $newactivityname) {
|
|
$this->execute('behat_forms::i_set_the_field_in_container_to', [
|
|
get_string('edittitle'),
|
|
$activityname,
|
|
'activity',
|
|
$newactivityname
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Opens an activity actions menu if it is not already opened.
|
|
*
|
|
* @Given /^I open "(?P<activity_name_string>(?:[^"]|\\")*)" actions menu$/
|
|
* @throws DriverException The step is not available when Javascript is disabled
|
|
* @param string $activityname
|
|
*/
|
|
public function i_open_actions_menu($activityname) {
|
|
|
|
if (!$this->running_javascript()) {
|
|
throw new DriverException('Activities actions menu not available when Javascript is disabled');
|
|
}
|
|
|
|
// If it is already opened we do nothing.
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
|
|
// Find the menu.
|
|
$menunode = $activitynode->find('css', 'a[data-toggle=dropdown]');
|
|
if (!$menunode) {
|
|
throw new ExpectationException(sprintf('Could not find actions menu for the activity "%s"', $activityname),
|
|
$this->getSession());
|
|
}
|
|
$expanded = $menunode->getAttribute('aria-expanded');
|
|
if ($expanded == 'true') {
|
|
return;
|
|
}
|
|
|
|
$this->execute('behat_course::i_click_on_in_the_activity',
|
|
array("a[data-toggle='dropdown']", "css_element", $this->escape($activityname))
|
|
);
|
|
|
|
$this->actions_menu_should_be_open($activityname);
|
|
}
|
|
|
|
/**
|
|
* Closes an activity actions menu if it is not already closed.
|
|
*
|
|
* @Given /^I close "(?P<activity_name_string>(?:[^"]|\\")*)" actions menu$/
|
|
* @throws DriverException The step is not available when Javascript is disabled
|
|
* @param string $activityname
|
|
*/
|
|
public function i_close_actions_menu($activityname) {
|
|
|
|
if (!$this->running_javascript()) {
|
|
throw new DriverException('Activities actions menu not available when Javascript is disabled');
|
|
}
|
|
|
|
// If it is already closed we do nothing.
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
// Find the menu.
|
|
$menunode = $activitynode->find('css', 'a[data-toggle=dropdown]');
|
|
if (!$menunode) {
|
|
throw new ExpectationException(sprintf('Could not find actions menu for the activity "%s"', $activityname),
|
|
$this->getSession());
|
|
}
|
|
$expanded = $menunode->getAttribute('aria-expanded');
|
|
if ($expanded != 'true') {
|
|
return;
|
|
}
|
|
|
|
$this->execute('behat_course::i_click_on_in_the_activity',
|
|
array("a[data-toggle='dropdown']", "css_element", $this->escape($activityname))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified activity's action menu is open.
|
|
*
|
|
* @Then /^"(?P<activity_name_string>(?:[^"]|\\")*)" actions menu should be open$/
|
|
* @throws DriverException The step is not available when Javascript is disabled
|
|
* @param string $activityname
|
|
*/
|
|
public function actions_menu_should_be_open($activityname) {
|
|
|
|
if (!$this->running_javascript()) {
|
|
throw new DriverException('Activities actions menu not available when Javascript is disabled');
|
|
}
|
|
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
// Find the menu.
|
|
$menunode = $activitynode->find('css', 'a[data-toggle=dropdown]');
|
|
if (!$menunode) {
|
|
throw new ExpectationException(sprintf('Could not find actions menu for the activity "%s"', $activityname),
|
|
$this->getSession());
|
|
}
|
|
$expanded = $menunode->getAttribute('aria-expanded');
|
|
if ($expanded != 'true') {
|
|
throw new ExpectationException(sprintf("The action menu for '%s' is not open", $activityname), $this->getSession());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified activity's action menu contains an item.
|
|
*
|
|
* @Then /^"(?P<activity_name_string>(?:[^"]|\\")*)" actions menu should have "(?P<menu_item_string>(?:[^"]|\\")*)" item$/
|
|
* @throws DriverException The step is not available when Javascript is disabled
|
|
* @param string $activityname
|
|
* @param string $menuitem
|
|
*/
|
|
public function actions_menu_should_have_item($activityname, $menuitem) {
|
|
$activitynode = $this->get_activity_action_menu_node($activityname);
|
|
|
|
$notfoundexception = new ExpectationException('"' . $activityname . '" doesn\'t have a "' .
|
|
$menuitem . '" item', $this->getSession());
|
|
$this->find('named_partial', array('link', $menuitem), $notfoundexception, $activitynode);
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified activity's action menu does not contains an item.
|
|
*
|
|
* @Then /^"(?P<activity_name_string>(?:[^"]|\\")*)" actions menu should not have "(?P<menu_item_string>(?:[^"]|\\")*)" item$/
|
|
* @throws DriverException The step is not available when Javascript is disabled
|
|
* @param string $activityname
|
|
* @param string $menuitem
|
|
*/
|
|
public function actions_menu_should_not_have_item($activityname, $menuitem) {
|
|
$activitynode = $this->get_activity_action_menu_node($activityname);
|
|
|
|
try {
|
|
$this->find('named_partial', array('link', $menuitem), false, $activitynode);
|
|
throw new ExpectationException('"' . $activityname . '" has a "' . $menuitem .
|
|
'" item when it should not', $this->getSession());
|
|
} catch (ElementNotFoundException $e) {
|
|
// This is good, the menu item should not be there.
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the DOM node of the activity action menu.
|
|
*
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param string $activityname The activity name
|
|
* @return \Behat\Mink\Element\NodeElement
|
|
*/
|
|
protected function get_activity_action_menu_node($activityname) {
|
|
$activityname = behat_context_helper::escape($activityname);
|
|
$xpath = "//li[contains(concat(' ', normalize-space(@class), ' '), ' activity ')][contains(., $activityname)]" .
|
|
"//div[contains(@class, 'action-menu')]";
|
|
return $this->find('xpath', $xpath);
|
|
}
|
|
|
|
/**
|
|
* Indents to the right the activity or resource specified by it's name. Editing mode should be on.
|
|
*
|
|
* @Given /^I indent right "(?P<activity_name_string>(?:[^"]|\\")*)" activity$/
|
|
* @param string $activityname
|
|
*/
|
|
public function i_indent_right_activity($activityname) {
|
|
|
|
$activity = $this->escape($activityname);
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_actions_menu($activity);
|
|
}
|
|
|
|
$this->execute('behat_course::i_click_on_in_the_activity',
|
|
array(get_string('moveright'), "link", $this->escape($activity))
|
|
);
|
|
|
|
}
|
|
|
|
/**
|
|
* Indents to the left the activity or resource specified by it's name. Editing mode should be on.
|
|
*
|
|
* @Given /^I indent left "(?P<activity_name_string>(?:[^"]|\\")*)" activity$/
|
|
* @param string $activityname
|
|
*/
|
|
public function i_indent_left_activity($activityname) {
|
|
|
|
$activity = $this->escape($activityname);
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_actions_menu($activity);
|
|
}
|
|
|
|
$this->execute('behat_course::i_click_on_in_the_activity',
|
|
array(get_string('moveleft'), "link", $this->escape($activity))
|
|
);
|
|
|
|
}
|
|
|
|
/**
|
|
* Deletes the activity or resource specified by it's name. This step is experimental when using it in Javascript tests. You should be in the course page with editing mode on.
|
|
*
|
|
* @Given /^I delete "(?P<activity_name_string>(?:[^"]|\\")*)" activity$/
|
|
* @param string $activityname
|
|
*/
|
|
public function i_delete_activity($activityname) {
|
|
$steps = array();
|
|
$activity = $this->escape($activityname);
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_actions_menu($activity);
|
|
}
|
|
|
|
$this->execute('behat_course::i_click_on_in_the_activity',
|
|
array(get_string('delete'), "link", $this->escape($activity))
|
|
);
|
|
|
|
// JS enabled.
|
|
// Not using chain steps here because the exceptions catcher have problems detecting
|
|
// JS modal windows and avoiding interacting them at the same time.
|
|
if ($this->running_javascript()) {
|
|
$this->execute(
|
|
'behat_general::i_click_on_in_the',
|
|
[
|
|
get_string('delete'),
|
|
"button",
|
|
get_string('cmdelete_title', 'core_courseformat'),
|
|
"dialogue"
|
|
]
|
|
);
|
|
} else {
|
|
$this->execute("behat_forms::press_button", get_string('delete'));
|
|
}
|
|
|
|
return $steps;
|
|
}
|
|
|
|
/**
|
|
* Deletes a course.
|
|
*
|
|
* @Given the course :coursefullname is deleted
|
|
* @param string $coursefullname
|
|
*/
|
|
#[\core\attribute\example('And the course "Course test" is deleted')]
|
|
public function the_course_is_deleted($coursefullname) {
|
|
delete_course($this->get_course_id($coursefullname), false);
|
|
fix_course_sortorder();
|
|
}
|
|
|
|
/**
|
|
* Duplicates the activity or resource specified by it's name. You should be in the course page with editing mode on.
|
|
*
|
|
* @Given /^I duplicate "(?P<activity_name_string>(?:[^"]|\\")*)" activity$/
|
|
* @param string $activityname
|
|
*/
|
|
public function i_duplicate_activity($activityname) {
|
|
$steps = array();
|
|
$activity = $this->escape($activityname);
|
|
if ($this->running_javascript()) {
|
|
$this->i_open_actions_menu($activity);
|
|
}
|
|
$this->execute('behat_course::i_click_on_in_the_activity',
|
|
array(get_string('duplicate'), "link", $activity)
|
|
);
|
|
|
|
}
|
|
|
|
/**
|
|
* Duplicates the activity or resource and modifies the new activity with the provided data. You should be in the course page with editing mode on.
|
|
*
|
|
* @Given /^I duplicate "(?P<activity_name_string>(?:[^"]|\\")*)" activity editing the new copy with:$/
|
|
* @param string $activityname
|
|
* @param TableNode $data
|
|
*/
|
|
public function i_duplicate_activity_editing_the_new_copy_with($activityname, TableNode $data) {
|
|
|
|
$activity = $this->escape($activityname);
|
|
$activityliteral = behat_context_helper::escape($activityname);
|
|
|
|
$this->execute("behat_course::i_duplicate_activity", $activity);
|
|
|
|
// Determine the future new activity xpath from the former one.
|
|
$duplicatedxpath = "//li[contains(concat(' ', normalize-space(@class), ' '), ' activity ')]" .
|
|
"[contains(., $activityliteral)]/following-sibling::li";
|
|
$duplicatedactionsmenuxpath = $duplicatedxpath . "/descendant::a[@data-toggle='dropdown']";
|
|
|
|
if ($this->running_javascript()) {
|
|
// We wait until the AJAX request finishes and the section is visible again.
|
|
$hiddenlightboxxpath = "//li[contains(concat(' ', normalize-space(@class), ' '), ' activity ')]" .
|
|
"[contains(., $activityliteral)]" .
|
|
"/ancestor::li[contains(concat(' ', normalize-space(@class), ' '), ' section ')]" .
|
|
"/descendant::div[contains(concat(' ', @class, ' '), ' lightbox ')][contains(@style, 'display: none')]";
|
|
|
|
// Component based courses do not use lightboxes anymore but js depending.
|
|
$sectionreadyxpath = "//*[contains(@id,'page')]" .
|
|
"/descendant::*[contains(concat(' ', normalize-space(@class), ' '), ' stateready ')]";
|
|
|
|
$duplicationreadyxpath = "$hiddenlightboxxpath | $sectionreadyxpath";
|
|
$this->execute(
|
|
"behat_general::wait_until_exists",
|
|
[$this->escape($duplicationreadyxpath), "xpath_element"]
|
|
);
|
|
|
|
// Close the original activity actions menu.
|
|
$this->i_close_actions_menu($activity);
|
|
|
|
// The next sibling of the former activity will be the duplicated one, so we click on it from it's xpath as, at
|
|
// this point, it don't even exists in the DOM (the steps are executed when we return them).
|
|
$this->execute('behat_general::i_click_on',
|
|
array($this->escape($duplicatedactionsmenuxpath), "xpath_element")
|
|
);
|
|
}
|
|
|
|
// We force the xpath as otherwise mink tries to interact with the former one.
|
|
$this->execute('behat_general::i_click_on_in_the',
|
|
array(get_string('editsettings'), "link", $this->escape($duplicatedxpath), "xpath_element")
|
|
);
|
|
|
|
$this->execute("behat_forms::i_set_the_following_fields_to_these_values", $data);
|
|
$this->execute("behat_forms::press_button", get_string('savechangesandreturntocourse'));
|
|
|
|
}
|
|
|
|
/**
|
|
* Waits until the section is available to interact with it. Useful when the section is performing an action and the section is overlayed with a loading layout.
|
|
*
|
|
* Using the protected method as this method will be usually
|
|
* called by other methods which are not returning a set of
|
|
* steps and performs the actions directly, so it would not
|
|
* be executed if it returns another step.
|
|
*
|
|
* Hopefully we would not require test writers to use this step
|
|
* and we will manage it from other step definitions.
|
|
*
|
|
* @Given /^I wait until section "(?P<section>(?:[^"]|\\")*)" is available$/
|
|
* @param int|string $section
|
|
* @return void
|
|
*/
|
|
public function i_wait_until_section_is_available($section) {
|
|
|
|
// Looks for a hidden lightbox or a non-existent lightbox in that section.
|
|
$sectionxpath = $this->section_exists($section);
|
|
$hiddenlightboxxpath = $sectionxpath . "/descendant::div[contains(concat(' ', @class, ' '), ' lightbox ')][contains(@style, 'display: none')]" .
|
|
" | " .
|
|
$sectionxpath . "[count(child::div[contains(@class, 'lightbox')]) = 0]";
|
|
|
|
$this->ensure_element_exists($hiddenlightboxxpath, 'xpath_element');
|
|
}
|
|
|
|
/**
|
|
* Clicks on the specified element of the activity. You should be in the course page with editing mode turned on.
|
|
*
|
|
* @Given /^I click on "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>(?:[^"]|\\")*)" in the "(?P<activity_name_string>(?:[^"]|\\")*)" activity$/
|
|
* @param string $element
|
|
* @param string $selectortype
|
|
* @param string $activityname
|
|
*/
|
|
public function i_click_on_in_the_activity($element, $selectortype, $activityname) {
|
|
$element = $this->get_activity_element($element, $selectortype, $activityname);
|
|
$element->click();
|
|
}
|
|
|
|
/**
|
|
* Clicks on the specified element inside the activity container.
|
|
*
|
|
* @throws ElementNotFoundException
|
|
* @param string $element
|
|
* @param string $selectortype
|
|
* @param string $activityname
|
|
* @return NodeElement
|
|
*/
|
|
protected function get_activity_element($element, $selectortype, $activityname) {
|
|
$activitynode = $this->get_activity_node($activityname);
|
|
|
|
$exception = new ElementNotFoundException($this->getSession(), "'{$element}' '{$selectortype}' in '{$activityname}'");
|
|
return $this->find($selectortype, $element, $exception, $activitynode);
|
|
}
|
|
|
|
/**
|
|
* Checks if the course section exists.
|
|
*
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param int|string $section Section number or name to look for.
|
|
* @return string The xpath of the section.
|
|
*/
|
|
protected function section_exists($section) {
|
|
|
|
if (is_numeric($section)) {
|
|
return $this->section_number_exists($section);
|
|
}
|
|
|
|
return $this->section_name_exists($section);
|
|
}
|
|
|
|
/**
|
|
* Checks if the course section number exists.
|
|
*
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param int $sectionnumber
|
|
* @return string The xpath of the section.
|
|
*/
|
|
protected function section_number_exists(int $sectionnumber): string {
|
|
|
|
// Just to give more info in case it does not exist.
|
|
$xpath = "//li[@id='section-" . $sectionnumber . "']";
|
|
$exception = new ElementNotFoundException($this->getSession(), "Section $sectionnumber ");
|
|
$this->find('xpath', $xpath, $exception);
|
|
|
|
return $xpath;
|
|
}
|
|
|
|
/**
|
|
* Checks if the section name exists.
|
|
*
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param string $sectionname
|
|
* @return string The xpath of the section.
|
|
*/
|
|
protected function section_name_exists(string $sectionname): string {
|
|
// Let's try to find section or subsection in course page.
|
|
$xpath = "//li[@data-for='section']//*[@data-for='section_title' and contains(normalize-space(.), '" . $sectionname ."')]";
|
|
$exception = new ElementNotFoundException($this->getSession(), "Section $sectionname ");
|
|
try {
|
|
$this->find('xpath', $xpath, $exception);
|
|
} catch (ElementNotFoundException $e) {
|
|
// Let's try to find section in section page.
|
|
$xpath = "//header[@id='page-header' and contains(normalize-space(.), '" . $sectionname ."')]";
|
|
$this->find('xpath', $xpath, $exception);
|
|
}
|
|
|
|
return $xpath;
|
|
}
|
|
|
|
/**
|
|
* Returns the show section icon or throws an exception.
|
|
*
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param int|string $section Section number or name to look for.
|
|
* @return NodeElement
|
|
*/
|
|
protected function show_section_link_exists($section) {
|
|
|
|
// Gets the section xpath and ensure it exists.
|
|
$xpath = $this->section_exists($section);
|
|
|
|
// We need to know the course format as the text strings depends on them.
|
|
$courseformat = $this->get_course_format();
|
|
|
|
// Checking the show button alt text and show icon.
|
|
$showtext = get_string('showfromothers', $courseformat);
|
|
$linkxpath = $xpath . "//a[*[contains(text(), " . behat_context_helper::escape($showtext) . ")]]";
|
|
|
|
$exception = new ElementNotFoundException($this->getSession(), 'Show section link');
|
|
|
|
// Returing the link so both Non-JS and JS browsers can interact with it.
|
|
return $this->find('xpath', $linkxpath, $exception);
|
|
}
|
|
|
|
/**
|
|
* Returns the hide section icon link if it exists or throws exception.
|
|
*
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param int|string $section Section number or name to look for.
|
|
* @return NodeElement
|
|
*/
|
|
protected function hide_section_link_exists($section) {
|
|
|
|
// Gets the section xpath and ensure it exists.
|
|
$xpath = $this->section_exists($section);
|
|
|
|
// We need to know the course format as the text strings depends on them.
|
|
$courseformat = $this->get_course_format();
|
|
|
|
// Checking the hide button alt text and hide icon.
|
|
$hidetext = behat_context_helper::escape(get_string('hidefromothers', $courseformat));
|
|
$linkxpath = $xpath . "/descendant::a[@title=$hidetext]";
|
|
|
|
$exception = new ElementNotFoundException($this->getSession(), 'Hide section icon ');
|
|
$this->find('icon', 'Hide', $exception);
|
|
|
|
// Returing the link so both Non-JS and JS browsers can interact with it.
|
|
return $this->find('xpath', $linkxpath, $exception);
|
|
}
|
|
|
|
/**
|
|
* Gets the current course format.
|
|
*
|
|
* @throws ExpectationException If we are not in the course view page.
|
|
* @return string The course format in a frankenstyled name.
|
|
*/
|
|
protected function get_course_format() {
|
|
|
|
$exception = new ExpectationException('You are not in a course page', $this->getSession());
|
|
|
|
// The moodle body's id attribute contains the course format.
|
|
$node = $this->getSession()->getPage()->find('css', 'body');
|
|
if (!$node) {
|
|
throw $exception;
|
|
}
|
|
|
|
if (!$bodyid = $node->getAttribute('id')) {
|
|
throw $exception;
|
|
}
|
|
|
|
if (strstr($bodyid, 'page-course-view-') === false) {
|
|
throw $exception;
|
|
}
|
|
|
|
if (strstr($bodyid, 'page-course-view-section-') !== false) {
|
|
return 'format_' . str_replace('page-course-view-section-', '', $bodyid);
|
|
}
|
|
|
|
return 'format_' . str_replace('page-course-view-', '', $bodyid);
|
|
}
|
|
|
|
/**
|
|
* Gets the section's activites DOM nodes.
|
|
*
|
|
* @param string $sectionxpath
|
|
* @return array NodeElement instances
|
|
*/
|
|
protected function get_section_activities($sectionxpath) {
|
|
|
|
$xpath = $sectionxpath . "/descendant::li[contains(concat(' ', normalize-space(@class), ' '), ' activity ')]";
|
|
|
|
// We spin here, as activities usually require a lot of time to load.
|
|
try {
|
|
$activities = $this->find_all('xpath', $xpath);
|
|
} catch (ElementNotFoundException $e) {
|
|
return false;
|
|
}
|
|
|
|
return $activities;
|
|
}
|
|
|
|
/**
|
|
* Returns the DOM node of the activity from <li>.
|
|
*
|
|
* @throws ElementNotFoundException Thrown by behat_base::find
|
|
* @param string $activityname The activity name
|
|
* @return NodeElement
|
|
*/
|
|
protected function get_activity_node($activityname) {
|
|
|
|
$activityname = behat_context_helper::escape($activityname);
|
|
$xpath = "//li[contains(concat(' ', normalize-space(@class), ' '), ' activity ')][contains(., $activityname)]";
|
|
|
|
return $this->find('xpath', $xpath);
|
|
}
|
|
|
|
/**
|
|
* Gets the activity instance name from the activity node.
|
|
*
|
|
* @throws ElementNotFoundException
|
|
* @param NodeElement $activitynode
|
|
* @return string
|
|
*/
|
|
protected function get_activity_name($activitynode) {
|
|
$instancenamenode = $this->find('xpath', "//span[contains(concat(' ', normalize-space(@class), ' '), ' instancename ')]", false, $activitynode);
|
|
return $instancenamenode->getText();
|
|
}
|
|
|
|
/**
|
|
* Returns whether the user can edit the course contents or not.
|
|
*
|
|
* @return bool
|
|
*/
|
|
protected function is_course_editor(): bool {
|
|
try {
|
|
$this->find('field', get_string('editmode'), false, false, 0);
|
|
return true;
|
|
} catch (ElementNotFoundException $e) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns whether the user can edit the course contents and the editing mode is on.
|
|
*
|
|
* @return bool
|
|
*/
|
|
protected function is_editing_on() {
|
|
$body = $this->find('xpath', "//body", false, false, 0);
|
|
return $body->hasClass('editing');
|
|
}
|
|
|
|
/**
|
|
* Returns the category node from within the listing on the management page.
|
|
*
|
|
* @param string $idnumber
|
|
* @return \Behat\Mink\Element\NodeElement
|
|
*/
|
|
protected function get_management_category_listing_node_by_idnumber($idnumber) {
|
|
$id = $this->get_category_id($idnumber);
|
|
$selector = sprintf('#category-listing .listitem-category[data-id="%d"] > div', $id);
|
|
return $this->find('css', $selector);
|
|
}
|
|
|
|
/**
|
|
* Returns a category node from within the management interface.
|
|
*
|
|
* @param string $name The name of the category.
|
|
* @param bool $link If set to true we'll resolve to the link rather than just the node.
|
|
* @return \Behat\Mink\Element\NodeElement
|
|
*/
|
|
protected function get_management_category_listing_node_by_name($name, $link = false) {
|
|
$selector = "//div[@id='category-listing']//li[contains(concat(' ', normalize-space(@class), ' '), ' listitem-category ')]//a[text()='{$name}']";
|
|
if ($link === false) {
|
|
$selector .= "/ancestor::li[@data-id][1]";
|
|
}
|
|
return $this->find('xpath', $selector);
|
|
}
|
|
|
|
/**
|
|
* Returns a course node from within the management interface.
|
|
*
|
|
* @param string $name The name of the course.
|
|
* @param bool $link If set to true we'll resolve to the link rather than just the node.
|
|
* @return \Behat\Mink\Element\NodeElement
|
|
*/
|
|
protected function get_management_course_listing_node_by_name($name, $link = false) {
|
|
$selector = "//div[@id='course-listing']//li[contains(concat(' ', @class, ' '), ' listitem-course ')]//a[text()='{$name}']";
|
|
if ($link === false) {
|
|
$selector .= "/ancestor::li[@data-id]";
|
|
}
|
|
return $this->find('xpath', $selector);
|
|
}
|
|
|
|
/**
|
|
* Returns the course node from within the listing on the management page.
|
|
*
|
|
* @param string $idnumber
|
|
* @return \Behat\Mink\Element\NodeElement
|
|
*/
|
|
protected function get_management_course_listing_node_by_idnumber($idnumber) {
|
|
$id = $this->get_course_id($idnumber);
|
|
$selector = sprintf('#course-listing .listitem-course[data-id="%d"] > div', $id);
|
|
return $this->find('css', $selector);
|
|
}
|
|
|
|
/**
|
|
* Clicks on a category in the management interface.
|
|
*
|
|
* @Given /^I click on category "(?P<name_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @param string $name
|
|
*/
|
|
public function i_click_on_category_in_the_management_interface($name) {
|
|
$node = $this->get_management_category_listing_node_by_name($name, true);
|
|
$node->click();
|
|
}
|
|
|
|
/**
|
|
* Clicks on a course in the management interface.
|
|
*
|
|
* @Given /^I click on course "(?P<name_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @param string $name
|
|
*/
|
|
public function i_click_on_course_in_the_management_interface($name) {
|
|
$node = $this->get_management_course_listing_node_by_name($name, true);
|
|
$node->click();
|
|
}
|
|
|
|
/**
|
|
* Clicks on a category checkbox in the management interface, if not checked.
|
|
*
|
|
* @Given /^I select category "(?P<name_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @param string $name
|
|
*/
|
|
public function i_select_category_in_the_management_interface($name) {
|
|
$node = $this->get_management_category_listing_node_by_name($name);
|
|
$node = $node->findField('bcat[]');
|
|
if (!$node->isChecked()) {
|
|
$node->click();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Clicks on a category checkbox in the management interface, if checked.
|
|
*
|
|
* @Given /^I unselect category "(?P<name_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @param string $name
|
|
*/
|
|
public function i_unselect_category_in_the_management_interface($name) {
|
|
$node = $this->get_management_category_listing_node_by_name($name);
|
|
$node = $node->findField('bcat[]');
|
|
if ($node->isChecked()) {
|
|
$node->click();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Clicks course checkbox in the management interface, if not checked.
|
|
*
|
|
* @Given /^I select course "(?P<name_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @param string $name
|
|
*/
|
|
public function i_select_course_in_the_management_interface($name) {
|
|
$node = $this->get_management_course_listing_node_by_name($name);
|
|
$node = $node->findField('bc[]');
|
|
if (!$node->isChecked()) {
|
|
$node->click();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Clicks course checkbox in the management interface, if checked.
|
|
*
|
|
* @Given /^I unselect course "(?P<name_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @param string $name
|
|
*/
|
|
public function i_unselect_course_in_the_management_interface($name) {
|
|
$node = $this->get_management_course_listing_node_by_name($name);
|
|
$node = $node->findField('bc[]');
|
|
if ($node->isChecked()) {
|
|
$node->click();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Move selected categories to top level in the management interface.
|
|
*
|
|
* @Given /^I move category "(?P<name_string>(?:[^"]|\\")*)" to top level in the management interface$/
|
|
* @param string $name
|
|
*/
|
|
public function i_move_category_to_top_level_in_the_management_interface($name) {
|
|
$this->i_select_category_in_the_management_interface($name);
|
|
|
|
$this->execute('behat_forms::i_set_the_field_to',
|
|
array('menumovecategoriesto', core_course_category::get(0)->get_formatted_name())
|
|
);
|
|
|
|
// Save event.
|
|
$this->execute("behat_forms::press_button", "bulkmovecategories");
|
|
}
|
|
|
|
/**
|
|
* Checks that a category is a subcategory of specific category.
|
|
*
|
|
* @Given /^I should see category "(?P<subcatidnumber_string>(?:[^"]|\\")*)" as subcategory of "(?P<catidnumber_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @throws ExpectationException
|
|
* @param string $subcatidnumber
|
|
* @param string $catidnumber
|
|
*/
|
|
public function i_should_see_category_as_subcategory_of_in_the_management_interface($subcatidnumber, $catidnumber) {
|
|
$categorynodeid = $this->get_category_id($catidnumber);
|
|
$subcategoryid = $this->get_category_id($subcatidnumber);
|
|
$exception = new ExpectationException('The category '.$subcatidnumber.' is not a subcategory of '.$catidnumber, $this->getSession());
|
|
$selector = sprintf('#category-listing .listitem-category[data-id="%d"] .listitem-category[data-id="%d"]', $categorynodeid, $subcategoryid);
|
|
$this->find('css', $selector, $exception);
|
|
}
|
|
|
|
/**
|
|
* Checks that a category is not a subcategory of specific category.
|
|
*
|
|
* @Given /^I should not see category "(?P<subcatidnumber_string>(?:[^"]|\\")*)" as subcategory of "(?P<catidnumber_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @throws ExpectationException
|
|
* @param string $subcatidnumber
|
|
* @param string $catidnumber
|
|
*/
|
|
public function i_should_not_see_category_as_subcategory_of_in_the_management_interface($subcatidnumber, $catidnumber) {
|
|
try {
|
|
$this->i_should_see_category_as_subcategory_of_in_the_management_interface($subcatidnumber, $catidnumber);
|
|
} catch (ExpectationException $e) {
|
|
// ExpectedException means that it is not highlighted.
|
|
return;
|
|
}
|
|
throw new ExpectationException('The category '.$subcatidnumber.' is a subcategory of '.$catidnumber, $this->getSession());
|
|
}
|
|
|
|
/**
|
|
* Click to expand a category revealing its sub categories within the management UI.
|
|
*
|
|
* @Given /^I click to expand category "(?P<idnumber_string>(?:[^"]|\\")*)" in the management interface$/
|
|
* @param string $idnumber
|
|
*/
|
|
public function i_click_to_expand_category_in_the_management_interface($idnumber) {
|
|
$categorynode = $this->get_management_category_listing_node_by_idnumber($idnumber);
|
|
$exception = new ExpectationException('Category "' . $idnumber . '" does not contain an expand or collapse toggle.', $this->getSession());
|
|
$togglenode = $this->find('css', 'a[data-action=collapse],a[data-action=expand]', $exception, $categorynode);
|
|
$togglenode->click();
|
|
}
|
|
|
|
/**
|
|
* Checks that a category within the management interface is visible.
|
|
*
|
|
* @Given /^category in management listing should be visible "(?P<idnumber_string>(?:[^"]|\\")*)"$/
|
|
* @param string $idnumber
|
|
*/
|
|
public function category_in_management_listing_should_be_visible($idnumber) {
|
|
$id = $this->get_category_id($idnumber);
|
|
$exception = new ExpectationException('The category '.$idnumber.' is not visible.', $this->getSession());
|
|
$selector = sprintf('#category-listing .listitem-category[data-id="%d"][data-visible="1"]', $id);
|
|
$this->find('css', $selector, $exception);
|
|
}
|
|
|
|
/**
|
|
* Checks that a category within the management interface is dimmed.
|
|
*
|
|
* @Given /^category in management listing should be dimmed "(?P<idnumber_string>(?:[^"]|\\")*)"$/
|
|
* @param string $idnumber
|
|
*/
|
|
public function category_in_management_listing_should_be_dimmed($idnumber) {
|
|
$id = $this->get_category_id($idnumber);
|
|
$selector = sprintf('#category-listing .listitem-category[data-id="%d"][data-visible="0"]', $id);
|
|
$exception = new ExpectationException('The category '.$idnumber.' is visible.', $this->getSession());
|
|
$this->find('css', $selector, $exception);
|
|
}
|
|
|
|
/**
|
|
* Checks that a course within the management interface is visible.
|
|
*
|
|
* @Given /^course in management listing should be visible "(?P<idnumber_string>(?:[^"]|\\")*)"$/
|
|
* @param string $idnumber
|
|
*/
|
|
public function course_in_management_listing_should_be_visible($idnumber) {
|
|
$id = $this->get_course_id($idnumber);
|
|
$exception = new ExpectationException('The course '.$idnumber.' is not visible.', $this->getSession());
|
|
$selector = sprintf('#course-listing .listitem-course[data-id="%d"][data-visible="1"]', $id);
|
|
$this->find('css', $selector, $exception);
|
|
}
|
|
|
|
/**
|
|
* Checks that a course within the management interface is dimmed.
|
|
*
|
|
* @Given /^course in management listing should be dimmed "(?P<idnumber_string>(?:[^"]|\\")*)"$/
|
|
* @param string $idnumber
|
|
*/
|
|
public function course_in_management_listing_should_be_dimmed($idnumber) {
|
|
$id = $this->get_course_id($idnumber);
|
|
$exception = new ExpectationException('The course '.$idnumber.' is visible.', $this->getSession());
|
|
$selector = sprintf('#course-listing .listitem-course[data-id="%d"][data-visible="0"]', $id);
|
|
$this->find('css', $selector, $exception);
|
|
}
|
|
|
|
/**
|
|
* Toggles the visibility of a course in the management UI.
|
|
*
|
|
* If it was visible it will be hidden. If it is hidden it will be made visible.
|
|
*
|
|
* @Given /^I toggle visibility of course "(?P<idnumber_string>(?:[^"]|\\")*)" in management listing$/
|
|
* @param string $idnumber
|
|
*/
|
|
public function i_toggle_visibility_of_course_in_management_listing($idnumber) {
|
|
$id = $this->get_course_id($idnumber);
|
|
$selector = sprintf('#course-listing .listitem-course[data-id="%d"][data-visible]', $id);
|
|
$node = $this->find('css', $selector);
|
|
$exception = new ExpectationException('Course listing "' . $idnumber . '" does not contain a show or hide toggle.', $this->getSession());
|
|
if ($node->getAttribute('data-visible') === '1') {
|
|
$toggle = $this->find('css', '.action-hide', $exception, $node);
|
|
} else {
|
|
$toggle = $this->find('css', '.action-show', $exception, $node);
|
|
}
|
|
$toggle->click();
|
|
}
|
|
|
|
/**
|
|
* Toggles the visibility of a category in the management UI.
|
|
*
|
|
* If it was visible it will be hidden. If it is hidden it will be made visible.
|
|
*
|
|
* @Given /^I toggle visibility of category "(?P<idnumber_string>(?:[^"]|\\")*)" in management listing$/
|
|
*/
|
|
public function i_toggle_visibility_of_category_in_management_listing($idnumber) {
|
|
$id = $this->get_category_id($idnumber);
|
|
$selector = sprintf('#category-listing .listitem-category[data-id="%d"][data-visible]', $id);
|
|
$node = $this->find('css', $selector);
|
|
$exception = new ExpectationException('Category listing "' . $idnumber . '" does not contain a show or hide toggle.', $this->getSession());
|
|
if ($node->getAttribute('data-visible') === '1') {
|
|
$toggle = $this->find('css', '.action-hide', $exception, $node);
|
|
} else {
|
|
$toggle = $this->find('css', '.action-show', $exception, $node);
|
|
}
|
|
$toggle->click();
|
|
}
|
|
|
|
/**
|
|
* Moves a category displayed in the management interface up or down one place.
|
|
*
|
|
* @Given /^I click to move category "(?P<idnumber_string>(?:[^"]|\\")*)" (?P<direction>up|down) one$/
|
|
*
|
|
* @param string $idnumber The category idnumber
|
|
* @param string $direction The direction to move in, either up or down
|
|
*/
|
|
public function i_click_to_move_category_by_one($idnumber, $direction) {
|
|
$node = $this->get_management_category_listing_node_by_idnumber($idnumber);
|
|
$this->user_moves_listing_by_one('category', $node, $direction);
|
|
}
|
|
|
|
/**
|
|
* Moves a course displayed in the management interface up or down one place.
|
|
*
|
|
* @Given /^I click to move course "(?P<idnumber_string>(?:[^"]|\\")*)" (?P<direction>up|down) one$/
|
|
*
|
|
* @param string $idnumber The course idnumber
|
|
* @param string $direction The direction to move in, either up or down
|
|
*/
|
|
public function i_click_to_move_course_by_one($idnumber, $direction) {
|
|
$node = $this->get_management_course_listing_node_by_idnumber($idnumber);
|
|
$this->user_moves_listing_by_one('course', $node, $direction);
|
|
}
|
|
|
|
/**
|
|
* Moves a course or category listing within the management interface up or down by one.
|
|
*
|
|
* @param string $listingtype One of course or category
|
|
* @param \Behat\Mink\Element\NodeElement $listingnode
|
|
* @param string $direction One of up or down.
|
|
* @param bool $highlight If set to false we don't check the node has been highlighted.
|
|
*/
|
|
protected function user_moves_listing_by_one($listingtype, $listingnode, $direction, $highlight = true) {
|
|
$up = (strtolower($direction) === 'up');
|
|
if ($up) {
|
|
$exception = new ExpectationException($listingtype.' listing does not contain a moveup button.', $this->getSession());
|
|
$button = $this->find('css', 'a.action-moveup', $exception, $listingnode);
|
|
} else {
|
|
$exception = new ExpectationException($listingtype.' listing does not contain a movedown button.', $this->getSession());
|
|
$button = $this->find('css', 'a.action-movedown', $exception, $listingnode);
|
|
}
|
|
$button->click();
|
|
if ($this->running_javascript() && $highlight) {
|
|
$listitem = $listingnode->getParent();
|
|
$exception = new ExpectationException('Nothing was highlighted, ajax didn\'t occur or didn\'t succeed.', $this->getSession());
|
|
$this->spin(array($this, 'listing_is_highlighted'), $listitem->getTagName().'#'.$listitem->getAttribute('id'), 2, $exception, true);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Used by spin to determine the callback has been highlighted.
|
|
*
|
|
* @param behat_course $self A self reference (default first arg from a spin callback)
|
|
* @param \Behat\Mink\Element\NodeElement $selector
|
|
* @return bool
|
|
*/
|
|
protected function listing_is_highlighted($self, $selector) {
|
|
$listitem = $this->find('css', $selector);
|
|
return $listitem->hasClass('highlight');
|
|
}
|
|
|
|
/**
|
|
* Check that one course appears before another in the course category management listings.
|
|
*
|
|
* @Given /^I should see course listing "(?P<preceedingcourse_string>(?:[^"]|\\")*)" before "(?P<followingcourse_string>(?:[^"]|\\")*)"$/
|
|
*
|
|
* @param string $preceedingcourse The first course to find
|
|
* @param string $followingcourse The second course to find (should be AFTER the first course)
|
|
* @throws ExpectationException
|
|
*/
|
|
public function i_should_see_course_listing_before($preceedingcourse, $followingcourse) {
|
|
$xpath = "//div[@id='course-listing']//li[contains(concat(' ', @class, ' '), ' listitem-course ')]//a[text()='{$preceedingcourse}']/ancestor::li[@data-id]//following::a[text()='{$followingcourse}']";
|
|
$msg = "{$preceedingcourse} course does not appear before {$followingcourse} course";
|
|
if (!$this->getSession()->getDriver()->find($xpath)) {
|
|
throw new ExpectationException($msg, $this->getSession());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check that one category appears before another in the course category management listings.
|
|
*
|
|
* @Given /^I should see category listing "(?P<preceedingcategory_string>(?:[^"]|\\")*)" before "(?P<followingcategory_string>(?:[^"]|\\")*)"$/
|
|
*
|
|
* @param string $preceedingcategory The first category to find
|
|
* @param string $followingcategory The second category to find (should be after the first category)
|
|
* @throws ExpectationException
|
|
*/
|
|
public function i_should_see_category_listing_before($preceedingcategory, $followingcategory) {
|
|
$xpath = "//div[@id='category-listing']//li[contains(concat(' ', @class, ' '), ' listitem-category ')]//a[text()='{$preceedingcategory}']/ancestor::li[@data-id]//following::a[text()='{$followingcategory}']";
|
|
$msg = "{$preceedingcategory} category does not appear before {$followingcategory} category";
|
|
if (!$this->getSession()->getDriver()->find($xpath)) {
|
|
throw new ExpectationException($msg, $this->getSession());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks that we are on the course management page that we expect to be on and that no course has been selected.
|
|
*
|
|
* @Given /^I should see the "(?P<mode_string>(?:[^"]|\\")*)" management page$/
|
|
* @param string $mode The mode to expected. One of 'Courses', 'Course categories' or 'Course categories and courses'
|
|
*/
|
|
public function i_should_see_the_courses_management_page($mode) {
|
|
switch ($mode) {
|
|
case "Courses":
|
|
$heading = "Manage courses";
|
|
$this->execute("behat_general::should_not_exist", array("#category-listing", "css_element"));
|
|
$this->execute("behat_general::should_exist", array("#course-listing", "css_element"));
|
|
break;
|
|
|
|
case "Course categories":
|
|
$heading = "Manage course categories";
|
|
$this->execute("behat_general::should_exist", array("#category-listing", "css_element"));
|
|
$this->execute("behat_general::should_not_exist", array("#course-listing", "css_element"));
|
|
break;
|
|
|
|
case "Courses categories and courses":
|
|
default:
|
|
$heading = "Manage course categories and courses";
|
|
$this->execute("behat_general::should_exist", array("#category-listing", "css_element"));
|
|
$this->execute("behat_general::should_exist", array("#course-listing", "css_element"));
|
|
break;
|
|
}
|
|
|
|
$this->execute("behat_general::assert_element_contains_text",
|
|
array($heading, "h2", "css_element")
|
|
);
|
|
|
|
$this->execute("behat_general::should_not_exist", array("#course-detail", "css_element"));
|
|
}
|
|
|
|
/**
|
|
* Checks that we are on the course management page that we expect to be on and that a course has been selected.
|
|
*
|
|
* @Given /^I should see the "(?P<mode_string>(?:[^"]|\\")*)" management page with a course selected$/
|
|
* @param string $mode The mode to expected. One of 'Courses', 'Course categories' or 'Course categories and courses'
|
|
*/
|
|
public function i_should_see_the_courses_management_page_with_a_course_selected($mode) {
|
|
switch ($mode) {
|
|
case "Courses":
|
|
$heading = "Manage courses";
|
|
$this->execute("behat_general::should_not_exist", array("#category-listing", "css_element"));
|
|
$this->execute("behat_general::should_exist", array("#course-listing", "css_element"));
|
|
break;
|
|
|
|
case "Course categories":
|
|
$heading = "Manage course categories";
|
|
$this->execute("behat_general::should_exist", array("#category-listing", "css_element"));
|
|
$this->execute("behat_general::should_exist", array("#course-listing", "css_element"));
|
|
break;
|
|
|
|
case "Courses categories and courses":
|
|
default:
|
|
$heading = "Manage course categories and courses";
|
|
$this->execute("behat_general::should_exist", array("#category-listing", "css_element"));
|
|
$this->execute("behat_general::should_exist", array("#course-listing", "css_element"));
|
|
break;
|
|
}
|
|
|
|
$this->execute("behat_general::assert_element_contains_text",
|
|
array($heading, "h2", "css_element"));
|
|
|
|
$this->execute("behat_general::should_exist", array("#course-detail", "css_element"));
|
|
}
|
|
|
|
/**
|
|
* Locates a course in the course category management interface and then triggers an action for it.
|
|
*
|
|
* @Given /^I click on "(?P<action_string>(?:[^"]|\\")*)" action for "(?P<name_string>(?:[^"]|\\")*)" in management course listing$/
|
|
*
|
|
* @param string $action The action to take. One of
|
|
* @param string $name The name of the course as it is displayed in the management interface.
|
|
*/
|
|
public function i_click_on_action_for_item_in_management_course_listing($action, $name) {
|
|
$node = $this->get_management_course_listing_node_by_name($name);
|
|
$this->user_clicks_on_management_listing_action('course', $node, $action);
|
|
}
|
|
|
|
/**
|
|
* Locates a category in the course category management interface and then triggers an action for it.
|
|
*
|
|
* @Given /^I click on "(?P<action_string>(?:[^"]|\\")*)" action for "(?P<name_string>(?:[^"]|\\")*)" in management category listing$/
|
|
*
|
|
* @param string $action The action to take. One of
|
|
* @param string $name The name of the category as it is displayed in the management interface.
|
|
*/
|
|
public function i_click_on_action_for_item_in_management_category_listing($action, $name) {
|
|
$node = $this->get_management_category_listing_node_by_name($name);
|
|
$this->user_clicks_on_management_listing_action('category', $node, $action);
|
|
}
|
|
|
|
/**
|
|
* Clicks to expand or collapse a category displayed on the frontpage
|
|
*
|
|
* @Given /^I toggle "(?P<categoryname_string>(?:[^"]|\\")*)" category children visibility in frontpage$/
|
|
* @throws ExpectationException
|
|
* @param string $categoryname
|
|
*/
|
|
public function i_toggle_category_children_visibility_in_frontpage($categoryname) {
|
|
|
|
$headingtags = array();
|
|
for ($i = 1; $i <= 6; $i++) {
|
|
$headingtags[] = 'self::h' . $i;
|
|
}
|
|
|
|
$exception = new ExpectationException('"' . $categoryname . '" category can not be found', $this->getSession());
|
|
$categoryliteral = behat_context_helper::escape($categoryname);
|
|
$xpath = "//div[@class='info']/descendant::*[" . implode(' or ', $headingtags) .
|
|
"][contains(@class,'categoryname')][./descendant::a[.=$categoryliteral]]";
|
|
$node = $this->find('xpath', $xpath, $exception);
|
|
$node->click();
|
|
|
|
// Smooth expansion.
|
|
$this->getSession()->wait(1000);
|
|
}
|
|
|
|
/**
|
|
* Finds the node to use for a management listitem action and clicks it.
|
|
*
|
|
* @param string $listingtype Either course or category.
|
|
* @param \Behat\Mink\Element\NodeElement $listingnode
|
|
* @param string $action The action being taken
|
|
* @throws Behat\Mink\Exception\ExpectationException
|
|
*/
|
|
protected function user_clicks_on_management_listing_action($listingtype, $listingnode, $action) {
|
|
$actionsnode = $listingnode->find('xpath', "//*" .
|
|
"[contains(concat(' ', normalize-space(@class), ' '), '{$listingtype}-item-actions')]");
|
|
if (!$actionsnode) {
|
|
throw new ExpectationException("Could not find the actions for $listingtype", $this->getSession());
|
|
}
|
|
$actionnode = $actionsnode->find('css', '.action-'.$action);
|
|
if (!$actionnode) {
|
|
throw new ExpectationException("Expected action was not available or not found ($action)", $this->getSession());
|
|
}
|
|
if ($this->running_javascript() && !$actionnode->isVisible()) {
|
|
$actionsnode->find('css', 'a[data-toggle=dropdown]')->click();
|
|
$actionnode = $actionsnode->find('css', '.action-'.$action);
|
|
}
|
|
$actionnode->click();
|
|
}
|
|
|
|
/**
|
|
* Clicks on a category in the management interface.
|
|
*
|
|
* @Given /^I click on "(?P<categoryname_string>(?:[^"]|\\")*)" category in the management category listing$/
|
|
* @param string $name The name of the category to click.
|
|
*/
|
|
public function i_click_on_category_in_the_management_category_listing($name) {
|
|
$node = $this->get_management_category_listing_node_by_name($name);
|
|
$node->find('css', 'a.categoryname')->click();
|
|
}
|
|
|
|
/**
|
|
* Locates a category in the course category management interface and then opens action menu for it.
|
|
*
|
|
* @Given /^I open the action menu for "(?P<name_string>(?:[^"]|\\")*)" in management category listing$/
|
|
*
|
|
* @param string $name The name of the category as it is displayed in the management interface.
|
|
*/
|
|
public function i_open_the_action_menu_for_item_in_management_category_listing($name) {
|
|
$node = $this->get_management_category_listing_node_by_name($name);
|
|
$node->find('xpath', "//*[contains(@class, 'category-item-actions')]//a[@data-toggle='dropdown']")->click();
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified category actions menu contains an item.
|
|
*
|
|
* @Then /^"(?P<name_string>(?:[^"]|\\")*)" category actions menu should have "(?P<menu_item_string>(?:[^"]|\\")*)" item$/
|
|
*
|
|
* @param string $name
|
|
* @param string $menuitem
|
|
* @throws Behat\Mink\Exception\ExpectationException
|
|
*/
|
|
public function category_actions_menu_should_have_item($name, $menuitem) {
|
|
$node = $this->get_management_category_listing_node_by_name($name);
|
|
|
|
$notfoundexception = new ExpectationException('"' . $name . '" doesn\'t have a "' .
|
|
$menuitem . '" item', $this->getSession());
|
|
$this->find('named_partial', ['link', $menuitem], $notfoundexception, $node);
|
|
}
|
|
|
|
/**
|
|
* Checks that the specified category actions menu does not contain an item.
|
|
*
|
|
* @Then /^"(?P<name_string>(?:[^"]|\\")*)" category actions menu should not have "(?P<menu_item_string>(?:[^"]|\\")*)" item$/
|
|
*
|
|
* @param string $name
|
|
* @param string $menuitem
|
|
* @throws Behat\Mink\Exception\ExpectationException
|
|
*/
|
|
public function category_actions_menu_should_not_have_item($name, $menuitem) {
|
|
$node = $this->get_management_category_listing_node_by_name($name);
|
|
|
|
try {
|
|
$this->find('named_partial', ['link', $menuitem], false, $node);
|
|
throw new ExpectationException('"' . $name . '" has a "' . $menuitem .
|
|
'" item when it should not', $this->getSession());
|
|
} catch (ElementNotFoundException $e) {
|
|
// This is good, the menu item should not be there.
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Go to the course participants
|
|
*
|
|
* @Given /^I navigate to course participants$/
|
|
*/
|
|
public function i_navigate_to_course_participants() {
|
|
$this->execute('behat_navigation::i_select_from_secondary_navigation', get_string('participants'));
|
|
}
|
|
|
|
/**
|
|
* Check that one teacher appears before another in the course contacts.
|
|
*
|
|
* @Given /^I should see teacher "(?P<pteacher_string>(?:[^"]|\\")*)" before "(?P<fteacher_string>(?:[^"]|\\")*)" in the course contact listing$/
|
|
*
|
|
* @param string $pteacher The first teacher to find
|
|
* @param string $fteacher The second teacher to find (should be after the first teacher)
|
|
*
|
|
* @throws ExpectationException
|
|
*/
|
|
public function i_should_see_teacher_before($pteacher, $fteacher) {
|
|
$xpath = "//ul[contains(@class,'teachers')]//li//a[text()='{$pteacher}']/ancestor::li//following::a[text()='{$fteacher}']";
|
|
$msg = "Teacher {$pteacher} does not appear before Teacher {$fteacher}";
|
|
if (!$this->getSession()->getDriver()->find($xpath)) {
|
|
throw new ExpectationException($msg, $this->getSession());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check that one teacher oes not appears after another in the course contacts.
|
|
*
|
|
* @Given /^I should not see teacher "(?P<fteacher_string>(?:[^"]|\\")*)" after "(?P<pteacher_string>(?:[^"]|\\")*)" in the course contact listing$/
|
|
*
|
|
* @param string $fteacher The teacher that should not be found (after the other teacher)
|
|
* @param string $pteacher The teacher after who the other should not be found (this teacher must be found!)
|
|
*
|
|
* @throws ExpectationException
|
|
*/
|
|
public function i_should_not_see_teacher_after($fteacher, $pteacher) {
|
|
$xpathliteral = behat_context_helper::escape($pteacher);
|
|
$xpath = "/descendant-or-self::*[contains(., $xpathliteral)]" .
|
|
"[count(descendant::*[contains(., $xpathliteral)]) = 0]";
|
|
try {
|
|
$nodes = $this->find_all('xpath', $xpath);
|
|
} catch (ElementNotFoundException $e) {
|
|
throw new ExpectationException('"' . $pteacher . '" text was not found in the page', $this->getSession());
|
|
}
|
|
$xpath = "//ul[contains(@class,'teachers')]//li//a[text()='{$pteacher}']/ancestor::li//following::a[text()='{$fteacher}']";
|
|
$msg = "Teacher {$fteacher} appears after Teacher {$pteacher}";
|
|
if ($this->getSession()->getDriver()->find($xpath)) {
|
|
throw new ExpectationException($msg, $this->getSession());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Open the activity chooser in a course.
|
|
*
|
|
* @Given /^I open the activity chooser$/
|
|
*/
|
|
public function i_open_the_activity_chooser() {
|
|
// Open the "Activity or resource and Subsection" dropdown first.
|
|
$this->execute('behat_general::i_click_on',
|
|
['//button[@data-action="open-addingcontent"]', 'xpath_element']);
|
|
$this->execute('behat_general::i_click_on',
|
|
['//button[@data-action="open-chooser"]', 'xpath_element']);
|
|
|
|
$node = $this->get_selected_node('xpath_element', '//div[@data-region="modules"]');
|
|
$this->ensure_node_is_visible($node);
|
|
}
|
|
|
|
/**
|
|
* Checks the presence of the given text in the activity's displayed dates.
|
|
*
|
|
* @Given /^the activity date in "(?P<activityname>(?:[^"]|\\")*)" should contain "(?P<text>(?:[^"]|\\")*)"$/
|
|
* @param string $activityname The activity name.
|
|
* @param string $text The text to be searched in the activity date.
|
|
*/
|
|
public function activity_date_in_activity_should_contain_text(string $activityname, string $text): void {
|
|
$containerselector = "//div[@data-activityname='$activityname']";
|
|
$containerselector .= "//div[@data-region='activity-dates']";
|
|
|
|
$params = [$text, $containerselector, 'xpath_element'];
|
|
$this->execute("behat_general::assert_element_contains_text", $params);
|
|
}
|
|
|
|
/**
|
|
* Checks the presence of activity dates information in the activity information output component.
|
|
*
|
|
* @Given /^the activity date information in "(?P<activityname>(?:[^"]|\\")*)" should exist$/
|
|
* @param string $activityname The activity name.
|
|
*/
|
|
public function activity_dates_information_in_activity_should_exist(string $activityname): void {
|
|
$containerselector = "//div[@data-activityname='$activityname']";
|
|
$elementselector = "//div[@data-region='activity-dates']";
|
|
$params = [$elementselector, "xpath_element", $containerselector, "xpath_element"];
|
|
$this->execute("behat_general::should_exist_in_the", $params);
|
|
}
|
|
|
|
/**
|
|
* Checks the absence of activity dates information in the activity information output component.
|
|
*
|
|
* @Given /^the activity date information in "(?P<activityname>(?:[^"]|\\")*)" should not exist$/
|
|
* @param string $activityname The activity name.
|
|
*/
|
|
public function activity_dates_information_in_activity_should_not_exist(string $activityname): void {
|
|
$containerselector = "//div[@data-region='activity-information'][@data-activityname='$activityname']";
|
|
try {
|
|
$this->find('xpath_element', $containerselector);
|
|
} catch (ElementNotFoundException $e) {
|
|
// If activity information container does not exist (activity dates not shown, completion info not shown), all good.
|
|
return;
|
|
}
|
|
|
|
// Otherwise, ensure that the completion information does not exist.
|
|
$elementselector = "//div[@data-region='activity-dates']";
|
|
$params = [$elementselector, "xpath_element", $containerselector, "xpath_element"];
|
|
$this->execute("behat_general::should_not_exist_in_the", $params);
|
|
}
|
|
|
|
/**
|
|
* Get the section id from an identifier.
|
|
*
|
|
* The section name and summary are checked.
|
|
*
|
|
* @param string $courseidentifier
|
|
* @param string $sectionidentifier
|
|
* @return section_info|null section info or null if not found.
|
|
*/
|
|
protected function get_section_and_course_by_id(string $courseidentifier, string $sectionidentifier): ?section_info {
|
|
$courseid = $this->get_course_id($courseidentifier);
|
|
if (!$courseid) {
|
|
return null;
|
|
}
|
|
$courseformat = course_get_format($courseid);
|
|
$sections = $courseformat->get_sections();
|
|
foreach ($sections as $section) {
|
|
$sectionfullname = $courseformat->get_section_name($section);
|
|
if ($section->name == $sectionidentifier
|
|
|| $sectionfullname == $sectionidentifier
|
|
) {
|
|
return $section;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Get the section id from a courseid and a sectionnum.
|
|
*
|
|
* @param string $courseidentifier Course identifier.
|
|
* @param int $sectionnum Section number
|
|
* @return section_info|null section info or null if not found.
|
|
*/
|
|
protected function get_section_and_course_by_sectionnum(string $courseidentifier, int $sectionnum): ?section_info {
|
|
$courseid = $this->get_course_id($courseidentifier);
|
|
if (!$courseid) {
|
|
return null;
|
|
}
|
|
$courseformat = course_get_format($courseid);
|
|
return $courseformat->get_section($sectionnum);
|
|
}
|
|
}
|