tool_policy\event\acceptance_updated Class Reference

Event acceptance_updated. More...

Inheritance diagram for tool_policy\event\acceptance_updated:

Public Member Functions
	__get ($name)
	Magic getter for read only access. More...
	__isset ($name)
	Is data property set? More...
	__set ($name, $value)
	Magic setter. More...
	add_record_snapshot ($tablename, $record)
	Add cached data that will be most probably used in event observers. More...
	can_view ($user_or_id=null)
	This method was originally intended for granular access control on the event level, unfortunately the proper implementation would be too expensive in many cases. More...
	get_context ()
	Returns event context. More...
	get_data ()
	Return standardised event data as array. More...
	get_description ()
	Get the event description. More...
	get_logextra ()
	Return auxiliary data that was stored in logs. More...
	get_record_snapshot ($tablename, $id)
	Returns cached record or fetches data from database if not cached. More...
	get_url ()
	Get URL related to the action. More...
	getIterator ()
	Create an iterator because magic vars can't be seen by 'foreach'. More...
	is_dispatched ()
	Used from event manager to prevent direct access. More...
	is_restored ()
	Was this event restored? More...
	is_triggered ()
	Was this event already triggered? More...
	trigger ()
	Trigger event.

Static Public Member Functions
static	create (array $data=null)
	Create new event. More...
static	create_from_record ($record)
	Create event from record. More...
static	get_explanation ()
	Get an explanation of what the class does. More...
static	get_legacy_eventname ()
	Does this event replace legacy event? More...
static	get_name ()
	Returns event name. More...
static	get_name_with_info ()
	Returns the event name complete with metadata information. More...
static	get_objectid_mapping ()
	Get the object ID mapping. More...
static	get_other_mapping ()
	No mapping required for this event because this event is not backed up. More...
static	get_static_info ()
	Get static information about an event. More...
static	is_deprecated ()
	Whether this event has been marked as deprecated. More...
static	restore (array $data, array $logextra)
	Restore event from existing historic data. More...
static	restore_legacy ($legacy)
	Create fake event from legacy log data. More...

Public Attributes
const	LEVEL_OTHER = 0
	Other level.
const	LEVEL_PARTICIPATING = 2
	Participating level. More...
const	LEVEL_TEACHING = 1
	Teaching level. More...
const	NOT_FOUND = -31338
	The value used when an id can not be found during a restore.
const	NOT_MAPPED = -31337
	The value used when an id can not be mapped during a restore.
const	USER_NOTLOGGEDIN = 0
	User id to use when the user is not logged in.
const	USER_OTHER = -1
	User id to use when actor is not an actual user but system, cli or cron.

Protected Member Functions
	get_legacy_eventdata ()
	Legacy event data if get_legacy_eventname() is not empty. More...
	get_legacy_logdata ()
	Doest this event replace add_to_log() statement? More...
	init ()
	Initialise the event.
	validate_before_trigger ()
	Validate all properties right before triggering the event. More...
	validate_data ()
	Custom validation. More...

Static Protected Member Functions
static	restore_unknown (array $data, array $logextra)
	Restore unknown event. More...

Protected Attributes
context	$context
	of this event
array	$data
	event data
array	$logextra
	the format is standardised by logging API

Detailed Description

Event acceptance_updated.

Copyright

2018 Marina Glancy

License

http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

__get()

core\event\base::__get (   $name )

inherited

Magic getter for read only access.

Parameters

string

$name

Return values

mixed

__isset()

core\event\base::__isset (   $name )

inherited

Is data property set?

Parameters

string

$name

Return values

bool

__set()

core\event\base::__set (   $name,   $value  )

inherited

Magic setter.

Note: we must not allow modification of data from outside, after trigger() the data MUST NOT CHANGE!!!

Parameters

string	$name
mixed	$value

Exceptions

coding_exception

add_record_snapshot()

core\event\base::add_record_snapshot (   $tablename,   $record  )

finalinherited

Add cached data that will be most probably used in event observers.

This is used to improve performance, but it is required for data that was just deleted.

Parameters

string	$tablename
stdClass	$record

Exceptions

coding_exception

if used after ::trigger()

can_view()

core\event\base::can_view (   $user_or_id = null )

inherited

This method was originally intended for granular access control on the event level, unfortunately the proper implementation would be too expensive in many cases.

Deprecated:

