6

From Moodle doc:

A context is a space in Moodle where roles can be assigned.

I understand that a context is a logical space used to manage Moodle objects.

I developed a custom block plugin with a file upload where I use file_prepare_draft_area andfile_save_draft_area_files functions.There is a $context parameter that must be passed and I am don't really know what context should I pass ? This mean, I guess, in which logical space should I put my block plugin uploaded files ? In my opinion, the most logical would be store the uploaded files in a context related to my block plugin.

I tried to use context_block::instance($instanceid) but I don't know how to get $instanceid param.

  • Which context should I use in this case?
  • How to get it?
ben.IT
  • 1,490
  • 2
  • 18
  • 37

2 Answers2

14

The types of context are as follows:

  • System
  • Course category
  • Course
  • Activity module
  • Block
  • User

The hierarchy of contexts are: System => Course category => Course => Activity module

Block contexts can appear within courses or within the 'site' course. User contexts are outside of courses.

If you want the files tied to a specific instance of the block (e.g. so they are deleted automatically when the block is deleted and you can keep the files from different instances of the block separate), then you should use the block context (but you'll have to pass the instanceid of the block to the sub-pages in order to use this to get the context:

$context = context_block::instance($blockinstanceid);

If you want the files tied to the course - so all instances of the block in the course share the same file space and the files are only deleted when the whole course is deleted, then use the course context (pass the courseid into the subpages, as a param, then use:

$context = context_course::instance($courseid);

If, however, you want to share that file area across all blocks on the site, then the system context is what you want:

$context = context_system();

ben.IT
  • 1,490
  • 2
  • 18
  • 37
davosmith
  • 6,037
  • 2
  • 14
  • 23
  • 2
    This sounds good, should be in the official doc! Thanks @davosmith! – ben.IT Mar 28 '17 at 08:49
  • 1
    Official docs are a wiki - feel free to add changes, if you think this is helpful. – davosmith Mar 28 '17 at 08:51
  • I think this helps a lot newcomers like me to Moodle but I won't feel comfortable with copying and pasting your work ;) – ben.IT Mar 28 '17 at 09:14
  • i've read that docs page about five times and was still left with a very similar question. thank you for this clear answer. – John Nov 27 '20 at 13:57
0

There is also a piece of (old?) documentation for reference - see par. "13.2. Moodle's Roles and Permissions System".

(I also found Russian translation of that paragraph, maybe useful for someone.)

Samantra
  • 65
  • 1
  • 8