Pxxo_Widget_IdentityManager

Ce widget regroupe plusieurs modules permettant de gérer les identités au sein d'une application. En utilisant ce widget, on peut s'authentifier, s'inscrire, valider les comptes par email, se faire rappeler son mot de passe, et éditer ses informations personnelles. Les comptes sont stockés dans un annuaire LDAP ou dans une base de données relationnelle. Pxxo_Widget_IdentityManager permet l'accès ou non aux sous widgets selon le paramètre menu_tab_to_show et selon l'état de connexion (Auth).

Les différents modules de ce widget sont les suivants :

• Auth : affiche un formulaire de connexion (login et mot de passe)
• Register : affiche un formulaire d'inscription dont les champs principaux sont : login, mot de passe et email (mais avec la possibilité d'en ajouter d'autres)
• Profil : affiche un formulaire pour éditer les informations fournies lors de l'inscription (ceci suppose que l'utilisateur soit authentifié avant d'y accéder)
• SendCode : affiche un formulaire pour envoyer le code de validation de l'inscription par email
• EnterCode : affiche un formulaire pour saisir le code de validation de l'inscription
• RetrievePassword : affiche un formulaire pour envoyer un nouveau mot de passe par email
• initialize_driver : mode spécial qui initialise le pilote pour accéder à la base de données (permet de créer la table si elle n'existe pas) et affiche le résultat de cette opération

Exemples :

Démo :

[ lien direct ]

A voir aussi :

• Exemple d'utilisation en ligne
• Téléchargement

Le paramètre “connection_options” est un tableau associatif décrivant les options pour personnaliser l'accès à la base de données : les options communes à LDAP, MDB2, AIT , les options pour la connexion LDAP, les options pour la connexion MDB2 et les options pour la connexion AIT.

Les options suivantes sont communes au paramétrage LDAP et MDB2 :

Si vous avez défini le paramètre connection_driver='LDAP', voici les options de personnalisation pour la connection :

Exemple :

 
$params = array();
$params['connection_driver']  = 'LDAP';
$params['connection_options'] = array(
    'usernamecol'   => 'uid', // ou la meme valeur que mailcol si on veut le mail comme login
    'mailcol'       => 'mail',
    'realnamecol'   => 'cn',
    'passwordcol'   => 'userPassword',
    'passwordtype'  => 'md5', // ou 'clear'
    'host'          => 'ldap.exemple.com',
    'port'          =>  389,
    'basedn'        => 'dc=exemple,dc=com',
    'binddn'        => 'cn=manager,dc=exemple,dc=com',
    'bindpw'        => 'secret',
    'usersdn'       => 'dc=inist,dc=fr', // les connexions se font sur la totalité de l'annuaire
    'registerdn'    => 'ou=people,dc=exemple,dc=com',
    'userdefaultvalue' => array(
        'objectclass' => array('top','inetOrgPerson'),
     )
);

'userdefaultvalue' => array(
    'objectclass' => array('top','inetOrgPerson'),
    )

Si vous avez défini le paramètre connection_driver='MDB2', voici les options de personnalisation pour la connection :

Exemple :

 
 
// exemples de paramètrage pour MDB2
$params['connection_driver']  = 'MDB2';
$params['connection_options'] = array(
 
     // parametres generiques
     'usernamecol'  => 'username',
     'mailcol'      => 'mail',                           
     'realnamecol'  => 'realname',
     'passwordcol'  => 'password',
     'passwordtype' => 'md5',
 
     // parametres specifiques MDB2
     'dsn'          => 'mysql://root@locahost/test',
     'db_options'   => array('debug' => 2),
     'table'        => 'pxxo_widgets_register',
);
 

Si vous avez défini le paramètre connection_driver='AIT', le connecteur AIT (All-Is-Tag) sera utilisé. Voici les options de personnalisation pour la connexion :

Exemple :

 
$params['connection_driver'] = 'AIT';
$params['connection_options'] = array(
    'usernamecol' => 'uid',
    'mailcol'     => 'mail',
    'realnamecol' => 'realname',
    'passwordcol' => 'password',
    'handle'      => AIT::connect('mysql:host=localhost;dbname=ait', 'root'),
    'itemtype'    => 'users',
);

Ce paramètre permet de modifier toutes URL utilisés par le Widget et les sous widgets. On peut ainsi utiliser de la réecriture d'URL afin d'obtenir des URL “parlante”…

Exemple :

 
$params['action_urls']  = array(
    'auth'              => $this->Registry->url_base.'/se-connecter',
    'profil'            => $this->Registry->url_base.'/mon-profil',
    'register'          => $this->Registry->url_base.'/inscription',
    'entercode'         => $this->Registry->url_base.'/verifier-code-inscription',
    'sendcode'          => $this->Registry->url_base.'/rappeler-code-inscription',
    'retrievepassword'  => $this->Registry->url_base.'/mot-de-passe-perdu',
);

 
<?php
 
require_once 'Pxxo/Widget/IdentityManager.php';
 
$params['connection_driver'] = ... ;  // cf. ci-dessus
$params['connection_options'] = ... ; // cf. ci-dessus
$params['menu_tab_to_show']     = array('auth', 'profil', 'register', 'entercode', 'sendcode', 'retrievepassword');
$params['default_tab']          = 'auth'; // par défaut on tombera sur l'onglet demandant l'authentification
$params['show_form']            = true;
$params['show_lost_password']   = false;
$params['skip_cgu']             = false;
$params['cgu']                  = '...CGU...';
$params['ask_current_password'] = true;
$params['skip_codeverif']       = true;
$params['mail_driver']          = 'mail';
$params['mail_options']         = array();
$params['mail_sender']          = 'noreply@noreply.com';
 
$widg = new Pxxo_Widget_IdentityManager($params);
 
$widg->addDecorator('Pxxo_Widget_Decorator_Core');
$widg->main();
$widg->dump();
 
 
?>

Maintenant voici comment utiliser les callbacks utilisateurs :

 
<?php
 
require_once 'Pxxo/Widget/IdentityManager.php';
 
function my_onregister($user, $connection) {
  // on s'amuse a convertir en majuscule le realname
  // ca n'a pas bcp d'interet mais bon c'est pour l'exemple...
  $user['realname'] = strtoupper($user['realname']);
  $connection->update($user);
}
$params['connection_driver'] = ... ;  // cf. ci-dessus
$params['connection_options'] = ... ; // cf. ci-dessus
$params['onregister_callback'] = 'my_onregister';
$widg = new Pxxo_Widget_IdentityManager($params);
 
$widg->addDecorator('Pxxo_Widget_Decorator_Core');
$widg->main();
$widg->dump();
 
 
?>