diff --git a/enrol/imsenterprise/lang/en/enrol_imsenterprise.php b/enrol/imsenterprise/lang/en/enrol_imsenterprise.php index 9751a7b70b6..9ceb277145b 100644 --- a/enrol/imsenterprise/lang/en/enrol_imsenterprise.php +++ b/enrol/imsenterprise/lang/en/enrol_imsenterprise.php @@ -26,23 +26,22 @@ $string['aftersaving...'] = 'Once you have saved your settings, you may wish to'; $string['allowunenrol'] = 'Allow the IMS data to unenrol students/teachers'; -$string['allowunenrol_help'] = 'If enabled, course enrolments will be removed when specified in the Enterprise data.'; -$string['allowunenrol_link'] = 'admin/enrol/imsenterprise'; +$string['allowunenrol_desc'] = 'If enabled, course enrolments will be removed when specified in the Enterprise data.'; $string['basicsettings'] = 'Basic settings'; $string['coursesettings'] = 'Course data options'; $string['createnewcategories'] = 'Create new (hidden) course categories if not found in Moodle'; -$string['createnewcategories_help'] = 'If the element is present in a course\'s incoming data, its content will be used to specify a category if the course is to be created from scratch. The plugin will NOT re-categorise existing courses. +$string['createnewcategories_desc'] = 'If the element is present in a course\'s incoming data, its content will be used to specify a category if the course is to be created from scratch. The plugin will NOT re-categorise existing courses. If no category exists with the desired name, then a hidden category will be created.'; $string['createnewcourses'] = 'Create new (hidden) courses if not found in Moodle'; -$string['createnewcourses_help'] = 'If enabled, the IMS Enterprise enrolment plugin can create new courses for any it finds in the IMS data but not in Moodle\'s database. Any newly-created courses are initially hidden.'; +$string['createnewcourses_desc'] = 'If enabled, the IMS Enterprise enrolment plugin can create new courses for any it finds in the IMS data but not in Moodle\'s database. Any newly-created courses are initially hidden.'; $string['createnewusers'] = 'Create user accounts for users not yet registered in Moodle'; -$string['createnewusers_help'] = 'IMS Enterprise enrolment data typically describes a set of users. If enabled, accounts can be created for any users not found in Moodle\'s database. +$string['createnewusers_desc'] = 'IMS Enterprise enrolment data typically describes a set of users. If enabled, accounts can be created for any users not found in Moodle\'s database. Users are searched for first by their "idnumber", and second by their Moodle username. Passwords are not imported by the IMS Enterprise plugin. The use of an authentication plugin is recommended for authenticating users.'; $string['cronfrequency'] = 'Frequency of processing'; $string['deleteusers'] = 'Delete user accounts when specified in IMS data'; -$string['deleteusers_help'] = 'If enabled, IMS Enterprise enrolment data can specify the deletion of user accounts (if the "recstatus" flag is set to 3, which represents deletion of an account). As is standard in Moodle, the user record isn\'t actually deleted from Moodle\'s database, but a flag is set to mark the account as deleted.'; +$string['deleteusers_desc'] = 'If enabled, IMS Enterprise enrolment data can specify the deletion of user accounts (if the "recstatus" flag is set to 3, which represents deletion of an account). As is standard in Moodle, the user record isn\'t actually deleted from Moodle\'s database, but a flag is set to mark the account as deleted.'; $string['pluginname_desc'] = 'This method will repeatedly check for and process a specially-formatted text file in the location that you specify. The file must follow the IMS Enterprise specifications containing person, group, and membership XML elements.'; $string['doitnow'] = 'perform an IMS Enterprise import right now'; $string['pluginname'] = 'IMS Enterprise file'; @@ -59,17 +58,17 @@ $string['miscsettings'] = 'Miscellaneous'; $string['processphoto'] = 'Add user photo data to profile'; $string['processphotowarning'] = 'Warning: Image processing is likely to add a significant burden to the server. You are recommended not to activate this option if large numbers of students are expected to be processed.'; $string['restricttarget'] = 'Only process data if the following target is specified'; -$string['restricttarget_help'] = 'An IMS Enterprise data file could be intended for multiple "targets" - different LMSes, or different systems within a school/university. It\'s possible to specify in the Enterprise file that the data is intended for one or more named target systems, by naming them in tags contained within the tag. +$string['restricttarget_desc'] = 'An IMS Enterprise data file could be intended for multiple "targets" - different LMSes, or different systems within a school/university. It\'s possible to specify in the Enterprise file that the data is intended for one or more named target systems, by naming them in tags contained within the tag. In general you don\'t need to worry about this. Leave the setting blank and Moodle will always process the data file, no matter whether a target is specified or not. Otherwise, fill in the exact name that will be output inside the tag.'; $string['sourcedidfallback'] = 'Use the "sourcedid" for a person\'s userid if the "userid" field is not found'; -$string['sourcedidfallback_help'] = 'In IMS data, the field represents the persistent ID code for a person as used in the source system. The field is a separate field which should contain the ID code used by the user when logging in. In many cases these two codes may be the same - but not always. +$string['sourcedidfallback_desc'] = 'In IMS data, the field represents the persistent ID code for a person as used in the source system. The field is a separate field which should contain the ID code used by the user when logging in. In many cases these two codes may be the same - but not always. Some student information systems fail to output the field. If this is the case, you should enable this setting to allow for using the as the Moodle user ID. Otherwise, leave this setting disabled.'; $string['truncatecoursecodes'] = 'Truncate course codes to this length'; -$string['truncatecoursecodes_help'] = 'In some situations you may have course codes which you wish to truncate to a specified length before processing. If so, enter the number of characters in this box. Otherwise, leave the box blank and no truncation will occur.'; +$string['truncatecoursecodes_desc'] = 'In some situations you may have course codes which you wish to truncate to a specified length before processing. If so, enter the number of characters in this box. Otherwise, leave the box blank and no truncation will occur.'; $string['usecapitafix'] = 'Tick this box if using "Capita" (their XML format is slightly wrong)'; -$string['usecapitafix_help'] = 'The student data system produced by Capita has been found to have one slight error in its XML output. If you are using Capita you should enable this setting - otherwise leave it un-ticked.'; +$string['usecapitafix_desc'] = 'The student data system produced by Capita has been found to have one slight error in its XML output. If you are using Capita you should enable this setting - otherwise leave it un-ticked.'; $string['usersettings'] = 'User data options'; $string['zeroisnotruncation'] = '0 indicates no truncation'; $string['roles'] = 'Roles'; diff --git a/enrol/imsenterprise/settings.php b/enrol/imsenterprise/settings.php index a19d2da73af..977a61c4211 100644 --- a/enrol/imsenterprise/settings.php +++ b/enrol/imsenterprise/settings.php @@ -43,15 +43,15 @@ if ($ADMIN->fulltree) { //--- user data options --------------------------------------------------------------------------------- $settings->add(new admin_setting_heading('enrol_imsenterprise_usersettings', get_string('usersettings', 'enrol_imsenterprise'), '')); - $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/createnewusers', get_string('createnewusers', 'enrol_imsenterprise'), '', 0)); + $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/createnewusers', get_string('createnewusers', 'enrol_imsenterprise'), get_string('createnewusers_desc', 'enrol_imsenterprise'), 0)); - $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imsdeleteusers', get_string('deleteusers', 'enrol_imsenterprise'), '', 0)); + $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imsdeleteusers', get_string('deleteusers', 'enrol_imsenterprise'), get_string('deleteusers_desc', 'enrol_imsenterprise'), 0)); $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/fixcaseusernames', get_string('fixcaseusernames', 'enrol_imsenterprise'), '', 0)); $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/fixcasepersonalnames', get_string('fixcasepersonalnames', 'enrol_imsenterprise'), '', 0)); - $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imssourcedidfallback', get_string('sourcedidfallback', 'enrol_imsenterprise'), '', 0)); + $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imssourcedidfallback', get_string('sourcedidfallback', 'enrol_imsenterprise'), get_string('sourcedidfallback_desc', 'enrol_imsenterprise'), 0)); $settings->add(new admin_setting_heading('enrol_imsenterprise_usersettings_roles', get_string('roles', 'enrol_imsenterprise'), get_string('imsrolesdescription', 'enrol_imsenterprise'))); @@ -68,20 +68,20 @@ if ($ADMIN->fulltree) { //--- course data options ------------------------------------------------------------------------------- $settings->add(new admin_setting_heading('enrol_imsenterprise_coursesettings', get_string('coursesettings', 'enrol_imsenterprise'), '')); - $settings->add(new admin_setting_configtext('enrol_imsenterprise/truncatecoursecodes', get_string('truncatecoursecodes', 'enrol_imsenterprise'), '', 0, PARAM_INT, 2)); + $settings->add(new admin_setting_configtext('enrol_imsenterprise/truncatecoursecodes', get_string('truncatecoursecodes', 'enrol_imsenterprise'), get_string('truncatecoursecodes_desc', 'enrol_imsenterprise'), 0, PARAM_INT, 2)); - $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/createnewcourses', get_string('createnewcourses', 'enrol_imsenterprise'), '', 0)); + $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/createnewcourses', get_string('createnewcourses', 'enrol_imsenterprise'), get_string('createnewcourses_desc', 'enrol_imsenterprise'), 0)); - $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/createnewcategories', get_string('createnewcategories', 'enrol_imsenterprise'), '', 0)); + $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/createnewcategories', get_string('createnewcategories', 'enrol_imsenterprise'), get_string('createnewcategories_desc', 'enrol_imsenterprise'), 0)); - $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imsunenrol', get_string('allowunenrol', 'enrol_imsenterprise'), '', 0)); + $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imsunenrol', get_string('allowunenrol', 'enrol_imsenterprise'), get_string('allowunenrol_desc', 'enrol_imsenterprise'), 0)); //--- miscellaneous ------------------------------------------------------------------------------------- $settings->add(new admin_setting_heading('enrol_imsenterprise_miscsettings', get_string('miscsettings', 'enrol_imsenterprise'), '')); - $settings->add(new admin_setting_configtext('enrol_imsenterprise/imsrestricttarget', get_string('restricttarget', 'enrol_imsenterprise'), '', '')); + $settings->add(new admin_setting_configtext('enrol_imsenterprise/imsrestricttarget', get_string('restricttarget', 'enrol_imsenterprise'), get_string('restricttarget_desc', 'enrol_imsenterprise'), '')); - $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imscapitafix', get_string('usecapitafix', 'enrol_imsenterprise'), '', 0)); + $settings->add(new admin_setting_configcheckbox('enrol_imsenterprise/imscapitafix', get_string('usecapitafix', 'enrol_imsenterprise'), get_string('usecapitafix_desc', 'enrol_imsenterprise'), 0)); $importnowstring = get_string('aftersaving...', 'enrol_imsenterprise').' '.get_string('doitnow', 'enrol_imsenterprise').''; $settings->add(new admin_setting_heading('enrol_imsenterprise_doitnowmessage', '', $importnowstring)); diff --git a/lang/en/help/enrol/imsenterprise/capita.html b/lang/en/help/enrol/imsenterprise/capita.html deleted file mode 100644 index 308b43b9f60..00000000000 --- a/lang/en/help/enrol/imsenterprise/capita.html +++ /dev/null @@ -1,2 +0,0 @@ -

