Proyectos de Subversion Moodle

This files describes API changes for quiz report plugins.

Overview of this plugin type at http://docs.moodle.org/dev/Quiz_reports

=== 4.4 ===

* The function quiz_grading_report::format_count_for_table now requires a string identifier and

  a component identifier so that it is possible to address strings outside of

  quiz/report/grading/lang/en/quiz_grading.php.

* The function quiz_grading_renderer::render_grade_link now requires a string identifier and

  a component identifier so that it is possible to address strings outside of

  quiz/report/grading/lang/en/quiz_grading.php.

=== 4.2 ===

* There was an ill-advised, never documented, API change in quiz_report_get_significant_questions

  in Moodle 4.0. The API has now been reverted to how it was before 4.0. Hopefully this

  will not cause anyone a problem. (The API revert did not require any changes in any automated tests

  or standard quiz reports.)

* The quiz has a lot of old classes in lib.php files. These have now been moved into the classes folder,

  and so are now in namespaces. Because of Moodle's class renaming support, your code should continue

  working, but output deprecated warnings, so you probably want to update. This should mostly be

  doable by adding use statements, and a search/replace.

  - quiz_default_report => mod_quiz\local\reports\report_base

  - quiz_attempts_report => mod_quiz\local\reports\attempts_report

  - mod_quiz_attempts_report_form => mod_quiz\local\reports\attempts_report_options_form

  - mod_quiz_attempts_report_options => mod_quiz\local\reports\attempts_report_options

  - quiz_attempts_report_table => mod_quiz\local\reports\attempts_report_table

  As part of the clean-up, the following files are no longer required, and if you try to

  include them, you will get a debugging notices telling you not to:

  - mod/quiz/report/attemptsreport.php

  - mod/quiz/report/attemptsreport_form.php

  - mod/quiz/report/attemptsreport_options.php

  - mod/quiz/report/attemptsreport_table.php

  - mod/quiz/report/default.php

* Final deprecation (complete removal) of the following functions which were deprecated long ago:

  - attempts_report::load_relevant_students - deprecated in 3.2

  - quiz_statistics_graph_get_new_colour - deprecated since 3.2

  - The file mod/quiz/report/overview/overviewgraph.php - deprecated since 3.2

  - The file mod/quiz/report/statistics/statistics_graph.php - deprecated since 3.2

=== 3.9 ===

* Quiz report plugins defining capabilities used to require an extra string like

    $string['statistics:componentname'] = 'Quiz statistics report';

in addition to

    $string['pluginname'] = 'Statistics';

This is no longer required.

=== 3.8 ===

* New quiz_attempts_report_table method: \quiz_attempts_report_table::checkbox_col_header()

  This generates a column header containing a checkbox that toggles the checked state of all the checkboxes corresponding to the

  entries listed on a given quiz report table. It requires the name of the checkbox column as a parameter in order to disable

  sorting on the checkbox column.

=== 3.2 ===

* A code refactoring based on new sql functions in MDL-31243 and removing

get_users_by_capability from the quiz reports in MDL-27072. The class

quiz_attempts_report is now initialised to return \core\dml\sql_join (joins,

wheres, params) rather than arrays of userids. This allows the use of joins

in quiz report queries and is very important when there

are larger numbers of enrolled users. The signature of many quiz report

methods now includes '$studentsjoins', rather than '$students' and similar

for '$groupstudentsjoins', '$allowedjoins' and '$usersjoins'. For clear

examples of the use of these changes please see attemptsreport_table.php

base_sql() or almost any function in overview/report.php. The protected

function quiz_attempts_report::load_relevant_students is deprecated,

please use quiz_attempts_report::get_students_joins() instead.

=== 2.6 ===

* Improving the display page and heading levels to have a proper nesting.

We are reducing the amount of white spaces for the top report by making

'separate group' options and attempts to be displayed inline.

In grading report, we are changing 'no questions' from using heading to

notification message. (MDL-41615)

=== 2.3 ===

* Support for the old way of doing cron in a separate cron.php file has been removed.

Instead, you need a lib.php file inside the plugin with a cron function

called quiz_myreportname_cron(). The statistics report is an example of how

it should be done.

* There was a big refactor of the quiz reports, in issues MDL-32300, MDL-32322 and MDL-3030.

It is difficult to explain the changes. Probably the best way to understand what

happened is to look at

    git log mod/quiz/report/overview

    git log mod/quiz/report/responses

and so on. Here are some notes on a few of the changes:

The class quiz_attempt_report was renamed to quiz_attempts_report (with an extra s).

Some globally defined constants with the prefix QUIZ_REPORT_ATTEMPTS_ moved into

the quiz_attempts_report class. Specifically

quiz_attempts_report::ALL_WITH         replaces QUIZ_REPORT_ATTEMPTS_ALL

quiz_attempts_report::ENROLLED_ALL     replaces QUIZ_REPORT_ATTEMPTS_ALL_STUDENTS

quiz_attempts_report::ENROLLED_WITH    replaces QUIZ_REPORT_ATTEMPTS_STUDENTS_WITH

quiz_attempts_report::ENROLLED_WITHOUT replaces QUIZ_REPORT_ATTEMPTS_STUDENTS_WITH_NO

Your if you have a table class, it needs to be renamed like

quiz_report_myreportname_table -> quiz_myreportname_table. That is, all the

class names in your plugin should start with the frankenstyle plugin name

quiz_myreportname.

=== 2.2 ===

* Plugins should be converted to implement cron in the standard way. In lib.php,

define a

function quiz_myreportname_cron() {};

This replaces the old way of having a separate cron.php file. Also, the cron

frequency should be defined in version.php, not in the quiz_reports table.

=== earlier versions ===

* ... API changes were not documented properly. Sorry. (There weren't many!)