since 2.7

Parameters

int | stdClass

$user_or_id

ID of the user.

Return values

bool	True if the user can view the event, false otherwise.

Reimplemented in mod_feedback\event\response_submitted, mod_feedback\event\response_deleted, and mod_feedback\event\course_module_viewed.

create()

static core\event\base::create ( array  $data = null )

staticfinalinherited

Create new event.

The optional data keys as: 1/ objectid - the id of the object specified in class name 2/ context - the context of this event 3/ other - the other data describing the event, can not contain objects 4/ relateduserid - the id of user which is somehow related to this event

Parameters

array

$data

Return values

core

create_from_record()

static tool_policy\event\acceptance_base::create_from_record (   $record )

staticinherited

Create event from record.

Parameters

stdClass

$record

Return values

acceptance_created

get_context()

core\event\base::get_context ( )

inherited

Returns event context.

Return values

context

get_data()

core\event\base::get_data ( )

inherited

Return standardised event data as array.

Return values

array

All elements are scalars except the 'other' field which is array.

get_description()

tool_policy\event\acceptance_updated::get_description

(

)

Get the event description.

Return values

string

Reimplemented from core\event\base.

get_explanation()

static core\event\base::get_explanation ( )

staticinherited

Get an explanation of what the class does.

By default returns the phpdocs from the child event class. Ideally this should be overridden to return a translatable get_string style markdown. e.g. return new lang_string('eventyourspecialevent', 'plugin_type');

Return values

string

An explanation of the event formatted in markdown style.

get_legacy_eventdata()

core\event\base::get_legacy_eventdata ( )

protectedinherited

Legacy event data if get_legacy_eventname() is not empty.

Note: do not use directly!

Return values

mixed

Reimplemented in mod_workshop\event\course_module_viewed, mod_workshop\event\assessable_uploaded, mod_quiz\event\attempt_submitted, mod_quiz\event\attempt_started, mod_quiz\event\attempt_becameoverdue, mod_quiz\event\attempt_abandoned, mod_lti\event\unknown_service_api_called, mod_forum\event\assessable_uploaded, assignsubmission_onlinetext\event\assessable_uploaded, assignsubmission_file\event\assessable_uploaded, mod_assign\event\assessable_submitted, core\event\user_updated, core\event\user_loggedout, core\event\user_enrolment_updated, core\event\user_enrolment_deleted, core\event\user_enrolment_created, core\event\user_deleted, core\event\user_created, core\event\role_unassigned, core\event\role_assigned, core\event\grouping_updated, core\event\grouping_deleted, core\event\grouping_created, core\event\group_updated, core\event\group_member_removed, core\event\group_member_added, core\event\group_deleted, core\event\group_created, core\event\course_updated, core\event\course_restored, core\event\course_module_updated, core\event\course_module_deleted, core\event\course_module_created, core\event\course_module_completion_updated, core\event\course_deleted, core\event\course_created, core\event\course_content_deleted, core\event\course_completed, core\event\course_category_deleted, core\event\cohort_updated, core\event\cohort_member_removed, core\event\cohort_member_added, core\event\cohort_deleted, core\event\cohort_created, core\event\blog_entry_updated, core\event\blog_entry_deleted, and core\event\blog_entry_created.

get_legacy_eventname()

static core\event\base::get_legacy_eventname ( )

staticinherited

Does this event replace legacy event?

Note: do not use directly!

Return values

null|string

legacy event name

Reimplemented in mod_workshop\event\course_module_viewed, mod_workshop\event\assessable_uploaded, mod_quiz\event\attempt_submitted, mod_quiz\event\attempt_started, mod_quiz\event\attempt_becameoverdue, mod_quiz\event\attempt_abandoned, mod_lti\event\unknown_service_api_called, mod_forum\event\assessable_uploaded, assignsubmission_onlinetext\event\assessable_uploaded, assignsubmission_file\event\assessable_uploaded, mod_assign\event\assessable_submitted, core\event\user_updated, core\event\user_loggedout, core\event\user_enrolment_updated, core\event\user_enrolment_deleted, core\event\user_enrolment_created, core\event\user_deleted, core\event\user_created, core\event\role_unassigned, core\event\role_assigned, core\event\grouping_updated, core\event\grouping_deleted, core\event\grouping_created, core\event\group_updated, core\event\group_member_removed, core\event\group_member_added, core\event\group_deleted, core\event\group_created, core\event\course_updated, core\event\course_restored, core\event\course_module_updated, core\event\course_module_deleted, core\event\course_module_created, core\event\course_module_completion_updated, core\event\course_deleted, core\event\course_created, core\event\course_content_deleted, core\event\course_completed, core\event\course_category_deleted, core\event\cohort_updated, core\event\cohort_member_removed, core\event\cohort_member_added, core\event\cohort_deleted, core\event\cohort_created, core\event\blog_entry_updated, core\event\blog_entry_deleted, core\event\blog_entry_created, core_h5p\event\h5p_viewed, and core_h5p\event\h5p_deleted.