Capita

-

The student data system produced by Capita has been found to have one slight error in its XML output. If you are using Capita you should activate this option - otherwise leave it un-ticked.

diff --git a/lang/en/help/enrol/imsenterprise/categorisation.html b/lang/en/help/enrol/imsenterprise/categorisation.html deleted file mode 100644 index 30b477757b9..00000000000 --- a/lang/en/help/enrol/imsenterprise/categorisation.html +++ /dev/null @@ -1,7 +0,0 @@ -

Automatic Categorisation

- -

If the <org><orgunit> element is present in a course's incoming data, its content will be used to specify a category if the course is to be created from scratch.

- -

The plugin will NOT re-categorise existing courses.

- -

If no category exists with the desired name, then a HIDDEN category will be created.

diff --git a/lang/en/help/enrol/imsenterprise/createnewcourses.html b/lang/en/help/enrol/imsenterprise/createnewcourses.html deleted file mode 100644 index a4dc16de85e..00000000000 --- a/lang/en/help/enrol/imsenterprise/createnewcourses.html +++ /dev/null @@ -1,9 +0,0 @@ -

Automatic creation of new courses

- -

The IMS Enterprise enrolment plugin can create new courses for any it finds in the IMS data but not in Moodle's database, if this setting is activated.

- -

Courses are first queried by their "idnumber" - an alphanumeric field in Moodle's course table, which can specify the code used to identify the course in the Student Information System (for example). If that is not found, the course table is searched for the "short description", which in Moodle is the short course identifier as displayed in the breadcrumbs etc. (In some systems these two fields may well be identical.) Only when that search has failed can the plugin optionally create new courses.

