Login callbacks

There are cases where we want any plugin to do some check or action as part of the require_login check.

after_require_login

Some use cases:

replacing the sitepolicy feature with a more robust / advanced version
augmenting the 'user fully setup' workflow to add more steps but outside their profile editing page
adding extra layers of checks, eg an ip address check but doing this across whole courses instead of at the sitelevel which is too coarse, or at the activity level which is too fine.
enforcing various types of course visibility dependencies, eg 'before you can do course X you need to complete course Y'

function tool_myplugin_after_require_login() {

   if (should_divert()) {
       redirect($somewhere);
   }

}