 |
Moodle APIs 4.3
Moodle 4.3.6 (Build: 20240812)
|
|
Moodle APIs 4.3
Moodle 4.3.6 (Build: 20240812)
|
library class for file feedback plugin extending feedback plugin base class More...
Public Member Functions | |
| can_upgrade ($type, $version) | |
| Return true if this plugin can upgrade an old Moodle 2.2 assignment of this type and version. | |
| data_preprocessing (&$defaultvalues) | |
| Allows the plugin to update the defaultvalues passed in to the settings form (needed to set up draft areas for editor and filemanager elements) | |
| delete_instance () | |
| The assignment has been deleted - remove the plugin specific data. | |
| disable () | |
| Set this plugin to disabled. | |
| download_grades () | |
| Download a marking worksheet. | |
| enable () | |
| Set this plugin to enabled. | |
| files_for_gradebook (stdClass $grade) | |
| Return any files this plugin wishes to save to the gradebook. | |
| format_for_gradebook (stdClass $grade) | |
| If this plugin adds to the gradebook comments field, it must specify the format of the comment. | |
| format_for_log () | |
| get_config ($setting=null) | |
| Get a configuration value for this plugin. | |
| get_config_file_areas () | |
| Get a list of file areas associated with the plugin configuration. | |
| get_config_for_external () | |
| Return the plugin configs for external functions. | |
| get_editor_fields () | |
| Return a list of the fields that can be exported or imported via text. | |
| get_editor_format ($name, $submissionid) | |
| Given a field name, should return the format of an editor field that is part of this plugin. | |
| get_editor_text ($name, $submissionorgradeid) | |
| Given a field name, should return the text of an editor field that is part of this plugin. | |
| get_error () | |
| What was the last error? | |
| get_external_parameters () | |
| If this plugin can participate in a webservice (save_submission or save_grade), return a list of external_params to be included in the definition of that webservice. | |
| get_file_areas () | |
| Get file areas returns a list of areas this plugin stores files. | |
| get_file_info ($browser, $filearea, $itemid, $filepath, $filename) | |
| Default implementation of file_get_info for plugins. | |
| get_files (stdClass $submissionorgrade, stdClass $user) | |
| Produce a list of files suitable for export that represent this feedback or submission. | |
| get_form_elements ($grade, MoodleQuickForm $mform, stdClass $data) | |
| Get form elements for grading form. | |
| get_form_elements_for_user ($submissionorgrade, MoodleQuickForm $mform, stdClass $data, $userid) | |
| Get any additional fields for the submission/grading form for this assignment. | |
| get_grading_actions () | |
| Return a list of the grading actions performed by this plugin This plugin supports upload zip. | |
| get_grading_batch_operations () | |
| Return a list of the batch grading operations supported by this plugin. | |
| get_name () | |
| Get the name of the file feedback plugin. | |
| get_quickgrading_html ($userid, $grade) | |
| Get quickgrading form elements as html. | |
| get_requires () | |
| Get the required moodle version for this plugin. | |
| get_settings (MoodleQuickForm $mform) | |
| This function should be overridden to provide an array of elements that can be added to a moodle form for display in the settings page for the assignment. | |
| get_sort_order () | |
| Get the numerical sort order for this plugin. | |
| get_subtype () | |
| Return subtype name of the plugin. | |
| get_type () | |
| Should return the type of this plugin. | |
| get_version () | |
| Get the installed version of this plugin. | |
| grading_action ($gradingaction) | |
| Show a grading action form. | |
| grading_batch_operation ($action, $users) | |
| Show a batch operations form. | |
| has_admin_settings () | |
| Has this plugin got a custom settings.php file? | |
| has_user_summary () | |
| Do not show this plugin in the grading table or on the front page. | |
| is_configurable () | |
| If true, the plugin will appear on the module settings page and can be enabled/disabled per assignment instance. | |
| is_empty (stdClass $grade) | |
| Return true if there are no feedback files. | |
| is_enabled () | |
| Override the default is_enabled to disable this plugin if advanced grading is active. | |
| is_feedback_modified (stdClass $grade, stdClass $data) | |
| This plugin does not save through the normal interface so this returns false. | |
| is_first () | |
| Is this the first plugin in the list? | |
| is_last () | |
| Is this the last plugin in the list? | |
| is_quickgrading_modified ($userid, $grade) | |
| Has the plugin quickgrading form element been modified in the current form submission? | |
| is_visible () | |
| Is this plugin enaled? | |
| process_import_grades ($draftid, $importid, $ignoremodified, $encoding='utf-8', $separator='comma') | |
| Loop through uploaded grades and update the grades for this assignment. | |
| save (stdClass $submissionorgrade, stdClass $data) | |
| Save any custom data for this form submission. | |
| save_quickgrading_changes ($userid, $grade) | |
| Save quickgrading changes. | |
| save_settings (stdClass $formdata) | |
| The assignment subtype is responsible for saving it's own settings as the database table for the standard type cannot be modified. | |
| set_config ($name, $value) | |
| Set a configuration value for this plugin. | |
| set_editor_format ($name, $format, $submissionorgradeid) | |
| Given a field name and value should update the format for this field in the plugins submission or grade. | |
| set_editor_text ($name, $value, $submissionorgradeid) | |
| Given a field name and value should update the text for this field in the plugins submission or grade. | |
| supports_quickgrading () | |
| Override to indicate a plugin supports quickgrading. | |
| supports_review_panel () | |
| Supports injecting content into the review panel of the grading app. | |
| text_for_gradebook (stdClass $grade) | |
| If this plugin adds to the gradebook comments field, it must format the text of the comment. | |
| upgrade (context $oldcontext, stdClass $oldassignment, stdClass $oldsubmissionorgrade, stdClass $submissionorgrade, & $log) | |
| Upgrade the submission from the old assignment to the new one. | |
| upgrade_settings (context $oldcontext, stdClass $oldassignment, & $log) | |
| Upgrade the settings from the old assignment to the new one. | |
| upload_grades () | |
| Display upload grades form. | |
| view (stdClass $submissionorgrade) | |
| Should not output anything - return the result as a string so it can be consumed by webservices. | |
| view_header () | |
| This allows a plugin to render an introductory section which is displayed right below the activity's "intro" section on the main assignment page. | |
| view_page ($action) | |
| Print a sub page in this plugin. | |
| view_summary (stdClass $submissionorgrade, & $showviewlink) | |
| Should not output anything - return the result as a string so it can be consumed by webservices. | |
Static Public Member Functions | |
| static | cron () |
| Run cron for this plugin. | |
Protected Member Functions | |
| set_error ($msg) | |
| Save the error message from the last error. | |
Protected Attributes | |
| assign | $assignment |
| $assignment the assignment record that contains the global settings for this assign instance | |
library class for file feedback plugin extending feedback plugin base class
|
inherited |
Return true if this plugin can upgrade an old Moodle 2.2 assignment of this type and version.
| string | $type | The old assignment subtype |
| int | $version | The old assignment version |
| bool | True if upgrade is possible |
Reimplemented in assign_feedback_comments, assign_feedback_file, assign_submission_comments, assign_submission_file, and assign_submission_onlinetext.
|
inherited |
Allows the plugin to update the defaultvalues passed in to the settings form (needed to set up draft areas for editor and filemanager elements)
| array | $defaultvalues |
|
inherited |
The assignment has been deleted - remove the plugin specific data.
| bool |
Reimplemented in assign_feedback_comments, assign_feedback_editpdf, assign_feedback_file, assign_submission_file, and assign_submission_onlinetext.
|
finalinherited |
Set this plugin to disabled.
| bool |
| assign_feedback_offline::download_grades | ( | ) |
Download a marking worksheet.
| string | The response html |
|
finalinherited |
Set this plugin to enabled.
| bool |
|
inherited |
Return any files this plugin wishes to save to the gradebook.
The array being returned should contain the necessary information to identify and copy the files.
eg.
[ 'contextid' => $modulecontext->id, 'component' => ASSIGNFEEDBACK_XYZ_COMPONENT, 'filearea' => ASSIGNFEEDBACK_XYZ_FILEAREA, 'itemid' => $grade->id ]
| stdClass | $grade | The assign_grades object from the db |
| array |
Reimplemented in assign_feedback_comments.
|
inherited |
If this plugin adds to the gradebook comments field, it must specify the format of the comment.
(From weblib.php) define('FORMAT_MOODLE', '0'); // Does all sorts of transformations and filtering define('FORMAT_HTML', '1'); // Plain HTML (with some tags stripped) define('FORMAT_PLAIN', '2'); // Plain text (even tags are printed in full) define('FORMAT_WIKI', '3'); // Wiki-formatted text define('FORMAT_MARKDOWN', '4'); // Markdown-formatted
Only one feedback plugin can push comments to the gradebook and that is chosen by the assignment settings page.
| stdClass | $grade | The grade |
| int |
Reimplemented in assign_feedback_comments.
|
inherited |
|
finalinherited |
Get a configuration value for this plugin.
| mixed | $setting | The config key (string) or null |
| mixed | string | false |
|
inherited |
Get a list of file areas associated with the plugin configuration.
This is used for backup/restore.
| array | names of the fileareas, can be an empty array |
| assign_feedback_offline::get_config_for_external | ( | ) |
Return the plugin configs for external functions.
| array | the list of settings |
Reimplemented from assign_plugin.
|
inherited |
Return a list of the fields that can be exported or imported via text.
| array | - The list of field names (strings) and descriptions. ($name => $description) |
Reimplemented in assign_feedback_comments, and assign_submission_onlinetext.
|
inherited |
Given a field name, should return the format of an editor field that is part of this plugin.
This is used when exporting to portfolio.
| string | $name | Name of the field. |
| int | $submissionid | The id of the submission |
| int | - The format for the editor field |
Reimplemented in assign_submission_onlinetext.
|
inherited |
Given a field name, should return the text of an editor field that is part of this plugin.
This is used when exporting to portfolio.
| string | $name | Name of the field. |
| int | $submissionorgradeid | The id of the submission or grade |
| string | - The text for the editor field |
Reimplemented in assign_feedback_comments, and assign_submission_onlinetext.
|
finalinherited |
What was the last error?
| string |
|
inherited |
If this plugin can participate in a webservice (save_submission or save_grade), return a list of external_params to be included in the definition of that webservice.
| external_description|null |
Reimplemented in assign_feedback_comments, assign_feedback_file, assign_submission_file, and assign_submission_onlinetext.
|
inherited |
Get file areas returns a list of areas this plugin stores files.
| array | - An array of fileareas (keys) and descriptions (values) |
Reimplemented in assign_feedback_comments, assign_feedback_editpdf, assign_feedback_file, assign_submission_file, and assign_submission_onlinetext.
|
inherited |
Default implementation of file_get_info for plugins.
This is used by the filebrowser to browse a plugins file areas.
This implementation should work for most plugins but can be overridden if required.
| file_browser | $browser | |
| string | $filearea | |
| int | $itemid | |
| string | $filepath | |
| string | $filename |
| file_info_stored |
|
inherited |
Produce a list of files suitable for export that represent this feedback or submission.
| stdClass | $submissionorgrade | assign_submission or assign_grade For submission plugins this is the submission data, for feedback plugins it is the grade data |
| stdClass | $user | The user record for the current submission. Needed for url rewriting if this is a group submission. |
| array | - return an array of files indexed by filename |
Reimplemented in assign_submission_file, and assign_submission_onlinetext.
| assign_feedback_offline::get_form_elements | ( | $grade, | |
| MoodleQuickForm | $mform, | ||
| stdClass | $data ) |
Get form elements for grading form.
| stdClass | $grade | |
| MoodleQuickForm | $mform | |
| stdClass | $data |
| bool | true if elements were added to the form |
Reimplemented from assign_plugin.
|
inherited |
Get any additional fields for the submission/grading form for this assignment.
| mixed | $submissionorgrade | submission|grade - For submission plugins this is the submission data, for feedback plugins it is the grade data |
| MoodleQuickForm | $mform | - This is the form |
| stdClass | $data | - This is the form data that can be modified for example by a filemanager element |
| int | $userid | - This is the userid for the current submission. This is passed separately as there may not yet be a submission or grade. |
| boolean | - true if we added anything to the form |
Reimplemented in assign_feedback_comments, assign_feedback_editpdf, and assign_feedback_file.
| assign_feedback_offline::get_grading_actions | ( | ) |
Return a list of the grading actions performed by this plugin This plugin supports upload zip.
| array | The list of grading actions |
Reimplemented from assign_feedback_plugin.
|
inherited |
Return a list of the batch grading operations supported by this plugin.
| array | - An array of action and description strings. The action will be passed to grading_batch_operation. |
Reimplemented in assign_feedback_file.
| assign_feedback_offline::get_name | ( | ) |
|
inherited |
Get quickgrading form elements as html.
| int | $userid | The user id in the table this quickgrading element relates to |
| mixed | $grade | grade or null - The grade data. May be null if there are no grades for this user (yet) |
| mixed | - A html string containing the html form elements required for quickgrading or false to indicate this plugin does not support quickgrading |
Reimplemented in assign_feedback_comments.
|
finalinherited |
Get the required moodle version for this plugin.
| string |
|
inherited |
This function should be overridden to provide an array of elements that can be added to a moodle form for display in the settings page for the assignment.
| MoodleQuickForm | $mform | The form to add the elements to |
| $array |
Reimplemented in assign_feedback_comments, assign_submission_file, and assign_submission_onlinetext.
|
finalinherited |
Get the numerical sort order for this plugin.
| int |
|
inherited |
|
finalinherited |
Should return the type of this plugin.
| string | - the type |
|
finalinherited |
Get the installed version of this plugin.
| string |
|
inherited |
Show a grading action form.
| string | $gradingaction | The action chosen from the grading actions menu |
| string | The page containing the form |
|
inherited |
Show a batch operations form.
| string | $action | The action chosen from the batch operations menu |
| array | $users | The list of selected userids |
| string | The page containing the form |
Reimplemented in assign_feedback_file.
|
finalinherited |
Has this plugin got a custom settings.php file?
| bool |
| assign_feedback_offline::has_user_summary | ( | ) |
Do not show this plugin in the grading table or on the front page.
| bool |
Reimplemented from assign_plugin.
|
inherited |
If true, the plugin will appear on the module settings page and can be enabled/disabled per assignment instance.
| bool |
Reimplemented in assign_feedback_editpdf, and assign_submission_comments.
| assign_feedback_offline::is_empty | ( | stdClass | $grade | ) |
Return true if there are no feedback files.
| stdClass | $grade |
Reimplemented from assign_plugin.
| assign_feedback_offline::is_enabled | ( | ) |
Override the default is_enabled to disable this plugin if advanced grading is active.
| bool |
Reimplemented from assign_plugin.
| assign_feedback_offline::is_feedback_modified | ( | stdClass | $grade, |
| stdClass | $data ) |
This plugin does not save through the normal interface so this returns false.
| stdClass | $grade | The grade. |
| stdClass | $data | Form data from the feedback form. |
| boolean | - False |
Reimplemented from assign_feedback_plugin.
|
finalinherited |
Is this the first plugin in the list?
| bool |
|
finalinherited |
Is this the last plugin in the list?
| bool |
|
inherited |
Has the plugin quickgrading form element been modified in the current form submission?
| int | $userid | The user id in the table this quickgrading element relates to |
| stdClass | $grade | The grade |
| boolean | - true if the quickgrading form element has been modified |
Reimplemented in assign_feedback_comments.
|
finalinherited |
Is this plugin enaled?
| bool |
| assign_feedback_offline::process_import_grades | ( | $draftid, | |
| $importid, | |||
| $ignoremodified, | |||
| $encoding = 'utf-8', | |||
| $separator = 'comma' ) |
Loop through uploaded grades and update the grades for this assignment.
| int | $draftid | - The unique draft item id for this import |
| int | $importid | - The unique import ID for this csv import operation |
| bool | $ignoremodified | - Ignore the last modified date when checking fields |
| string | $encoding | - Encoding of the file being processed. |
| string | $separator | - The character used to separate the information. |
| string | - The html response |
|
inherited |
Save any custom data for this form submission.
| stdClass | $submissionorgrade | - assign_submission or assign_grade. For submission plugins this is the submission data, for feedback plugins it is the grade data |
| stdClass | $data | - the data submitted from the form |
| bool | - on error the subtype should call set_error and return false. |
Reimplemented in assign_feedback_comments, assign_feedback_editpdf, assign_feedback_file, assign_submission_file, and assign_submission_onlinetext.
|
inherited |
Save quickgrading changes.
| int | $userid | The user id in the table this quickgrading element relates to |
| stdClass | $grade | The grade |
| boolean | - true if the grade changes were saved correctly |
Reimplemented in assign_feedback_comments.
|
inherited |
The assignment subtype is responsible for saving it's own settings as the database table for the standard type cannot be modified.
| stdClass | $formdata | - the data submitted from the form |
| bool | - on error the subtype should call set_error and return false. |
Reimplemented in assign_feedback_comments, assign_submission_file, and assign_submission_onlinetext.
|
finalinherited |
Set a configuration value for this plugin.
| string | $name | The config key |
| string | $value | The config value |
| bool |
|
inherited |
Given a field name and value should update the format for this field in the plugins submission or grade.
| string | $name | Name of the field. |
| int | $format | Updated format. |
| int | $submissionorgradeid | The id of the submission or grade. |
| bool | - true if the value was updated |
|
inherited |
Given a field name and value should update the text for this field in the plugins submission or grade.
| string | $name | Name of the field. |
| string | $value | Updated text |
| int | $submissionorgradeid | The id of the submission or grade |
| bool | - true if the value was updated |
Reimplemented in assign_feedback_comments.
|
finalprotectedinherited |
Save the error message from the last error.
| string | $msg | - the error description |
|
inherited |
Override to indicate a plugin supports quickgrading.
| boolean | - True if the plugin supports quickgrading |
Reimplemented in assign_feedback_comments.
|
inherited |
Supports injecting content into the review panel of the grading app.
| bool | True if this plugin will add content to the review panel of the grading app. |
Reimplemented in assign_feedback_editpdf.
|
inherited |
If this plugin adds to the gradebook comments field, it must format the text of the comment.
Only one feedback plugin can push comments to the gradebook and that is chosen by the assignment settings page.
| stdClass | $grade | The grade |
| string |
Reimplemented in assign_feedback_comments.
|
inherited |
Upgrade the submission from the old assignment to the new one.
| context | $oldcontext | The data record for the old context |
| stdClass | $oldassignment | The data record for the old assignment |
| stdClass | $oldsubmissionorgrade | The data record for the old submission |
| stdClass | $submissionorgrade | assign_submission or assign_grade The new submission or grade |
| string | $log | Record upgrade messages in the log |
| boolean | true or false - false will trigger a rollback |
Reimplemented in assign_feedback_comments, assign_feedback_file, assign_submission_comments, assign_submission_file, and assign_submission_onlinetext.
|
inherited |
Upgrade the settings from the old assignment to the new one.
| context | $oldcontext | The context for the old assignment module |
| stdClass | $oldassignment | The data record for the old assignment |
| string | $log | Record upgrade messages in the log |
| bool | true or false - false will trigger a rollback |
Reimplemented in assign_feedback_comments, assign_feedback_file, assign_submission_comments, assign_submission_file, and assign_submission_onlinetext.
| assign_feedback_offline::upload_grades | ( | ) |
Display upload grades form.
| string | The response html |
|
inherited |
Should not output anything - return the result as a string so it can be consumed by webservices.
| stdClass | $submissionorgrade | assign_submission or assign_grade For submission plugins this is the submission data, for feedback plugins it is the grade data |
| string | - return a string representation of the submission in full |
Reimplemented in assign_feedback_comments, assign_feedback_editpdf, assign_feedback_file, assign_submission_file, and assign_submission_onlinetext.
|
inherited |
This allows a plugin to render an introductory section which is displayed right below the activity's "intro" section on the main assignment page.
| string |
| assign_feedback_offline::view_page | ( | $action | ) |
Print a sub page in this plugin.
| string | $action | - The plugin action |
| string | The response html |
Reimplemented from assign_plugin.
|
inherited |
Should not output anything - return the result as a string so it can be consumed by webservices.
| stdClass | $submissionorgrade | assign_submission or assign_grade For submission plugins this is the submission data, for feedback plugins it is the grade data |
| bool | $showviewlink | Modifed to return whether or not to show a link to the full submission/feedback |
| string | - return a string representation of the submission in full |
Reimplemented in assign_feedback_comments, assign_feedback_editpdf, assign_feedback_file, assign_submission_comments, assign_submission_file, and assign_submission_onlinetext.
1.11.0