- -

Any newly-generated courses are HIDDEN when created. This is to prevent the possibility of students wandering into completely empty courses that the teacher may be unaware of.

- - diff --git a/lang/en/help/enrol/imsenterprise/createnewusers.html b/lang/en/help/enrol/imsenterprise/createnewusers.html deleted file mode 100644 index 89217e359ce..00000000000 --- a/lang/en/help/enrol/imsenterprise/createnewusers.html +++ /dev/null @@ -1,8 +0,0 @@ -

Automatic creation of user accounts

- -

IMS Enterprise enrolment data typically describes a set of users. If this setting is turned on, accounts can be created for any users not found in Moodle's database.

- -

Users are searched for first by their "idnumber", and second by their Moodle username.

- -

Passwords

-

Passwords are not imported by the IMS Enterprise plugin. We recommend using Moodle's authentication plugins to authenticate users.

\ No newline at end of file diff --git a/lang/en/help/enrol/imsenterprise/deleteusers.html b/lang/en/help/enrol/imsenterprise/deleteusers.html deleted file mode 100644 index 0b95b5d1980..00000000000 --- a/lang/en/help/enrol/imsenterprise/deleteusers.html +++ /dev/null @@ -1,5 +0,0 @@ -

Automatic deletion of user accounts

- -

IMS Enterprise enrolment data can specify the deletion of user accounts (if the "recstatus" flag is set to 3, which represents deletion of an account), if this setting is turned on.

