IMS Enterprise file enrolment plugin. More...

Inheritance diagram for enrol_imsenterprise_plugin:

Public Member Functions
	add_course_navigation ($instancesnode, stdClass $instance)
	Adds navigation links into course admin block. More...

	add_default_instance ($course)
	Add new instance of enrol plugin with default settings, called when adding new instance manually or when adding new course. More...

	add_instance ($course, array $fields=NULL)
	Add new instance of enrol plugin. More...

	allow_enrol (stdClass $instance)
	Does this plugin allow manual enrolments? More...

	allow_manage (stdClass $instance)
	Does this plugin allow manual changes in user_enrolments table? More...

	allow_unenrol (stdClass $instance)
	Does this plugin allow manual unenrolment of all users? All plugins allowing this must implement 'enrol/xxx:unenrol' capability. More...

	allow_unenrol_user (stdClass $instance, stdClass $ue)
	Does this plugin allow manual unenrolment of a specific user? All plugins allowing this must implement 'enrol/xxx:unenrol' capability. More...

	backup_annotate_custom_fields (backup_enrolments_execution_step $step, stdClass $enrol)
	Backup execution step hook to annotate custom fields. More...

	can_add_instance ($courseid)
	Return whether or not, given the current state, it is possible to add a new instance of this enrolment plugin to the course. More...

	can_delete_instance ($instance)
	Is it possible to delete enrol instance via standard UI? More...

	can_edit_instance ($instance)
	Return whether or not, given the current state, it is possible to edit an instance of this enrolment plugin in the course. More...

	can_hide_show_instance ($instance)
	Is it possible to hide/show enrol instance via standard UI? More...

	can_self_enrol (stdClass $instance, $checkuserenrolment=true)
	Checks if user can self enrol. More...

	course_edit_form ($instance, MoodleQuickForm $mform, $data, $context)
	Adds enrol instance UI to course edit form. More...

	course_edit_validation ($instance, array $data, $context)
	Validates course edit form data. More...

	course_updated ($inserted, $course, $data)
	Called after updating/inserting course. More...

	cron ()
	Read in an IMS Enterprise file. More...

	delete_instance ($instance)
	Delete course enrol plugin instance, unenrol all users. More...

	edit_instance_form ($instance, MoodleQuickForm $mform, $context)
	Adds form elements to add/edit instance form. More...

	edit_instance_validation ($data, $files, $instance, $context)
	Perform custom validation of the data used to edit the instance. More...

	enrol_imsenterprise_allow_group_member_remove ($itemid, $groupid, $userid)
	Called whenever anybody tries (from the normal interface) to remove a group member which is registered as being created by this component. More...

	enrol_page_hook (stdClass $instance)
	Creates course enrol form, checks if form submitted and enrols user if necessary. More...

	enrol_user (stdClass $instance, $userid, $roleid=null, $timestart=0, $timeend=0, $status=null, $recovergrades=null)
	Enrol user into course via enrol instance. More...

	get_action_icons (stdClass $instance)
	Returns edit icons for the page with list of instances. More...

	get_bulk_operations (course_enrolment_manager $manager)
	Return an array of enrol_bulk_enrolment_operation objects that define the bulk actions that can be performed on user enrolments by the plugin. More...

	get_config ($name, $default=NULL)
	Returns plugin config value. More...

	get_description_text ($instance)
	Returns optional enrolment instance description text. More...

	get_enrol_info (stdClass $instance)
	Return information for enrolment instance containing list of parameters required for enrolment, name of enrolment plugin etc. More...

	get_info_icons (array $instances)
	Returns optional enrolment information icons. More...

	get_instance_defaults ()
	Returns defaults for new instances. More...

	get_instance_name ($instance)
	Returns localised name of enrol instance. More...

	get_manual_enrol_button (course_enrolment_manager $manager)
	Returns an enrol_user_button that takes the user to a page where they are able to enrol users into the managers course through this plugin. More...

	get_manual_enrol_link ($instance)
	Returns link to manual enrol UI if exists. More...

	get_name ()
	Returns name of this enrol plugin. More...

	get_newinstance_link ($courseid)
	Returns link to page which may be used to add new instance of enrolment plugin in course. More...

	get_unenrolself_link ($instance)
	Returns list of unenrol links for all enrol instances in course. More...

	get_user_enrolment_actions (course_enrolment_manager $manager, $ue)
	Gets an array of the user enrolment actions. More...

	has_bulk_operations (course_enrolment_manager $manager)
	Returns true if the plugin has one or more bulk operations that can be performed on user enrolments. More...

	instance_deleteable ($instance)

	is_cron_required ()
	Reads version.php and determines if it is necessary to execute the cron job now. More...

	process_expirations (progress_trace $trace, $courseid=null)
	Do any enrolments need expiration processing. More...

	restore_group_member ($instance, $groupid, $userid)
	Restore user group membership. More...

	restore_instance (restore_enrolments_structure_step $step, stdClass $data, $course, $oldid)
	Restore instance and map settings. More...

	restore_role_assignment ($instance, $roleid, $userid, $contextid)
	Restore role assignment. More...

	restore_sync_course ($course)
	Automatic enrol sync executed during restore. More...

	restore_user_enrolment (restore_enrolments_structure_step $step, $data, $instance, $userid, $oldinstancestatus)
	Restore user enrolment. More...

	roles_protected ()
	Does this plugin assign protected roles are can they be manually removed? More...

	send_expiry_notifications ($trace)
	Send expiry notifications. More...

	set_config ($name, $value)
	Sets plugin config value. More...

	show_enrolme_link (stdClass $instance)
	Does this plugin support some way to user to self enrol? More...

	sync_user_enrolments ($user)
	Forces synchronisation of user enrolments. More...

	try_autoenrol (stdClass $instance)
	Attempt to automatically enrol current user in course without any interaction, calling code has to make sure the plugin and instance are active. More...

	try_guestaccess (stdClass $instance)
	Attempt to automatically gain temporary guest access to course, calling code has to make sure the plugin and instance are active. More...

	unenrol_user (stdClass $instance, $userid)
	Unenrol user from course, the last unenrolment removes all remaining roles. More...

	update_instance ($instance, $data)
	Update instance of enrol plugin. More...

	update_status ($instance, $newstatus)
	Update instance status. More...

	update_user_enrol (stdClass $instance, $userid, $status=NULL, $timestart=NULL, $timeend=NULL)
	Store user_enrolments changes and trigger event. More...

	use_standard_editing_ui ()
	This returns false for backwards compatibility, but it is really recommended. More...

	user_delete ($user)
	Called when user is about to be deleted. More...

	validate_param_types ($data, $rules)
	Validate a list of parameter names and types. More...

