<?php
/**
 * New user identity
 *
 * Populates a new user's default identity from LDAP on their first visit.
 *
 * This plugin requires that a working public_ldap directory be configured.
 *
 * @version 1.0
 * @author Kris Steinhoff
 *
 * Example configuration:
 *
 *  // The id of the address book to use to automatically set a new
 *  // user's full name in their new identity. (This should be an
 *  // string, which refers to the $rcmail_config['ldap_public'] array.)
 *  $rcmail_config['new_user_identity_addressbook'] = 'People';
 *  
 *  // When automatically setting a new users's full name in their
 *  // new identity, match the user's login name against this field.
 *  $rcmail_config['new_user_identity_match'] = 'uid';
 *  
 *  // Use the value in this field to automatically set a new users's
 *  // full name in their new identity.
 *  $rcmail_config['new_user_identity_field'] = 'name';
 */
class new_user_identity extends rcube_plugin
{
    function init()
    {
        $this->add_hook('create_user', array($this, 'lookup_user_name'));
    }

    function lookup_user_name($args)
    {
        $rcmail = rcmail::get_instance();
        if ($addressbook = $rcmail->config->get('new_user_identity_addressbook')) {
            $match = $rcmail->config->get('new_user_identity_match');
            $ldap = $rcmail->get_address_book($addressbook);
            $ldap->prop['search_fields'] = array($match);
            $results = $ldap->search($match, $args['user'], TRUE);
            if (count($results->records) == 1) {
                $args['user_name'] = $results->records[0][$rcmail->config->get('new_user_identity_field')];
            }
        }
        return $args;
    }
}
?>