get_legacy_logdata()

core\event\base::get_legacy_logdata ( )

protectedinherited

Doest this event replace add_to_log() statement?

Note: do not use directly!

Return values

null|array

of parameters to be passed to legacy add_to_log() function.

Reimplemented in report_stats\event\user_report_viewed, report_stats\event\report_viewed, report_questioninstances\event\report_viewed, report_participation\event\report_viewed, report_outline\event\report_viewed, report_outline\event\activity_report_viewed, report_loglive\event\report_viewed, report_log\event\user_report_viewed, report_log\event\report_viewed, report_completion\event\user_report_viewed, mod_workshop\event\submission_viewed, mod_workshop\event\submission_updated, mod_workshop\event\submission_reassessed, mod_workshop\event\submission_deleted, mod_workshop\event\submission_created, mod_workshop\event\submission_assessed, mod_workshop\event\phase_switched, mod_workshop\event\assessments_reset, mod_workshop\event\assessment_reevaluated, mod_workshop\event\assessment_evaluations_reset, mod_workshop\event\assessable_uploaded, mod_wiki\event\page_viewed, mod_wiki\event\page_version_viewed, mod_wiki\event\page_version_restored, mod_wiki\event\page_version_deleted, mod_wiki\event\page_updated, mod_wiki\event\page_map_viewed, mod_wiki\event\page_locks_deleted, mod_wiki\event\page_history_viewed, mod_wiki\event\page_diff_viewed, mod_wiki\event\page_deleted, mod_wiki\event\page_created, mod_wiki\event\comments_viewed, mod_survey\event\response_submitted, mod_survey\event\report_viewed, mod_survey\event\report_downloaded, mod_survey\event\course_module_viewed, mod_scorm\event\user_report_viewed, mod_scorm\event\tracks_viewed, mod_scorm\event\sco_launched, mod_scorm\event\report_viewed, mod_scorm\event\interactions_viewed, mod_scorm\event\course_module_viewed, mod_scorm\event\attempt_deleted, mod_quiz\event\user_override_updated, mod_quiz\event\user_override_deleted, mod_quiz\event\report_viewed, mod_quiz\event\question_manually_graded, mod_quiz\event\group_override_updated, mod_quiz\event\group_override_deleted, mod_quiz\event\edit_page_viewed, mod_quiz\event\attempt_viewed, mod_quiz\event\attempt_summary_viewed, mod_quiz\event\attempt_started, mod_quiz\event\attempt_reviewed, mod_quiz\event\attempt_preview_started, mod_quiz\event\attempt_deleted, mod_lesson\event\lesson_started, mod_lesson\event\lesson_ended, mod_lesson\event\highscores_viewed, mod_lesson\event\highscore_added, mod_lesson\event\essay_attempt_viewed, mod_lesson\event\essay_assessed, mod_glossary\event\entry_viewed, mod_glossary\event\entry_updated, mod_glossary\event\entry_disapproved, mod_glossary\event\entry_deleted, mod_glossary\event\entry_created, mod_glossary\event\entry_approved, mod_glossary\event\course_module_viewed, mod_glossary\event\category_updated, mod_glossary\event\category_deleted, mod_glossary\event\category_created, mod_forum\event\user_report_viewed, mod_forum\event\subscription_deleted, mod_forum\event\subscription_created, mod_forum\event\subscribers_viewed, mod_forum\event\readtracking_enabled, mod_forum\event\readtracking_disabled, mod_forum\event\post_updated, mod_forum\event\post_deleted, mod_forum\event\post_created, mod_forum\event\discussion_viewed, mod_forum\event\discussion_unpinned, mod_forum\event\discussion_pinned, mod_forum\event\discussion_moved, mod_forum\event\discussion_deleted, mod_forum\event\discussion_created, mod_forum\event\course_searched, mod_forum\event\course_module_viewed, mod_folder\event\folder_updated, mod_feedback\event\response_submitted, mod_feedback\event\response_deleted, mod_feedback\event\course_module_viewed, mod_data\event\template_viewed, mod_data\event\template_updated, mod_data\event\record_updated, mod_data\event\record_deleted, mod_data\event\record_created, mod_data\event\field_updated, mod_data\event\field_deleted, mod_data\event\field_created, mod_choice\event\report_viewed, mod_choice\event\answer_updated, mod_choice\event\answer_submitted, mod_chat\event\sessions_viewed, mod_chat\event\message_sent, booktool_print\event\chapter_printed, booktool_print\event\book_printed, booktool_exportimscp\event\book_exported, mod_book\event\chapter_viewed, mod_book\event\chapter_updated, mod_book\event\chapter_deleted, mod_book\event\chapter_created, mod_assign\event\workflow_state_updated, mod_assign\event\submission_viewed, mod_assign\event\submission_unlocked, mod_assign\event\submission_status_viewed, mod_assign\event\submission_status_updated, mod_assign\event\submission_locked, mod_assign\event\submission_graded, mod_assign\event\submission_form_viewed, mod_assign\event\submission_duplicated, mod_assign\event\submission_confirmation_form_viewed, mod_assign\event\statement_accepted, mod_assign\event\reveal_identities_confirmation_page_viewed, mod_assign\event\remove_submission_form_viewed, mod_assign\event\marker_updated, mod_assign\event\identities_revealed, mod_assign\event\grading_table_viewed, mod_assign\event\grading_form_viewed, mod_assign\event\feedback_viewed, mod_assign\event\extension_granted, mod_assign\event\batch_set_workflow_state_viewed, mod_assign\event\batch_set_marker_allocation_viewed, mod_assign\event\base, mod_assign\event\assessable_submitted, mod_assign\event\all_submissions_downloaded, core\event\webservice_token_sent, core\event\webservice_token_created, core\event\webservice_service_user_removed, core\event\webservice_service_user_added, core\event\webservice_service_updated, core\event\webservice_service_deleted, core\event\webservice_service_created, core\event\webservice_login_failed, core\event\webservice_function_called, core\event\user_updated, core\event\user_profile_viewed, core\event\user_password_updated, core\event\user_login_failed, core\event\user_loggedout, core\event\user_loggedinas, core\event\user_loggedin, core\event\user_list_viewed, core\event\user_graded, core\event\user_enrolment_deleted, core\event\user_enrolment_created, core\event\user_deleted, core\event\user_created, core\event\tag_updated, core\event\tag_flagged, core\event\tag_added, core\event\role_updated, core\event\role_unassigned, core\event\role_deleted, core\event\role_capabilities_updated, core\event\role_assigned, core\event\role_allow_view_updated, core\event\role_allow_switch_updated, core\event\role_allow_override_updated, core\event\role_allow_assign_updated, core\event\recent_activity_viewed, core\event\question_category_created, core\event\notes_viewed, core\event\note_updated, core\event\note_deleted, core\event\note_created, core\event\mnet_access_control_updated, core\event\mnet_access_control_created, core\event\message_sent, core\event\message_contact_unblocked, core\event\message_contact_removed, core\event\message_contact_blocked, core\event\message_contact_added, core\event\email_failed, core\event\course_viewed, core\event\course_user_report_viewed, core\event\course_updated, core\event\course_section_updated, core\event\course_section_deleted, core\event\course_resources_list_viewed, core\event\course_module_viewed, core\event\course_module_updated, core\event\course_module_instance_list_viewed, core\event\course_module_deleted, core\event\course_module_created, core\event\course_deleted, core\event\course_created, core\event\course_completion_updated, core\event\course_category_updated, core\event\course_category_deleted, core\event\course_category_created, core\event\content_viewed, core\event\calendar_event_updated, core\event\calendar_event_created, core\event\blog_entry_updated, core\event\blog_entry_deleted, core\event\blog_entry_created, core\event\blog_entries_viewed, core\event\blog_association_created, and tool_capability\event\report_viewed.