Public Attributes
IMSENTERPRISE_ADD const	IMSENTERPRISE_ADD = 1
	imsenterprise add action.

IMSENTERPRISE_DELETE const	IMSENTERPRISE_DELETE = 3
	imsenterprise delete action.

IMSENTERPRISE_UPDATE const	IMSENTERPRISE_UPDATE = 2
	imsenterprise update action.

Protected Member Functions
	full_tag_found_in_cache ($tagname, $latestline)
	Check if a complete tag is found in the cached data, which usually happens when the end of the tag has only just been loaded into the cache. More...

	get_enroller ($instanceid)
	Returns the user who is responsible for enrolments for given instance. More...

	load_config ()
	Makes sure config is loaded and cached. More...

	load_course_mappings ()
	Load the name mappings (from the config), so we can easily refer to how an IMS-E course properties corresponds to a Moodle course properties.

	load_role_mappings ()
	Load the role mappings (from the config), so we can easily refer to how an IMS-E role corresponds to a Moodle role.

	log_line ($string)
	Store logging information. More...

	notify_expiry_enrolled ($user, $ue, progress_trace $trace)
	Notify user about incoming expiration of their enrolment, it is called only if notification of enrolled users (aka students) is enabled in course. More...

	notify_expiry_enroller ($eid, $users, progress_trace $trace)
	Notify person responsible for enrolments that some user enrolments will be expired soon, it is called only if notification of enrollers (aka teachers) is enabled in course. More...

	process_group_tag ($tagcontents)
	Process the group tag. More...

	process_membership_tag ($tagcontents)
	Process the membership tag. More...

	process_person_tag ($tagcontents)
	Process the person tag. More...

	process_properties_tag ($tagcontents)
	Process the properties tag. More...

	remove_tag_from_cache ($tagname)
	Remove complete tag from the cached data (including all its contents) - so that the cache doesn't grow to unmanageable size. More...

Static Protected Member Functions
static	decode_timeframe ($string)
	Process the INNER contents of a <timeframe> tag, to return beginning/ending dates. More...

static	get_recstatus ($tagdata, $tagname)
	Very simple convenience function to return the "recstatus" found in person/group/role tags. More...

Protected Attributes
	$config = null

$continueprocessing	$continueprocessing
	bool flag to determine if processing should continue.

$coursemappings	$coursemappings
	array of mappings between IMS data fields and moodle course fields.

$defaultcategoryid	$defaultcategoryid
	id of default category.

$logfp	$logfp
	resource file pointer for writing log data to.

$rolemappings	$rolemappings
	array of mappings between IMS roles and moodle roles.

$xmlcache	$xmlcache
	string cache of xml lines.

Detailed Description

IMS Enterprise file enrolment plugin.

