View source for Upload Tutor Relationships Block

{{Blocks}}
{{Infobox plugin
|type = Block, Tutor links 
|entry = https://moodle.org/plugins/block_tutorlink
|tracker = https://github.com/marxjohnson/moodle-block_tutorlink/issues
|discussion = https://github.com/marxjohnson/moodle-block_tutorlink/issues
|maintainer = [[User:Mark Johnson|Mark Johnson]]
|float = right
}}
This block allows user relationships (that is one user assigned a role in another user's context) to be created/kept up to date via CSV files. It was written for personal tutors, but would work equally well for parents.

It can be operated in two modes:

Manual Upload - any user with the block/tutorlink:use capability (by default, only admins) can upload a file to process on demand.

Automatic - a file location is configured, then the block automatically checks this location. If a file is found, it is processed and results emailed to the administrator.

== Configuration ==

The block has several configuration options, found in Site Administration/Plugins/Blocks/Upload Tutor Relationships.
*''Tutor Role'' is the role that will be assigned by the block. As of 2.0, a role must be allowed to be assigned at the User context level before it can be selected here. This is configured on the role's ''Define Role'' page.
*''Location of File for Automatic Processing'' is the location of the file on the server's local file system to be processed by the block's cron job, allowing periodic updates of role assignments.  Leaving this blank will disable the cron job.
*''Keep processed files'' allows files processed by cron jobs to be kept for future reference.
*''Processed file location'' is the folder that processed files will be placed in, if ''Keep processed files'' is ticked.
*''Days to keep processed files for'' is self-explanatory. After this many days, processed files will be deleted.

== Usage ==

=== Correct File Format ===
The files to be processed should be in CSV format (hopefully no surprises there). 

They may consist of any number of rows, each with three fields: tutor idnumber,tutee idnumber, action; it is important to note that the idnumbers are expected to be populated from an external database, they are not the id field in the user table. Action can be add or del, with add creating relationships and del deleting relationships. None of the fields should be delimited.

As of Moodle 2.0, the order of the fields changed slightly to make them more consistent with the Flatfile Enrolements plugin.
The format for each row is now: action, tutor idnumber, tutee idnumber. For example, a file with this contents:
 add, 1234, 4321
 add, 1234, 4322
 del, 2232, 3223
Will assign the user with the idnumber 1234 to users with idnumbers 4321 and 4321, then remove the user with idnumber 2232 from the user 3223.

Trying to add relationships that already exist in Moodle or remove those that dont will not cause problems, as this block will skip over those records.

=== Manual upload ===
After the CSV file is created, navigate to the page containing the block, and upload the file. It will be processed and a report will appear showing you the operations that were successful, along with any errors.

=== Automatic processing ===
A file placed at the path specified in ''Location of file for automatic processing'' will be processed automatically when the block's cron job runs.  A report will then be emailed to the Moodle Administrator.

[[Category:Block]]
[[Category:Contributed code]]

[[es:Bloque Subir relaciones de tutor]]