first commit

This commit is contained in:
CHIEFSOFT\ameye
2024-09-30 18:11:26 -04:00
commit e592ca6823
27270 changed files with 5002257 additions and 0 deletions
@@ -0,0 +1,68 @@
<?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/>.
/**
* Custom behat functions
*
* @package report_outline
* @copyright 2017 Davo Smith, Synergy Learning
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
require_once(__DIR__ . '/../../../../lib/behat/behat_base.php');
/**
* Class behat_report_outline custom Behat steps for report_outline.
*/
class behat_report_outline extends behat_base {
/**
* This is a horrible, horrible hack, but it is not clear how else a range of log entries can be produced to test the
* filtering of the log entries.
*
* @Given /^the log timestamp for "(?P<username>(?:[^"]|\\")*)" and "(?P<activity_idnumber>(?:[^"]|\\")*)" is set to "(?P<date>(?:[^"]|\\")*)"$/
* @param string $username
* @param string $activityidnumber
* @param string $date
*/
public function the_log_timestamp_for_and_is_set_to($username, $activityidnumber, $date) {
global $DB;
// Get the name of the log table.
$lm = get_log_manager();
$readers = $lm->get_readers('\\core\\log\\sql_internal_table_reader');
$reader = reset($readers);
$table = $reader->get_internal_log_table_name();
// Find the log entry.
$cmrec = $DB->get_record('course_modules', ['idnumber' => $activityidnumber], '*', MUST_EXIST);
$modname = $DB->get_field('modules', 'name', ['id' => $cmrec->module], MUST_EXIST);
$userid = $DB->get_field('user', 'id', ['username' => $username], MUST_EXIST);
$cond = [
'userid' => $userid,
'component' => 'mod_'.$modname,
'target' => 'course_module',
'action' => 'viewed',
'contextinstanceid' => $cmrec->id,
];
$logentries = $DB->get_records($table, $cond, 'timecreated DESC', 'id', 0, 1);
$logentry = reset($logentries);
// Update the timecreated for the entry.
$timestamp = strtotime($date);
$DB->set_field($table, 'timecreated', $timestamp, ['id' => $logentry->id]);
}
}
@@ -0,0 +1,26 @@
@report @report_outline
Feature: In a course administration page, navigate through report page, test for activity report page
In order to navigate through report page
As an admin
Go to course administration -> Reports -> Activity report
Background:
Given the following "courses" exist:
| fullname | shortname | category | groupmode |
| Course 1 | C1 | 0 | 1 |
And the following "users" exist:
| username | firstname | lastname | email |
| student1 | Student | 1 | student1@example.com |
And the following "course enrolments" exist:
| user | course | role |
| admin | C1 | editingteacher |
| student1 | C1 | student |
@javascript
Scenario: Selector should be available in course activiy report page
Given I log in as "admin"
And I am on "Course 1" course homepage
When I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
Then "Report" "field" should exist in the "tertiary-navigation" "region"
And I should see "Activity report" in the "tertiary-navigation" "region"
+73
View File
@@ -0,0 +1,73 @@
@report @report_outline
Feature: Filter an outline report
In order to ensure the outline report works as expected
As a teacher
I need to log in as a teacher and view the outline report with various filters in place
Background:
Given the following "courses" exist:
| fullname | shortname | format |
| Course 1 | C1 | topics |
And the following "users" exist:
| username | firstname | lastname | email |
| teacher1 | Teacher | 1 | teacher1@example.com |
| student1 | Student | 1 | student1@example.com |
| student2 | Student | 2 | student2@example.com |
And the following "course enrolments" exist:
| user | course | role |
| teacher1 | C1 | editingteacher |
| student1 | C1 | student |
| student2 | C1 | student |
And the following "activities" exist:
| activity | name | course | idnumber | section |
| forum | Forum name | C1 | FORUM01 | 1 |
| book | Book name | C1 | BOOK01 | 1 |
When I am on the "Course 1" course page logged in as admin
Scenario: Filter the outline report by start date
Given I navigate to "Plugins > Logging > Manage log stores" in site administration
And "Disable" "link" should exist in the "Standard log" "table_row"
And I am on the "Forum name" "forum activity" page logged in as student1
And the log timestamp for "student1" and "FORUM01" is set to "12 June 2017 12:49:00"
And I am on "Course 1" course homepage
And I follow "Book name"
And the log timestamp for "student1" and "BOOK01" is set to "10 June 2017 14:01:00"
And I am on the "Book name" "book activity" page logged in as student2
And the log timestamp for "student2" and "BOOK01" is set to "14 June 2017 11:02:00"
And I am on the "Course 1" course page logged in as admin
And I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
And I should see "2 views by 2 users" in the "Book name" "table_row"
And I should see "1 views by 1 users" in the "Forum name" "table_row"
When I set the following fields to these values:
| filterstartdate[enabled] | 1 |
| filterstartdate[day] | 12 |
| filterstartdate[month] | June |
| filterstartdate[year] | 2017 |
And I click on "Filter" "button" in the "#fgroup_id_buttonar" "css_element"
Then I should see "1 views by 1 users" in the "Book name" "table_row"
And I should see "1 views by 1 users" in the "Forum name" "table_row"
Scenario: Filter the outline report by end date
Given I navigate to "Plugins > Logging > Manage log stores" in site administration
And "Disable" "link" should exist in the "Standard log" "table_row"
And I am on the "Forum name" "forum activity" page logged in as student1
And the log timestamp for "student1" and "FORUM01" is set to "12 June 2017 12:49:00"
And I am on "Course 1" course homepage
And I follow "Book name"
And the log timestamp for "student1" and "BOOK01" is set to "10 June 2017 14:01:00"
And I am on the "Book name" "book activity" page logged in as student2
And the log timestamp for "student2" and "BOOK01" is set to "14 June 2017 11:02:00"
And I am on the "Course 1" course page logged in as admin
And I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
And I should see "2 views by 2 users" in the "Book name" "table_row"
And I should see "1 views by 1 users" in the "Forum name" "table_row"
When I set the following fields to these values:
| filterenddate[enabled] | 1 |
| filterenddate[day] | 11 |
| filterenddate[month] | June |
| filterenddate[year] | 2017 |
And I click on "Filter" "button" in the "#fgroup_id_buttonar" "css_element"
Then I should see "1 views by 1 users" in the "Book name" "table_row"
And I should not see "views by" in the "Forum name" "table_row"
@@ -0,0 +1,90 @@
@report @report_outline
Feature: View an outline report
In order to ensure the outline report works as expected
As a teacher
I need to log in as a teacher and view the outline report
Background:
Given the following "courses" exist:
| fullname | shortname | format |
| Course 1 | C1 | topics |
And the following "users" exist:
| username | firstname | lastname | email |
| teacher1 | Teacher | 1 | teacher1@example.com |
| student1 | Student | 1 | student1@example.com |
| student2 | Student | 2 | student2@example.com |
And the following "course enrolments" exist:
| user | course | role |
| teacher1 | C1 | editingteacher |
| student1 | C1 | student |
| student2 | C1 | student |
And the following "activities" exist:
| activity | name | course | idnumber |
| forum | Forum name | C1 | forum1 |
| book | Book name | C1 | book1 |
When I am on the "Course 1" course page logged in as admin
Scenario: View the outline report when only the standard log reader is enabled
Given I navigate to "Plugins > Logging > Manage log stores" in site administration
And "Disable" "link" should exist in the "Standard log" "table_row"
And I am on the "Course 1" course page logged in as student1
And I follow "Forum name"
And I am on "Course 1" course homepage
And I follow "Book name"
And I am on the "Course 1" course page logged in as student2
And I follow "Book name"
And I am on the "Course 1" course page logged in as admin
When I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
Then I should see "2 views by 2 users" in the "Book name" "table_row"
And I should see "1 views by 1 users" in the "Forum name" "table_row"
Scenario: View the outline report when no log reader is enabled
Given I navigate to "Plugins > Logging > Manage log stores" in site administration
And I click on "Disable" "link" in the "Standard log" "table_row"
And I am on "Course 1" course homepage
When I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
Then I should see "No log reader enabled"
Scenario: Multiple views from a single user are identified as not distinct
Given I am on the "Course 1" course page logged in as student1
And I follow "Forum name"
And I am on "Course 1" course homepage
And I follow "Forum name"
And I am on "Course 1" course homepage
And I follow "Forum name"
And I am on site homepage
When I am on the "Course 1" course page logged in as teacher1
And I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
Then I should see "3 views by 1 users" in the "Forum name" "table_row"
And I should see "-" in the "Book name" "table_row"
Scenario: Multiple views from multiple users are identified as not distinct
Given I am on the "Course 1" course page logged in as student1
And I follow "Forum name"
And I am on "Course 1" course homepage
And I follow "Forum name"
And I am on "Course 1" course homepage
And I follow "Forum name"
And I am on site homepage
Given I am on the "Course 1" course page logged in as student2
And I follow "Forum name"
And I am on "Course 1" course homepage
And I follow "Forum name"
And I am on "Course 1" course homepage
And I follow "Forum name"
And I am on site homepage
When I am on the "Course 1" course page logged in as teacher1
And I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
Then I should see "6 views by 2 users" in the "Forum name" "table_row"
And I should see "-" in the "Book name" "table_row"
Scenario: No views from any users
When I am on the "Course 1" course page logged in as teacher1
And I navigate to "Reports" in current page administration
And I click on "Activity report" "link"
Then I should see "-" in the "Forum name" "table_row"
And I should see "-" in the "Book name" "table_row"
+66
View File
@@ -0,0 +1,66 @@
@report @report_outline
Feature: View the user page for the outline report
In order to ensure the user page for the outline report works as expected
As a student
I need to log in as a student and view the user page for the outline report
Background:
Given the following "courses" exist:
| fullname | shortname | format | showreports |
| Course 1 | C1 | topics | 1 |
And the following "users" exist:
| username | firstname | lastname | email |
| teacher1 | Teacher | 1 | teacher1@example.com |
| student1 | Student | 1 | student1@example.com |
And the following "course enrolments" exist:
| user | course | role |
| teacher1 | C1 | editingteacher |
| student1 | C1 | student |
And the following "activities" exist:
| activity | name | description | course | idnumber |
| folder | Folder name | Folder description | C1 | folder1 |
And the following "activities" exist:
| activity | name | description | course | idnumber | externalurl |
| url | URL name | URL description | C1 | folder1 | http://www.google.com |
When I log in as "admin"
Scenario: View the user page when only the standard log reader is enabled
Given I navigate to "Plugins > Logging > Manage log stores" in site administration
And "Disable" "link" should exist in the "Standard log" "table_row"
And I log out
And I log in as "student1"
And I am on "Course 1" course homepage
# We want to view this multiple times, to make sure the count is working.
And I follow "Folder name"
And I reload the page
And I reload the page
And I reload the page
And I am on "Course 1" course homepage
# We want to view this multiple times, to make sure the count is working.
And I follow "URL name"
And I reload the page
And I reload the page
And I follow "Profile" in the user menu
And I click on "Course 1" "link" in the "region-main" "region"
When I follow "Outline report"
Then I should see "4 views" in the "Folder name" "table_row"
And I should see "3 views" in the "URL name" "table_row"
And I follow "Profile" in the user menu
And I click on "Course 1" "link" in the "region-main" "region"
When I follow "Complete report"
And I should see "4 views"
And I should see "3 views"
Scenario: View the user complete report page when there is a no-grade forum
Given the following "activities" exist:
| activity | name | course | idnumber |
| forum | forum1 | C1 | forum1 |
And I am on "Course 1" course homepage
When I follow "Participants"
And I follow "Student 1"
And I follow "Outline report"
Then I should see "Activity report"
When I follow "Participants"
And I follow "Student 1"
And I follow "Complete report"
Then I should see "Activity report"
+141
View File
@@ -0,0 +1,141 @@
<?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/>.
/**
* Tests for report library functions.
*
* @package report_outline
* @copyright 2014 onwards Ankit agarwal <ankit.agrr@gmail.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later.
*/
namespace report_outline;
defined('MOODLE_INTERNAL') || die();
global $CFG;
/**
* Class report_outline_lib_testcase
*
* @package report_outline
* @copyright 2014 onwards Ankit agarwal <ankit.agrr@gmail.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later.
*/
class lib_test extends \advanced_testcase {
/**
* @var stdClass The user.
*/
private $user;
/**
* @var stdClass The course.
*/
private $course;
/**
* @var context_course Course context.
*/
private $coursecontext;
/**
* @var \core_user\output\myprofile\tree The navigation tree.
*/
private $tree;
/**
* @var int Dummy role for testing.
*/
private $roleid;
public function setUp(): void {
$this->user = $this->getDataGenerator()->create_user();
$this->course = $this->getDataGenerator()->create_course();
$this->tree = new \core_user\output\myprofile\tree();
$this->coursecontext = \context_course::instance($this->course->id);
$this->roleid = create_role('Dummy role', 'dummyrole', 'dummy role description');
$this->resetAfterTest();
}
/**
* Test report_log_supports_logstore.
*/
public function test_report_participation_supports_logstore(): void {
$logmanager = get_log_manager();
$allstores = \core_component::get_plugin_list_with_class('logstore', 'log\store');
$supportedstores = array(
'logstore_standard' => '\logstore_standard\log\store'
);
// Make sure all supported stores are installed.
$expectedstores = array_keys(array_intersect($allstores, $supportedstores));
$stores = $logmanager->get_supported_logstores('report_outline');
$stores = array_keys($stores);
foreach ($expectedstores as $expectedstore) {
$this->assertContains($expectedstore, $stores);
}
}
/**
* Tests the report_outline_myprofile_navigation() function as an admin user.
*/
public function test_report_outline_myprofile_navigation(): void {
$this->setAdminUser();
$iscurrentuser = false;
report_outline_myprofile_navigation($this->tree, $this->user, $iscurrentuser, $this->course);
$reflector = new \ReflectionObject($this->tree);
$nodes = $reflector->getProperty('nodes');
$this->assertArrayHasKey('outline', $nodes->getValue($this->tree));
$this->assertArrayHasKey('complete', $nodes->getValue($this->tree));
}
/**
* Tests the report_outline_myprofile_navigation() function as a user without permission.
*/
public function test_report_outline_myprofile_navigation_without_permission(): void {
$this->setUser($this->user);
$iscurrentuser = true;
report_outline_myprofile_navigation($this->tree, $this->user, $iscurrentuser, $this->course);
$reflector = new \ReflectionObject($this->tree);
$nodes = $reflector->getProperty('nodes');
$this->assertArrayNotHasKey('outline', $nodes->getValue($this->tree));
$this->assertArrayNotHasKey('complete', $nodes->getValue($this->tree));
}
/**
* Test that the current user can not access user report without report/outline:viewuserreport permission.
*/
public function test_report_outline_can_not_access_user_report_without_viewuserreport_permission(): void {
$this->getDataGenerator()->role_assign($this->roleid, $this->user->id, $this->coursecontext->id);
$this->setUser($this->user);
$this->assertFalse(report_outline_can_access_user_report($this->user, $this->course));
}
/**
* Test that the current user can access user report with report/outline:viewuserreport permission.
*/
public function test_report_outline_can_access_user_report_with_viewuserreport_permission(): void {
assign_capability('report/outline:viewuserreport', CAP_ALLOW, $this->roleid, $this->coursecontext->id, true);
$this->getDataGenerator()->role_assign($this->roleid, $this->user->id, $this->coursecontext->id);
$this->setUser($this->user);
$this->assertTrue(report_outline_can_access_user_report($this->user, $this->course));
}
}