Copyright: 2010 Eugene Venter

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

Member Function Documentation

◆ add_course_navigation()

enrol_plugin::add_course_navigation	(		$instancesnode,
		stdClass	$instance
	)

inherited

Adds navigation links into course admin block.

By defaults looks for manage links only.

Parameters

navigation_node	$instancesnode
stdClass	$instance

Return values

void

◆ add_default_instance()

enrol_plugin::add_default_instance ( $course )

inherited

Add new instance of enrol plugin with default settings, called when adding new instance manually or when adding new course.

Not all plugins support this.

Parameters

object $course

Return values

int	id of new instance or null if no default supported

Reimplemented in enrol_self_plugin, enrol_manual_plugin, and enrol_guest_plugin.

◆ add_instance()

enrol_plugin::add_instance	(		$course,
		array	$fields = `NULL`
	)

inherited

Add new instance of enrol plugin.

Parameters

object	$course
	array	instance fields

Return values

int	id of new instance, null if can not be created

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_meta_plugin, enrol_manual_plugin, enrol_lti_plugin, enrol_guest_plugin, and enrol_cohort_plugin.

◆ allow_enrol()

enrol_plugin::allow_enrol ( stdClass $instance )

inherited

Does this plugin allow manual enrolments?

Parameters

stdClass $instance course enrol instance All plugins allowing this must implement 'enrol/xxx:enrol' capability

Return values

bool	- true means user with 'enrol/xxx:enrol' may enrol others freely, false means nobody may add more enrolments manually

Reimplemented in enrol_manual_plugin.

◆ allow_manage()

enrol_plugin::allow_manage ( stdClass $instance )

inherited

Does this plugin allow manual changes in user_enrolments table?

All plugins allowing this must implement 'enrol/xxx:manage' capability

Parameters

stdClass $instance course enrol instance

Return values

bool	- true means it is possible to change enrol period and status in user_enrolments table

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_manual_plugin, and enrol_flatfile_plugin.

◆ allow_unenrol()

enrol_plugin::allow_unenrol ( stdClass $instance )

inherited

Does this plugin allow manual unenrolment of all users? All plugins allowing this must implement 'enrol/xxx:unenrol' capability.

Parameters

stdClass $instance course enrol instance

Return values

bool	- true means user with 'enrol/xxx:unenrol' may unenrol others freely, false means nobody may touch user_enrolments

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_manual_plugin, enrol_lti_plugin, and enrol_flatfile_plugin.

◆ allow_unenrol_user()

enrol_plugin::allow_unenrol_user	(	stdClass	$instance,
		stdClass	$ue
	)

inherited

Does this plugin allow manual unenrolment of a specific user? All plugins allowing this must implement 'enrol/xxx:unenrol' capability.

This is useful especially for synchronisation plugins that do suspend instead of full unenrolment.

Parameters

stdClass	$instance	course enrol instance
stdClass	$ue	record from user_enrolments table, specifies user

Return values

bool	- true means user with 'enrol/xxx:unenrol' may unenrol this user, false means nobody may touch this user enrolment

Reimplemented in enrol_meta_plugin, enrol_flatfile_plugin, enrol_database_plugin, and enrol_cohort_plugin.

◆ backup_annotate_custom_fields()

enrol_plugin::backup_annotate_custom_fields	(	backup_enrolments_execution_step	$step,
		stdClass	$enrol
	)

inherited

Backup execution step hook to annotate custom fields.

Parameters

backup_enrolments_execution_step	$step
stdClass	$enrol

◆ can_add_instance()

enrol_plugin::can_add_instance ( $courseid )

inherited

Return whether or not, given the current state, it is possible to add a new instance of this enrolment plugin to the course.

Default implementation is just for backwards compatibility.

Parameters

int $courseid

Return values

boolean

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_mnet_plugin, enrol_meta_plugin, enrol_manual_plugin, enrol_lti_plugin, enrol_guest_plugin, and enrol_cohort_plugin.

◆ can_delete_instance()

enrol_imsenterprise_plugin::can_delete_instance ( $instance )

Is it possible to delete enrol instance via standard UI?

Parameters

object $instance

Return values

bool

Reimplemented from enrol_plugin.

◆ can_edit_instance()

enrol_plugin::can_edit_instance ( $instance )

inherited

Return whether or not, given the current state, it is possible to edit an instance of this enrolment plugin in the course.

Used by the standard editing UI to generate a link to the edit instance form if editing is allowed.

Parameters

stdClass $instance

Return values

boolean

◆ can_hide_show_instance()

enrol_imsenterprise_plugin::can_hide_show_instance ( $instance )

Is it possible to hide/show enrol instance via standard UI?

Parameters

stdClass $instance

Return values

bool

Reimplemented from enrol_plugin.

