This hook can be used to handle the data that is going to be stored in the database for a user. Modules can do some last minute change on the data or keep some external system in sync with the Phorum user data.

In combination with the user_get hook, this hook could also be used to store and retrieve some of the Phorum user fields using some external system.

Call time:

Just before user data is stored in the database.

Hook input:

An array containing user data that will be sent to the database.

Hook output:

The same array as the one that was used for the hook call argument, possibly with some updated fields in it.

Example code:

function phorum_mod_foo_user_save($user)
{
    // Add "[A]" in front of admin user real_name fields.
    $A = $user["admin"] ? "[A]" : "";
    $real_name = preg_replace('/^\[A\]/', $A, $user["real_name"]);
    $user['real_name'] = $real_name;

    // Some fictional external system to keep in sync.
    include("../coolsys.php");
    coolsys_save($user);

    return $user;
}