get_logextra()

core\event\base::get_logextra ( )

inherited

Return auxiliary data that was stored in logs.

List of standard properties:

• origin: IP number, cli,cron
• realuserid: id of the user when logged-in-as

Return values

array

the format is standardised by logging API

get_name()

static tool_policy\event\acceptance_updated::get_name ( )

static

Returns event name.

Return values

string

Reimplemented from core\event\base.

get_name_with_info()

static core\event\base::get_name_with_info ( )

staticinherited

Returns the event name complete with metadata information.

This includes information about whether the event has been deprecated so should not be used in all situations - for example within reports themselves.

If overriding this function, please ensure that you call the parent version too.

Return values

string

get_objectid_mapping()

static tool_policy\event\acceptance_base::get_objectid_mapping ( )

staticinherited

Get the object ID mapping.

Return values

array

Reimplemented from core\event\base.

get_other_mapping()

static tool_policy\event\acceptance_base::get_other_mapping ( )

staticinherited

No mapping required for this event because this event is not backed up.

Return values

bool

Reimplemented from core\event\base.

get_record_snapshot()

core\event\base::get_record_snapshot (   $tablename,   $id  )

finalinherited

Returns cached record or fetches data from database if not cached.

Parameters

string	$tablename
int	$id

Return values

stdClass