◆ can_self_enrol()

enrol_plugin::can_self_enrol	(	stdClass	$instance,
			$checkuserenrolment = `true`
	)

inherited

Checks if user can self enrol.

Parameters

stdClass	$instance	enrolment instance
bool	$checkuserenrolment	if true will check if user enrolment is inactive. used by navigation to improve performance.

Return values

bool|string true if successful, else error message or false

Reimplemented in enrol_self_plugin.

◆ course_edit_form()

enrol_plugin::course_edit_form	(		$instance,
		MoodleQuickForm	$mform,
			$data,
			$context
	)

inherited

Adds enrol instance UI to course edit form.

Parameters

object	$instance	enrol instance or null if does not exist yet
MoodleQuickForm	$mform
object	$data
object	$context	context of existing course or parent category if course does not exist

Return values

void

◆ course_edit_validation()

enrol_plugin::course_edit_validation	(		$instance,
		array	$data,
			$context
	)

inherited

Validates course edit form data.

Parameters

object	$instance	enrol instance or null if does not exist yet
array	$data
object	$context	context of existing course or parent category if course does not exist

Return values

array errors array

◆ course_updated()

enrol_plugin::course_updated	(	$inserted,
		$course,
		$data
	)

inherited

Called after updating/inserting course.

Parameters

bool	$inserted	true if course just inserted
object	$course
object	$data	form data

Return values

void

Reimplemented in enrol_meta_plugin, enrol_guest_plugin, enrol_cohort_plugin, and enrol_category_plugin.

◆ cron()

enrol_imsenterprise_plugin::cron ( )

Read in an IMS Enterprise file.

Originally designed to handle v1.1 files but should be able to handle earlier types as well, I believe. This cron feature has been converted to a scheduled task and it can now be scheduled from the UI.

Reimplemented from enrol_plugin.

◆ decode_timeframe()

static enrol_imsenterprise_plugin::decode_timeframe ( $string )

staticprotected

Process the INNER contents of a <timeframe> tag, to return beginning/ending dates.

Parameters

string $string tag to decode.

Return values

stdClass beginning and/or ending is returned, in unix time, zero indicating not specified.

◆ delete_instance()

enrol_plugin::delete_instance ( $instance )

inherited

Delete course enrol plugin instance, unenrol all users.

Parameters

object $instance

Return values

void

Reimplemented in enrol_lti_plugin.

◆ edit_instance_form()

enrol_plugin::edit_instance_form	(		$instance,
		MoodleQuickForm	$mform,
			$context
	)

inherited

Adds form elements to add/edit instance form.

Since: Moodle 3.1

Parameters

object	$instance	enrol instance or null if does not exist yet
MoodleQuickForm	$mform
context	$context

Return values

void

Reimplemented in enrol_meta_plugin, enrol_cohort_plugin, enrol_self_plugin, enrol_paypal_plugin, enrol_mnet_plugin, enrol_manual_plugin, enrol_lti_plugin, and enrol_guest_plugin.

◆ edit_instance_validation()

enrol_plugin::edit_instance_validation	(	$data,
		$files,
		$instance,
		$context
	)

inherited

Perform custom validation of the data used to edit the instance.

Since: Moodle 3.1

Parameters

array	$data	array of ("fieldname"=>value) of submitted data
array	$files	array of uploaded files "element_name"=>tmp_file_path
object	$instance	The instance data loaded from the DB.
context	$context	The context of the instance we are editing

Return values

array of "element_name"=>"error_description" if there are errors, or an empty array if everything is OK.

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_mnet_plugin, enrol_meta_plugin, enrol_manual_plugin, enrol_lti_plugin, enrol_guest_plugin, and enrol_cohort_plugin.

◆ enrol_imsenterprise_allow_group_member_remove()

enrol_imsenterprise_plugin::enrol_imsenterprise_allow_group_member_remove	(	$itemid,
		$groupid,
		$userid
	)

Called whenever anybody tries (from the normal interface) to remove a group member which is registered as being created by this component.

(Not called when deleting an entire group or course at once.)

Parameters

int	$itemid	Item ID that was stored in the group_members entry
int	$groupid	Group ID
int	$userid	User ID being removed from group

Return values

bool	True if the remove is permitted, false to give an error

◆ enrol_page_hook()

enrol_plugin::enrol_page_hook ( stdClass $instance )

inherited

Creates course enrol form, checks if form submitted and enrols user if necessary.

It can also redirect.

Parameters

stdClass $instance

Return values

string html text, usually a form in a text box

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, and enrol_guest_plugin.

◆ enrol_user()

enrol_plugin::enrol_user	(	stdClass	$instance,
			$userid,
			$roleid = `null`,
			$timestart = `0`,
			$timeend = `0`,
			$status = `null`,
			$recovergrades = `null`
	)

