search

erudisiya / moodle-local_delegate

1 stars 0 forks source link

hard to understand how to use the plugin and what it actually does. #13

Open danmarsden opened 7 months ago

danmarsden commented 7 months ago

Reading the plugins db description it was quite hard to actually understand what this plugin does.

It's not clear that this only generates notifications/messages and does not perform any specific actions other to facilitate a workflow process. - requests/accepts/declines etc.

It's also not clear "who" is allowed to be a delegate - when I install it on my testing site - I had no users available to set as a delegate within the form.

documentation that covers how to set this plugin up and how to configure who the people are that you can delegate too should be added - I'm also not quite sure that using the "'local/delegate:approve" is correct here: https://github.com/erudisiya/moodle-local_delegate/blob/master/delegate_application_form.php#L44

Because that means that only people that can approve delegates are the ones that can be assigned as delegates too? - but I really don't understand this plugin enough to know if that is actually correct or not.

erudisiya commented 7 months ago

As a result of a mutual discussion between a delegator and delegatee, the delegator gives his responsibility to the delegatee. With this plugin the delegator ie. a teacher / non-editing-teacher / the equivalent role can ask the admin to delegate their responsibility of any course, to the delegatee ie. the other teacher / non-editing-teacher / the equivalent role who both have been already enrolled in the same course. Admin can accept or decline requests by delegator. With this plugin, the admin knows who wants to take leave.

I have added a capability local/delegate:candelegatee (context level course). So admin can enable this capability for teacher / non-editing-teacher / the equivalent role. Let's say John and Smith have this capability local/delegate:candelegatee with the role of teacher and non-editing teacher respectively, they can be listed in the delegatee dropdown.

Let's say three teachers manage a course content of three different topics. One of them will be taking a leave for a week for a personal reason, his / her responsibility will be take care of his / her colleague.

This plugin is useful for small institutes to large-size corporate trainers.

Please let me know if you have any further queries, I will be very glad to answer that. Thank you.

danmarsden commented 7 months ago

you shouldn't be explaining it to me "here" - you need to improve the documentation and description in the plugins database to make it clear to others how this plugin works and how it can be used.