This hook can be used for performing tasks after a successful user login and for changing the page to which the user will be redirected (by returning a different redirection URL). If you need to access the user data, then you can do this through the global $PHORUM variable. The user data will be in $PHORUM["user"].

Call time:

In login.php, after a successful login, just before redirecting the user to a Phorum page.

Hook input:

The redirection URL.

Hook output:

Same as input.

Example code:

function phorum_mod_foo_after_login($url)
{
    global $PHORUM;

    // Redirect to the user's chosen page
    $url = $PHORUM["user"]["phorum_mod_foo_user_login_url"];

    return $url;
}