inherited

Enrol user into course via enrol instance.

Parameters

stdClass	$instance
int	$userid
int	$roleid	optional role id
int	$timestart	0 means unknown
int	$timeend	0 means forever
int	$status	default to ENROL_USER_ACTIVE for new enrolments, no change by default in updates
bool	$recovergrades	restore grade history

Return values

void

Reimplemented in enrol_guest_plugin, and enrol_flatfile_plugin.

◆ full_tag_found_in_cache()

enrol_imsenterprise_plugin::full_tag_found_in_cache	(	$tagname,
		$latestline
	)

protected

Check if a complete tag is found in the cached data, which usually happens when the end of the tag has only just been loaded into the cache.

Parameters

string	$tagname	Name of tag to look for
string	$latestline	The very last line in the cache (used for speeding up the match)

Return values

bool|string false, or the contents of the tag (including start and end).

◆ get_action_icons()

enrol_plugin::get_action_icons ( stdClass $instance )

inherited

Returns edit icons for the page with list of instances.

Parameters

stdClass $instance

Return values

array

Reimplemented in enrol_manual_plugin.

◆ get_bulk_operations()

enrol_plugin::get_bulk_operations ( course_enrolment_manager $manager )

inherited

Return an array of enrol_bulk_enrolment_operation objects that define the bulk actions that can be performed on user enrolments by the plugin.

Parameters

course_enrolment_manager $manager

Return values

array

Reimplemented in enrol_self_plugin, and enrol_manual_plugin.

◆ get_config()

enrol_plugin::get_config	(	$name,
		$default = `NULL`
	)

inherited

Returns plugin config value.

Parameters

string	$name
string	$default	value if config does not exist yet

Return values

string value or default

◆ get_description_text()

enrol_plugin::get_description_text ( $instance )

inherited

Returns optional enrolment instance description text.

This is used in detailed course information.

Parameters

object $instance

Return values

string short html text

◆ get_enrol_info()

enrol_plugin::get_enrol_info ( stdClass $instance )

inherited

Return information for enrolment instance containing list of parameters required for enrolment, name of enrolment plugin etc.

Parameters

stdClass $instance enrolment instance

Return values

array instance info.

Reimplemented in enrol_self_plugin, and enrol_guest_plugin.

◆ get_enroller()

enrol_plugin::get_enroller ( $instanceid )

protectedinherited

Returns the user who is responsible for enrolments for given instance.

Override if plugin knows anybody better than admin.

Parameters

int $instanceid enrolment instance id

Return values

stdClass user record

Reimplemented in enrol_self_plugin, enrol_manual_plugin, and enrol_flatfile_plugin.

◆ get_info_icons()

enrol_plugin::get_info_icons ( array $instances )

inherited

Returns optional enrolment information icons.

This is used in course list for quick overview of enrolment options.

We are not using single instance parameter because sometimes we might want to prevent icon repetition when multiple instances of one type exist. One instance may also produce several icons.

Parameters

array $instances all enrol instances of this type in one course

Return values

array of pix_icon

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, and enrol_guest_plugin.

◆ get_instance_defaults()

enrol_plugin::get_instance_defaults ( )

inherited

Returns defaults for new instances.

Since: Moodle 3.1

Return values

array

Reimplemented in enrol_self_plugin, and enrol_guest_plugin.

◆ get_instance_name()

enrol_plugin::get_instance_name ( $instance )

inherited

Returns localised name of enrol instance.

Parameters

object $instance (null is accepted too)

Return values

string

Reimplemented in enrol_self_plugin, enrol_mnet_plugin, enrol_meta_plugin, and enrol_cohort_plugin.

◆ get_manual_enrol_button()

enrol_plugin::get_manual_enrol_button ( course_enrolment_manager $manager )

inherited

Returns an enrol_user_button that takes the user to a page where they are able to enrol users into the managers course through this plugin.

Optional: If the plugin supports manual enrolments it can choose to override this otherwise it shouldn't

Parameters

course_enrolment_manager $manager

Return values

enrol_user_button|false

Reimplemented in enrol_manual_plugin.

◆ get_manual_enrol_link()

enrol_plugin::get_manual_enrol_link ( $instance )

inherited

Returns link to manual enrol UI if exists.

Does the access control tests automatically.

Parameters

object $instance

Return values

moodle_url

Reimplemented in enrol_manual_plugin.

◆ get_name()

enrol_plugin::get_name ( )

inherited

Returns name of this enrol plugin.

Return values

string

◆ get_newinstance_link()

enrol_plugin::get_newinstance_link ( $courseid )

inherited

Returns link to page which may be used to add new instance of enrolment plugin in course.

Parameters

int $courseid