Exceptions

coding_exception

if used after ::restore()

get_static_info()

static core\event\base::get_static_info ( )

staticfinalinherited

Get static information about an event.

This is used in reports and is not for general use.

Return values

array

Static information about the event.

get_url()

tool_policy\event\acceptance_base::get_url ( )

inherited

Get URL related to the action.

Return values

moodle_url

Reimplemented from core\event\base.

getIterator()

core\event\base::getIterator ( )

inherited

Create an iterator because magic vars can't be seen by 'foreach'.

Return values

ArrayIterator

is_deprecated()

static core\event\base::is_deprecated ( )

staticinherited

Whether this event has been marked as deprecated.

Events cannot be deprecated in the normal fashion as they must remain to support historical data. Once they are deprecated, there is no way to trigger the event, so it does not make sense to list it in some parts of the UI (e.g. Event Monitor).

Return values

boolean

Reimplemented in mod_choice\event\answer_updated, mod_choice\event\answer_submitted, core\event\role_capabilities_updated, core\event\mnet_access_control_updated, core\event\message_contact_unblocked, core\event\message_contact_blocked, core\event\course_module_instances_list_viewed, and core\event\content_viewed.

is_dispatched()

core\event\base::is_dispatched ( )

finalinherited

Used from event manager to prevent direct access.

Return values

bool

is_restored()

core\event\base::is_restored ( )

finalinherited

Was this event restored?

Return values

bool

is_triggered()

core\event\base::is_triggered ( )

finalinherited

Was this event already triggered?

Return values

bool

restore()

static core\event\base::restore ( array  $data, array  $logextra  )

staticfinalinherited

Restore event from existing historic data.

Parameters

array	$data
array	$logextra	the format is standardised by logging API

Return values

bool|core

restore_legacy()

static core\event\base::restore_legacy (   $legacy )

staticfinalinherited

Create fake event from legacy log data.

Parameters

stdClass

$legacy

Return values

base

restore_unknown()

static core\event\base::restore_unknown ( array  $data, array  $logextra  )

staticfinalprotectedinherited

Restore unknown event.

Parameters

array	$data
array	$logextra

Return values

unknown_logged

validate_before_trigger()

core\event\base::validate_before_trigger ( )

finalprotectedinherited

Validate all properties right before triggering the event.

This throws coding exceptions for fatal problems and debugging for minor problems.

Exceptions

coding_exception

validate_data()

tool_policy\event\acceptance_base::validate_data ( )

protectedinherited

Custom validation.

Exceptions

coding_exception

Reimplemented from core\event\base.

Member Data Documentation

LEVEL_PARTICIPATING

const core\event\base::LEVEL_PARTICIPATING = 2

inherited

Participating level.

Any event that is performed by a user, and is related (or could be related) to his learning experience.

LEVEL_TEACHING

const core\event\base::LEVEL_TEACHING = 1

inherited

Teaching level.

Any event that is performed by someone (typically a teacher) and has a teaching value, anything that is affecting the learning experience/environment of the students.

---

The documentation for this class was generated from the following file:

• admin/tool/policy/classes/event/acceptance_updated.php