- -

As is standard in Moodle, the user record isn't actually deleted from Moodle's database, but a flag is set to mark the account as deleted.

\ No newline at end of file diff --git a/lang/en/help/enrol/imsenterprise/formatoverview.html b/lang/en/help/enrol/imsenterprise/formatoverview.html deleted file mode 100644 index 5d0b9bc437e..00000000000 --- a/lang/en/help/enrol/imsenterprise/formatoverview.html +++ /dev/null @@ -1,87 +0,0 @@ -

Format overview

-

Below is a simple guide to the basic structure of a typical IMS Enterprise -data file. Much more information is available on the IMS Enterprise official website.

- -

You may like to read the conformance summary which describes which IMS data elements this plugin can process.

- - -

Basic guide to IMS Enterprise file format

- -

For any IMS-style enrolment you need a <group> tag which specifies the course, a <person> tag which specifies the user account, and a <membership> tag containing <member> tags which specify a person's role within a given course.

-

- -

-Remember that the numeric keys used in the Moodle databases are not the interoperable data - a student data system is never going to know in advance that Joe is the 20th user added to the Moodle database - so those aren't the keys exchanged in this type of data.

-

- -

-Typically a course would have a reference code as well as a name, so let's assume its code is MOODLE101. To define your course you could use

-

- -

-  <group>
-    <sourcedid>
-      <source>MyDataSystem</source>
-      <id>MOODLE101</id>
-    </sourcedid>
-    <description>
-      <short>Moodle 101</short>
-    </description>
-  </group>
-

- -

-The enrolment script will look for a course with code MOODLE101, and (optionally) create it if it doesn't exist. Similarly for the person - let's assume it's "jmoodle":

-

- -

-  <person>
-    <sourcedid>
-      <source>MyDataSystem</source>
-      <id>jmoodle</id>
-    </sourcedid>
-    <userid>jmoodle</userid>
-    <name>
-      <fn>Joe Moodle</fn>
-      <n>
-        <family>MOODLE</family>
-        <given>JOE</given>
-      </n>
-    </name>
-  </person>
-

- -

-If Joe doesn't already have an account, the script can (optionally) create an account for him.

- - -

-Let's now look at the membership, adding the person to the course:

-

- -

-  <membership>
-    <sourcedid>
-      <source>MyDataSystem</source>
-      <id>MOODLE101</id>
-    </sourcedid>
-    <member>
-      <sourcedid>
-        <source>MyDataSystem</source>
-        <id>jmoodle</id>
-      </sourcedid>
-      <role roletype="01">
-        <status>1</status>
-        <extension><cohort>unit 2</cohort></extension>
-      </role>
-    </member>
-  </membership>
-

- -

-The IMS Enterprise specification does offer a facility for specifying start/end dates for enrolments, so those can be included using the <timeframe> tag if needed.

-

- -