Return values

moodle_url page url

Reimplemented in enrol_category_plugin.

◆ get_recstatus()

static enrol_imsenterprise_plugin::get_recstatus	(	$tagdata,
		$tagname
	)

staticprotected

Very simple convenience function to return the "recstatus" found in person/group/role tags.

1=Add, 2=Update, 3=Delete, as specified by IMS, and we also use 0 to indicate "unspecified".

Parameters

string	$tagdata	the tag XML data
string	$tagname	the name of the tag we're interested in

Return values

int	recstatus value

◆ get_unenrolself_link()

enrol_plugin::get_unenrolself_link ( $instance )

inherited

Returns list of unenrol links for all enrol instances in course.

Parameters

int $instance

Return values

moodle_url or NULL if self unenrolment not supported

◆ get_user_enrolment_actions()

enrol_plugin::get_user_enrolment_actions	(	course_enrolment_manager	$manager,
			$ue
	)

inherited

Gets an array of the user enrolment actions.

Parameters

course_enrolment_manager	$manager
stdClass	$ue

Return values

array An array of user_enrolment_actions

◆ has_bulk_operations()

enrol_plugin::has_bulk_operations ( course_enrolment_manager $manager )

inherited

Returns true if the plugin has one or more bulk operations that can be performed on user enrolments.

Parameters

course_enrolment_manager $manager

Return values

bool

◆ instance_deleteable()

enrol_plugin::instance_deleteable ( $instance )

inherited

Deprecated:: since Moodle 2.8 MDL-35864 - please use can_delete_instance() instead.

◆ is_cron_required()

enrol_plugin::is_cron_required ( )

inherited

Reads version.php and determines if it is necessary to execute the cron job now.

Return values

bool

◆ load_config()

enrol_plugin::load_config ( )

protectedinherited

Makes sure config is loaded and cached.

Return values

void

◆ log_line()

enrol_imsenterprise_plugin::log_line ( $string )

protected

Store logging information.

This does two things: uses the mtrace() function to print info to screen/STDOUT, and also writes log to a text file if a path has been specified.

Parameters

string $string Text to write (newline will be added automatically)

◆ notify_expiry_enrolled()

enrol_plugin::notify_expiry_enrolled	(		$user,
			$ue,
		progress_trace	$trace
	)

protectedinherited

Notify user about incoming expiration of their enrolment, it is called only if notification of enrolled users (aka students) is enabled in course.

This is executed only once for each expiring enrolment right at the start of the expiration threshold.

Parameters

stdClass	$user
stdClass	$ue
progress_trace	$trace

◆ notify_expiry_enroller()

enrol_plugin::notify_expiry_enroller	(		$eid,
			$users,
		progress_trace	$trace
	)

protectedinherited

Notify person responsible for enrolments that some user enrolments will be expired soon, it is called only if notification of enrollers (aka teachers) is enabled in course.

This is called repeatedly every day for each course if there are any pending expiration in the expiration threshold.

Parameters

int	$eid
array	$users
progress_trace	$trace

◆ process_expirations()

enrol_plugin::process_expirations	(	progress_trace	$trace,
			$courseid = `null`
	)

inherited

Do any enrolments need expiration processing.

Plugins that want to call this functionality must implement 'expiredaction' config setting.

Parameters

progress_trace	$trace
int	$courseid	one course, empty mean all

Return values

bool	true if any data processed, false if not

◆ process_group_tag()

enrol_imsenterprise_plugin::process_group_tag ( $tagcontents )

protected

Process the group tag.

This defines a Moodle course.

Parameters

string $tagcontents The raw contents of the XML element

◆ process_membership_tag()

enrol_imsenterprise_plugin::process_membership_tag ( $tagcontents )

protected

Process the membership tag.

This defines whether the specified Moodle users should be added/removed as teachers/students.

Parameters

string $tagcontents The raw contents of the XML element

◆ process_person_tag()

enrol_imsenterprise_plugin::process_person_tag ( $tagcontents )

protected

Process the person tag.

This defines a Moodle user.

Parameters

string $tagcontents The raw contents of the XML element

◆ process_properties_tag()

enrol_imsenterprise_plugin::process_properties_tag ( $tagcontents )

protected

Process the properties tag.

The only data from this element that is relevant is whether a <target> is specified.

Parameters

string $tagcontents The raw contents of the XML element

◆ remove_tag_from_cache()

enrol_imsenterprise_plugin::remove_tag_from_cache ( $tagname )

protected

Remove complete tag from the cached data (including all its contents) - so that the cache doesn't grow to unmanageable size.

Parameters

string $tagname Name of tag to look for

◆ restore_group_member()

enrol_plugin::restore_group_member	(	$instance,
		$groupid,
		$userid
	)

