mirror of
https://github.com/moodle/moodle.git
synced 2025-02-25 20:43:33 +01:00
Users can now be assigned to multiple groups. Thanks Yu! Break out the Bob Marley!! Otherwise groups work more or less like they did before. This has been pretty well tested by Yu and myself, but since Yu started uncovering lots of existing groups bugs it's possible there may be still a few corner cases still lurking here and there. Please help test this thoroughly for 1.6!!
35 lines
2.0 KiB
HTML
Executable File
35 lines
2.0 KiB
HTML
Executable File
<p align="center"><b>Upload groups</b></p>
|
|
|
|
<p>This facility allows the batch upload of groups into Moodle.</p>
|
|
|
|
|
|
<ul>
|
|
<li>Each line of the file contains one record</li>
|
|
<li>Each record is a series of data separated by commas</li>
|
|
<li>The first record of the file is special, and contains a list of fieldnames. This defines the format of the rest of the file.
|
|
<blockquote>
|
|
<p><strong>Required fieldnames:</strong> these fields must be included in the first record, and defined for each user</p>
|
|
<p></p>
|
|
<font color="#990000" face="Courier New, Courier, mono">groupname</font></p>
|
|
</p>
|
|
<p><strong>Default fieldnames:</strong> these are optional - if they are not included then the values are taken from the current language and current course</p>
|
|
<p><font color="#990000" face="Courier New, Courier, mono">idnumber, coursename, lang</font> </p>
|
|
<p><strong>Optional fieldnames: </strong>all of these are completely optional. </p>
|
|
<p> <font color="#990000" face="Courier New, Courier, mono">description, picture, hidepicture</font></p>
|
|
</blockquote>
|
|
</li>
|
|
<li>Commas within the data should be encoded as &#44 - the script will automatically decode these back to commas. </li>
|
|
<li>For Boolean fields, use 0 for false and 1 for true. </li>
|
|
<li>Either idnumber or coursename can be used to identify the course. Idnumber overrides coursename. If neither is specified, the groups will be added to the current course.
|
|
<li>Coursename is the course shortname.</li>
|
|
<li>Note: If a group is already registered in the Moodle database for a particular course, this script will return the
|
|
group name for that group. Teachers are only allowed to upload groups in courses they are authorized to edit.</li>
|
|
</ul>
|
|
|
|
<p>Here is an example of a valid import file:</p>
|
|
<p><font size="-1" face="Courier New, Courier, mono"></font>groupname,idnumber,lang,description,picture <br />
|
|
group1, Phil101, en, this group requires extra attention!, 0 <br />
|
|
group2, Math243, , ,
|
|
</font></p>
|
|
|