-If a person is already added to a group within the course, the script won't actually modify that. If they are not grouped, however, then the specified grouping will be applied.

- diff --git a/lang/en/help/enrol/imsenterprise/photos.html b/lang/en/help/enrol/imsenterprise/photos.html deleted file mode 100644 index f6f407b1888..00000000000 --- a/lang/en/help/enrol/imsenterprise/photos.html +++ /dev/null @@ -1,7 +0,0 @@ -

Photo's

-

When creating a new user account based on the Enterprise data, it's possible that a photo is specified for the user - usually by giving a URL to the image file.

- -

If <photo> data is supplied, then Moodle can attempt to download the image file and turn it into the user-picture displayed within Moodle.

- -

PLEASE NOTE: This can add a significant additional burden to the process if there are a lot of user accounts, because of the need to download, modify, and store the images. It is not recommended to activate this option in a context with a very large number of accounts to be created.

- diff --git a/lang/en/help/enrol/imsenterprise/sourceddidfallback.html b/lang/en/help/enrol/imsenterprise/sourceddidfallback.html deleted file mode 100644 index fd5b23ffae7..00000000000 --- a/lang/en/help/enrol/imsenterprise/sourceddidfallback.html +++ /dev/null @@ -1,10 +0,0 @@ -

SourceID as fallback

-

In IMS data, the <sourcedid> field represents the persistent ID code - for a person as used in the source system. The <userid> - field is a separate field which should contain the ID code used by - the user when logging in.

-

In many cases these two codes may be the same - but not always.

-

Some student information systems fail to output the <userid> field. -If this is the case, you should activate this setting to allow for using the -<sourcedid> as the Moodle user ID.

-

Otherwise, leave this setting turned off.

\ No newline at end of file diff --git a/lang/en/help/enrol/imsenterprise/target.html b/lang/en/help/enrol/imsenterprise/target.html deleted file mode 100644 index f438c01b5da..00000000000 --- a/lang/en/help/enrol/imsenterprise/target.html +++ /dev/null @@ -1,5 +0,0 @@ -

Targets

-

An IMS Enterprise data file could be intended for multiple "targets" - different LMSes, or different systems within a school/university. It's possible to specify in the Enterprise file that the data is intended for one or more named target systems, by naming them in <target> tags contained within the <properties> tag.

- -

In many cases you don't need to worry about this. Leave the config setting blank and Moodle will always process the data file, no matter whether a target is specified or not. Otherwise, fill in the exact name that will be output inside the <target> tag. -

diff --git a/lang/en/help/enrol/imsenterprise/truncatecoursecodes.html b/lang/en/help/enrol/imsenterprise/truncatecoursecodes.html deleted file mode 100644 index 0e1fd802ee7..00000000000 --- a/lang/en/help/enrol/imsenterprise/truncatecoursecodes.html +++ /dev/null @@ -1,2 +0,0 @@ -

Truncate course codes

-

In some situations you may have course codes which you wish to truncate to a specified length before processing. If so, enter the number of characters in this box. Otherwise, leave the box blank and no truncation will occur.

\ No newline at end of file diff --git a/lang/en/help/enrol/imsenterprise/unenrol.html b/lang/en/help/enrol/imsenterprise/unenrol.html deleted file mode 100644 index 3cdf8b72354..00000000000 --- a/lang/en/help/enrol/imsenterprise/unenrol.html +++ /dev/null @@ -1,19 +0,0 @@ -

Unenrolling students/teachers

- -

The Enterprise data can add as well as remove course enrolments - for students and for teachers. If this setting is turned on, then Moodle will carry out unenrolments when specified in the data.

- -

There are three ways of unenrolling students within the IMS data:

- -
  • A <member> element which specifies the given student and course, and with the "recstatus" attribute of the <role> element set to 3 (which means "delete"). THIS IS NOT YET IMPLEMENTED IN THE MOODLE PLUGIN.
    • - -
  • A <member> element which specifies the given student and course, and with the <status> element set to 0 (which means "inactive").
    • -
- -

The third method is slightly different. It does not require this config setting to be activated, and can be specified well in advance of the unenrolment date:

- -
    -
  • A <member> element which specifies a <timeframe> for the enrolment can specify the begin and/or end dates for enrolment of this particular student. These dates are loaded into Moodle's enrolment data table if present, and so after the end-date, a student will no longer be able to access that particular course.
    • -
- - -