inherited

Restore user group membership.

Parameters

stdClass	$instance
int	$groupid
int	$userid

Reimplemented in enrol_meta_plugin, enrol_manual_plugin, and enrol_cohort_plugin.

◆ restore_instance()

enrol_plugin::restore_instance	(	restore_enrolments_structure_step	$step,
		stdClass	$data,
			$course,
			$oldid
	)

inherited

Restore instance and map settings.

Parameters

restore_enrolments_structure_step	$step
stdClass	$data
stdClass	$course
int	$oldid

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_meta_plugin, enrol_manual_plugin, enrol_lti_plugin, enrol_ldap_plugin, enrol_guest_plugin, enrol_flatfile_plugin, enrol_database_plugin, and enrol_cohort_plugin.

◆ restore_role_assignment()

enrol_plugin::restore_role_assignment	(	$instance,
		$roleid,
		$userid,
		$contextid
	)

inherited

Restore role assignment.

Parameters

stdClass	$instance
int	$roleid
int	$userid
int	$contextid

Reimplemented in enrol_self_plugin, enrol_manual_plugin, enrol_ldap_plugin, enrol_flatfile_plugin, and enrol_database_plugin.

◆ restore_sync_course()

enrol_plugin::restore_sync_course ( $course )

inherited

Automatic enrol sync executed during restore.

Useful for automatic sync by course->idnumber or course category.

Parameters

stdClass $course course record

Reimplemented in enrol_ldap_plugin, enrol_database_plugin, and enrol_category_plugin.

◆ restore_user_enrolment()

enrol_plugin::restore_user_enrolment	(	restore_enrolments_structure_step	$step,
			$data,
			$instance,
			$userid,
			$oldinstancestatus
	)

inherited

Restore user enrolment.

Parameters

restore_enrolments_structure_step	$step
stdClass	$data
stdClass	$instance
int	$oldinstancestatus
int	$userid

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_meta_plugin, enrol_manual_plugin, enrol_ldap_plugin, enrol_flatfile_plugin, enrol_database_plugin, and enrol_cohort_plugin.

◆ roles_protected()

enrol_plugin::roles_protected ( )

inherited

Does this plugin assign protected roles are can they be manually removed?

Return values

bool	- false means anybody may tweak roles, it does not use itemid and component when assigning roles

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_manual_plugin, and enrol_flatfile_plugin.

◆ send_expiry_notifications()

enrol_plugin::send_expiry_notifications ( $trace )

inherited

Send expiry notifications.

Plugin that wants to have expiry notification MUST implement following:

expirynotifyhour plugin setting,
configuration options in instance edit form (expirynotify, notifyall and expirythreshold),
notification strings (expirymessageenrollersubject, expirymessageenrollerbody, expirymessageenrolledsubject and expirymessageenrolledbody),
expiry_notification provider in db/messages.php,
upgrade code that sets default thresholds for existing courses (should be 1 day),
something that calls this method, such as cron.

Parameters

progress_trace $trace (accepts bool for backwards compatibility only)

◆ set_config()

enrol_plugin::set_config	(	$name,
		$value
	)

inherited

Sets plugin config value.

Parameters

string	$name	name of config
string	$value	string config value, null means delete

Return values

string value

◆ show_enrolme_link()

enrol_plugin::show_enrolme_link ( stdClass $instance )

inherited

Does this plugin support some way to user to self enrol?

Parameters

stdClass $instance course enrol instance

Return values

bool	- true means show "Enrol me in this course" link in course UI

Reimplemented in enrol_self_plugin, and enrol_paypal_plugin.

◆ sync_user_enrolments()

enrol_plugin::sync_user_enrolments ( $user )

inherited

Forces synchronisation of user enrolments.

This is important especially for external enrol plugins, this function is called for all enabled enrol plugins right after every user login.

Parameters

object $user user record

Return values

void

Reimplemented in enrol_ldap_plugin, and enrol_database_plugin.

◆ try_autoenrol()

enrol_plugin::try_autoenrol ( stdClass $instance )

inherited

Attempt to automatically enrol current user in course without any interaction, calling code has to make sure the plugin and instance are active.

This should return either a timestamp in the future or false.

Parameters

stdClass $instance course enrol instance

Return values

bool|int false means not enrolled, integer means timeend

◆ try_guestaccess()

enrol_plugin::try_guestaccess ( stdClass $instance )

inherited

Attempt to automatically gain temporary guest access to course, calling code has to make sure the plugin and instance are active.

This should return either a timestamp in the future or false.

Parameters

stdClass $instance course enrol instance

Return values

bool|int false means no guest access, integer means timeend

Reimplemented in enrol_guest_plugin.

◆ unenrol_user()

enrol_plugin::unenrol_user	(	stdClass	$instance,
			$userid
	)

inherited

Unenrol user from course, the last unenrolment removes all remaining roles.

Parameters

stdClass	$instance
int	$userid

Return values

void

Reimplemented in enrol_lti_plugin, and enrol_guest_plugin.

◆ update_instance()

enrol_plugin::update_instance	(	$instance,
		$data
	)

inherited

Update instance of enrol plugin.

Since: Moodle 3.1

Parameters

stdClass	$instance
stdClass	$data	modified instance fields

Return values

boolean

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_meta_plugin, enrol_manual_plugin, enrol_lti_plugin, and enrol_cohort_plugin.

◆ update_status()

enrol_plugin::update_status	(	$instance,
		$newstatus
	)

inherited

Update instance status.

Override when plugin needs to do some action when enabled or disabled.

Parameters

stdClass	$instance
int	$newstatus	ENROL_INSTANCE_ENABLED, ENROL_INSTANCE_DISABLED

Return values

void

Reimplemented in enrol_meta_plugin, and enrol_cohort_plugin.

◆ update_user_enrol()

enrol_plugin::update_user_enrol	(	stdClass	$instance,
			$userid,
			$status = `NULL`,
			$timestart = `NULL`,
			$timeend = `NULL`
	)

inherited

Store user_enrolments changes and trigger event.

Parameters

stdClass	$instance
int	$userid
int	$status
int	$timestart
int	$timeend

Return values

void

◆ use_standard_editing_ui()

enrol_plugin::use_standard_editing_ui ( )

inherited

This returns false for backwards compatibility, but it is really recommended.

Since: Moodle 3.1

Return values

boolean

Reimplemented in enrol_self_plugin, enrol_paypal_plugin, enrol_mnet_plugin, enrol_meta_plugin, enrol_manual_plugin, enrol_lti_plugin, enrol_guest_plugin, and enrol_cohort_plugin.

◆ user_delete()

enrol_plugin::user_delete ( $user )

inherited

Called when user is about to be deleted.

Parameters

object $user

Return values

void

◆ validate_param_types()

enrol_plugin::validate_param_types	(	$data,
		$rules
	)

inherited

Validate a list of parameter names and types.

Since: Moodle 3.1

Parameters

array	$data	array of ("fieldname"=>value) of submitted data
array	$rules	array of ("fieldname"=>PARAM_X types - or "fieldname"=>array( list of valid options )

Return values

array of "element_name"=>"error_description" if there are errors, or an empty array if everything is OK.

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

enrol/imsenterprise/lib.php

Public Member Functions

Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ add_course_navigation()

◆ add_default_instance()

◆ add_instance()

◆ allow_enrol()

◆ allow_manage()

◆ allow_unenrol()

◆ allow_unenrol_user()

◆ backup_annotate_custom_fields()

◆ can_add_instance()

◆ can_delete_instance()

◆ can_edit_instance()

◆ can_hide_show_instance()

◆ can_self_enrol()

◆ course_edit_form()

◆ course_edit_validation()

◆ course_updated()

◆ cron()

◆ decode_timeframe()

◆ delete_instance()

◆ edit_instance_form()

◆ edit_instance_validation()

◆ enrol_imsenterprise_allow_group_member_remove()

◆ enrol_page_hook()

◆ enrol_user()

◆ full_tag_found_in_cache()

◆ get_action_icons()

◆ get_bulk_operations()

◆ get_config()

◆ get_description_text()

◆ get_enrol_info()

◆ get_enroller()

◆ get_info_icons()

◆ get_instance_defaults()

◆ get_instance_name()

◆ get_manual_enrol_button()

◆ get_manual_enrol_link()

◆ get_name()

◆ get_newinstance_link()

◆ get_recstatus()

◆ get_unenrolself_link()

◆ get_user_enrolment_actions()

◆ has_bulk_operations()

◆ instance_deleteable()

◆ is_cron_required()

◆ load_config()

◆ log_line()

◆ notify_expiry_enrolled()

◆ notify_expiry_enroller()

◆ process_expirations()

◆ process_group_tag()

◆ process_membership_tag()

◆ process_person_tag()

◆ process_properties_tag()

◆ remove_tag_from_cache()

◆ restore_group_member()

◆ restore_instance()

◆ restore_role_assignment()

◆ restore_sync_course()

◆ restore_user_enrolment()

◆ roles_protected()

◆ send_expiry_notifications()

◆ set_config()

◆ show_enrolme_link()

◆ sync_user_enrolments()

◆ try_autoenrol()

◆ try_guestaccess()

◆ unenrol_user()

◆ update_instance()

◆ update_status()

◆ update_user_enrol()

◆ use_standard_editing_ui()

◆ user_delete()

◆ validate_param_types()