Subversion Repositories Applications.annuaire

Rev

Rev 5 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php
/**
* PHP Version 5
*
* @category  PHP
* @package   annuaire
* @author    aurelien <aurelien@tela-botanica.org>
* @copyright 2010 Tela-Botanica
* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
* @version   SVN: <svn_id>
* @link      /doc/annuaire/
*/

class AnnuaireControleur extends Controleur {

        /**
         * (fonction héritée de la classe Controleur)
         * Avant chaque chargement de vue, on ajoute l'url de la page dans
         * les variables à insérer.
         * @param Array $donnes les données à insérer dans la vue
         * @return Array $donnees les données modifiées
         */
        public function preTraiterDonnees($donnees) {
                $donnees['base_url'] = Registre::getInstance()->get('base_url_application');
                return $donnees;
        }

        /**
         * Fonction affichant la vue par défaut, ici le menu principal
         * @return String la vue contenant le menu
         */
        public function index() {
                $data = array();
                $this->chargerVue('index_annuaire', $data);

                return $this->index_annuaire;
        }

/**-------- Fonctions de gestion des annuaires --------------------------------*/

        /**
         * Charge la vue contenant la liste des annuaires gérés par l'application
         * @return string la vue contenant la liste des annuaires
         */
        public function chargerListeAnnuaire() {
                $this->chargerModele('AnnuaireModele');
                $data['erreurs'] = null;
                $data['annuaires'] = $this->AnnuaireModele->chargerListeAnnuaire();
                $this->chargerVue('liste_annu', $data);

                return $this->liste_annu;
        }

        /**
         * Charge la vue contenant les informations d'un annuaire donné en paramètre
         * @param int $id l'identifiant de l'annuaire
         * @return string la vue contenant les informations sur l'annuaire
         */
        public function chargerAnnuaire($id) {
                $this->chargerModele('AnnuaireModele');
                $this->chargerModele('MetadonneeModele');
                $data['erreurs'] = array();
                $data['annuaire'] = $this->AnnuaireModele->chargerAnnuaire($id, true);
                $data['metadonnees'] = $this->MetadonneeModele->chargerListeMetadonneeAnnuaire($id);
                $this->chargerVue('annuaire', $data);

                return $this->annuaire;
        }

        /**
         * Charge et affiche la liste des inscrits à un annuaire donné en paramètre
         * @param $id int l'identifiant de l'annuaire
         * @return string la vue contenant les inscrits à l'annuaire
         */
        public function chargerAnnuaireListeInscrits($id) {

                $this->chargerModele('AnnuaireModele');
                $data['erreurs'] = array();
                $champs = $this->obtenirChampsMappageAnnuaire($id);
                $data['annuaire'] = $this->AnnuaireModele->chargerAnnuaireListeInscrits($id, $champs[0], 1);
                $this->chargerVue('annuaire_inscrits', $data);

                return $this->annuaire_inscrits;
        }

/**-------- Fonctions d'affichage du formulaire de saisie d'un champ de metadonnée suivant le type de champ---------*/

        /**
         * Affiche le formulaire d'inscription pour un annuaire donné
         * @param int $id_annuaire l'identifiant de l'annuaire pour lequel on veut afficher le formulaire
         * @param Array $donnees le tableau de données pour préremplir le formulaire si besoin (en cas de retour erreur)
         */
        public function afficherFormulaireInscription($id_annuaire, $donnees=array()) {

                $this->chargerModele('AnnuaireModele');
                $annuaire = $this->AnnuaireModele->chargerAnnuaire($id_annuaire, false);

                $this->chargerModele('MetadonneeModele');
                $donnees['aa_id_annuaire'] = $id_annuaire;
                $metadonnees = $this->MetadonneeModele->chargerListeMetadonneeAnnuaire($id_annuaire);

                // TODO: ceci charge toutes les métadonnées, voir si l'on ne peut pas parser le formulaire
                // pour ne charger que ce qui est nécéssaire
                foreach($metadonnees as $metadonnee) {

                        $id_champ = $metadonnee['amc_id_champ'];
                        $nom_champ = $metadonnee['amc_abreviation'];
                        // on charge le formaulaire d'affichage de chacune des métadonnées
                        $donnees['champs'][$nom_champ] = $this->afficherFormulaireChampMetadonnees($id_champ,$metadonnee);
                }

                // le nom du formulaire d'inscription est le même que le code de l'annuaire
                // TODO: réfléchir à une meilleure manière de stocker ça
                $this->ChargerVue($annuaire['informations']['aa_code'].'_inscription',$donnees);

                $formulaire_inscription = $annuaire['informations']['aa_code'].'_inscription';

                return $this->$formulaire_inscription;
        }

        /**
         * Charge et affiche le champ correspondant à la modification ou l'ajout d'un champ de metadonnée
         * @param int $id_champ l'identifiant du champ demandé
         * @return string la vue contenant le champ de formulaire correspondant
         */
        public function afficherFormulaireChampMetadonnees($id_champ, $donnees=array()) {

                // si le champ est restreint à une valeur de liste
                if($donnees['amc_ce_ontologie'] != 0) {
                                $this->chargerModele('OntologieModele');
                                $donnees['liste_valeurs'] = $this->OntologieModele->chargerListeOntologie($donnees['amc_ce_ontologie']);
                }
                $donnees['amc_id_champ'] = $id_champ;
                $this->chargerModele('MetadonneeModele');
                $nom__type_champ = $this->MetadonneeModele->renvoyerCorrespondanceNomTemplateChamp($donnees['amc_ce_type_affichage']);
                return $this->getVue($nom__type_champ,$donnees);
        }

/**-------- Fonctions d'inscription -------------------------------------------------------------------------------*/

        /**
         * Lors d'une tentative d'inscription, ajoute une les infos dans la tables d'inscription
         * temporaire et envoie le mail contenant le lien de confirmation si tout s'est bien passé
         * @param Array $valeurs les valeurs à ajouter
         * @return string la vue contenant la confirmation de l'inscription
         */
        public function ajouterInscriptionTemporaire($valeurs) {

                $this->chargerModele('MetadonneeModele');
                $id_annuaire = $valeurs['aa_id_annuaire'];

                $tableau_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                $valeurs_mappees = array();

                // on itère sur le tableau de valeur pour récupérer les champs de mappage;
                foreach($valeurs as $nom_champ => $valeur) {
                        // pour chaque valeur
                        // on extrait l'id du champ
                        $ids_champ = mb_split("_",$nom_champ);
                        $id_champ = $ids_champ[count($ids_champ) - 1];

                        // Si le champ fait partie des champs mappés
                        $cle_champ = array_search($id_champ, $tableau_mappage[1]);

                        if($cle_champ) {
                                // on ajoute sa clé correspondante dans le tableau des champs mappés
                                // qui sont les champs à vérifier
                                $valeurs_mappees[$ids_champ] = $valeur;
                        }
                }

                // vérification des champs minimaux : nom, prénom, mail, mot de passe
                // TODO: des champs minimaux différents pour chaque annuaire ? comment les stocke t'on ?
                /*if($erreurs = $this->verifierErreursChamps($id_annuaire,$valeurs_mappees, $tableau_mappage)) {
                        $valeurs['erreurs'] = $erreurs;
                        return $this->afficherFormulaireInscription($id_annuaire, $valeurs);
                }*/

                $code_confirmation = $this->InsererDansTableTemporaireEtcreerCodeConfirmationInscription($valeurs);

                $this->envoyerMailConfirmationInscription($valeurs_mappees['champ_mail'],
                                                                                                        $valeurs_mappees['champ_nom'],
                                                                                                        $valeurs_mappees['champ_prenom'],
                                                                                                        $code_confirmation);
                // Si tout s'est bien passé, on affiche la page de confirmation
                return $this->getVue('annuaire_inscription_reussie',array());
        }

        /**
         * Ajoute une nouvelle inscription à un annuaire à partir de données d'une table temporaire.
         * Typiquement, on déclenche cette fonction en cliquant sur le lien contenu dans le mail de confirmation
         * @param int $indentifant L'identifant de session d'une tentative d'inscription
         */
        public function ajouterNouvelleInscription($identifiant) {

                $this->chargerModele('AnnuaireModele');

                $valeurs = $this->AnnuaireModele->chargerDonneesInscriptionTemporaire($identifiant);

                if(!$valeurs || count($valeurs) == 0) {
                        // TODO afficher vue en cas d'echec
                }

                $id_annuaire = $valeurs['aa_id_annuaire'];
                unset($valeurs['aa_id_annuaire']);

                $this->chargerModele('MetadonneeModele');
                // TODO: faire un tri par l'id ou selon autre critère pour séparer champs
                // normaux des meta champs
                $tableau_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

                $valeurs_mappees = array();

                // on itère sur le tableau de valeur pour récupérer les métadonnées;
                foreach($valeurs as $nom_champ => $valeur) {
                        // pour chaque valeur
                        // on extrait l'id du champ
                        $ids_champ = mb_split("_",$nom_champ);
                        $id_champ = $ids_champ[count($ids_champ) - 1];

                        // Si le champ fait partie des champs mappés
                        $cle_champ = array_search($id_champ, $tableau_mappage[1]);
                        if($cle_champ) {
                                // on ajoute sa clé correspondante dans l'annuaire mappé et sa valeur dans le tableau des champs mappés
                                $valeurs_mappees[$tableau_mappage[0][$cle_champ]] = $valeur;
                                // et on supprime sa valeur du tableau de valeurs pour ne pas la retrouver lors
                                // de l'instertion des métadonnées
                                unset($valeurs[$nom_champ]);
                        }
                }

                // obtenir l'id du nouvel arrivant en faisant un select sur le mail qui doit être unique
                $id_nouvel_inscrit = $this->ajouterNouvelleInscriptionDansAnnuaireMappe($id_annuaire,$valeurs_mappees, $tableau_mappage[0]);

                // les champs de metadonnees arrivent avec un identifiant sous la forme type_xxx_id
                foreach($valeurs as $nom_champ => $valeur) {

                        // l'identifiant du champ est la dernière valeur du tableau
                        $ids_champ = mb_split("_",$nom_champ);
                        $id_champ = $ids_champ[count($ids_champ) - 1];

                        // Si l'insertion dans la base a réussi
                        if($this->MetadonneeModele->ajouterNouvelleValeurMetadonnee($id_champ,$id_nouvel_inscrit,$valeur)) {
                                // on continue
                        } else {

                                // Si une des insertions échoue, on supprime les méta valeurs déjà entrées.
                                $this->MetadonneeModele->supprimerValeursMetadonneesParIdEnregistrementLie($id_nouvel_inscrit);
                                return false;
                        }
                }

                //TODO: gérer le cas de spip et de wikini par un multimapping des champs
                //TODO: voir openid

                // Si tout a réussi on supprime les données d'inscription temporaire
                $this->AnnuaireModele->supprimerDonneesInscriptionTemporaire($identifiant);

                // TODO: renvoyer l'utilisateur sur sa fiche
                return true;
        }

        /**
         * Ajoute un nouvel inscrit dans l'annuaire mappé donné en paramètre.
         * En cas de succès, renvoie l'identifiant du nouvel inscrit qui sera
         * utilisé pour insérer les métadonnées liées
         *
         * @param int $id_annuaire identifiant de l'annuaire auquel sera lié le nouvel inscrit
         * @param Array $valeurs_mappees Tableau contenant les valeurs à insérer et ayant comme clés des noms de colonnes
         * @param Array $noms_champs Tableau contenant les noms des champs à insérer
         * @return int l'identifiant unique du nouvel inscrit
         */
        public function ajouterNouvelleInscriptionDansAnnuaireMappe($id_annuaire,$valeurs_mappees, $noms_champs) {

                $this->chargerModele('AnnuaireModele');
                $resultat = $this->AnnuaireModele->ajouterDansAnnuaireMappe($id_annuaire, $valeurs_mappees, $noms_champs);

                return $resultat;
        }

        /**
         * Affiche la fiche principale d'un utilisateur
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @param int $id_utilisateur l'identifiant de l'utilisateur
         * @return string la vue contenant la fiche utilisateur
         */
        public function afficherFicheUtilisateur($id_annuaire, $id_utilisateur) {

                $this->chargerModele('AnnuaireModele');
                $tableau_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                $tableau_valeurs = $this->AnnuaireModele->obtenirValeursUtilisateur($id_annuaire, $id_utilisateur,$tableau_mappage[0]);

                $this->chargerModele('MetadonneeModele');
                $champs_metadonnees['champs'] = $this->MetadonneeModele->chargerListeValeursMetadonneesUtilisateur($id_annuaire, $id_utilisateur);

                $this->chargerVue('annuaire_tela_inscrits_fiche',$champs_metadonnees);

                //echo '<pre>'.print_r($champs_metadonnees,true).'</pre>';

                return $this->annuaire_tela_inscrits_fiche;
        }

        /**
         * En cas de tentative d'inscription, envoie un mail contenant un lien de confirmation à l'utilisateur
         * @param string $adresse_mail adresse mail
         * @param string $nom nom
         * @param string $prenom prénom
         * @param string $code_confirmation_inscription code de confirmation à inclure dans le mail
         *
         * @return boolean le succès ou l'échec de l'envoi du mail
         */
        public function envoyerMailConfirmationInscription($adresse_mail, $nom, $prenom, $code_confirmation_inscription) {

                $base_url = clone(Registre::getInstance()->get('base_url_application'));

                $base_url->setVariableRequete('m','annuaire_inscription_confirmation');
                $base_url->setVariableRequete('id',$code_confirmation_inscription);

                $donnees = array('nom' => $nom, 'prenom' => $prenom, 'lien_confirmation_inscription' => $base_url->getURL());
                $contenu_mail = $this->getVue('mail_confirmation_inscription',$donnees);

                return mail($adresse_mail,'Inscription au site Tela Botanica',$contenu_mail);

        }

        /**
         * Insère les données dans la table d'inscription temporaire et crée un code de confirmation (à insérer dans le mail)
         * @param Array $valeurs les valeurs à insérer
         */
        private function InsererDansTableTemporaireEtcreerCodeConfirmationInscription($valeurs) {
                // Le code de confirmation est constitué des 8 premiers caractères de l'identifiant de session
                $code_confirmation = substr(session_id(), 0, 8) ;

                $this->chargerModele('AnnuaireModele');

                if(!$this->AnnuaireModele->ajouterNouvelleInscriptionTemporaire($code_confirmation, $valeurs)) {
                        return false;
                }

                return $code_confirmation;
        }

        /**
         * Renvoie les champs de mappage correspondant à un annuaire donné
         * @param int $id_annuaire l'indentifant de l'annuaire pour lequel on veut ces informations
         * @return Array un tableau de mappage des champs
         *
         */
        private function obtenirChampsMappageAnnuaire($id_annuaire) {

                $tableau_mappage = array();

                $tableau_mappage[0]['champ_id'] = 'U_ID';
                $tableau_mappage[0]['champ_mail'] = 'U_MAIL';
                $tableau_mappage[0]['champ_nom'] = 'U_NAME';
                $tableau_mappage[0]['champ_prenom'] = 'U_SURNAME';
                $tableau_mappage[0]['champ_pass'] = 'U_PASSWD';

                //$tableau_mappage[1]['champ_id'] = 'U_ID';
                $tableau_mappage[1]['champ_mail'] = '16';
                $tableau_mappage[1]['champ_nom'] = '1';
                $tableau_mappage[1]['champ_prenom'] = '7';
                $tableau_mappage[1]['champ_pass'] = '11';

                // TODO: voir comment stocker les correspondances de mappage
                return $tableau_mappage;
        }

        // TODO: utiliser les fonction de mappage définies plus haut
        /**
         * Vérifie que les valeurs pour des champs de mappage d'un annuaire donné
         * sont correctes
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @param Array $valeurs les valeurs à vérifier
         */
        private function verifierErreursChamps($id_annuaire, $valeurs, $tableau_mappage) {

                $erreurs = false;

                $champ_mail = '16';
                $champ_prenom = '7';
                $champ_nom = '1';
                $champ_pass = '11';

                if(!$this->mailValide($valeurs[$tableau_mappage[0]['champ_mail']])) {
                        $erreurs['text_'.$tableau_mappage[1]['champ_mail']] = 'mail invalide';
                }

                if(trim($valeurs['pass_'.$tableau_mappage[0]['champ_mail']]) != ''
                || trim($valeurs['pass_conf'.$tableau_mappage[1]['champ_mail']]) != '') {

                        if($valeurs['pass_'.$champ_pass] =! $valeurs['pass_conf_'.$champ_pass]) {
                                $erreurs['pass_'.$tableau_mappage[1]['champ_mail']] = 'mot de passe invalide';
                        }

                }

                if(trim($valeurs['text_'.$tableau_mappage[0]['champ_mail']]) == '') {
                        $erreurs['text_'.$tableau_mappage[1]['champ_mail']] = 'le nom est obligatoire';
                }

                if(trim($valeurs['text_'.$tableau_mappage[0]['champ_mail']]) == '') {
                        $erreurs['text_'.$tableau_mappage[1]['champ_mail']] = 'le prénom est obligatoire';
                }

                return $erreurs;
        }

        /**
         * Renvoie vrai ou faux suivant qu'un mail donné en paramètre est syntaxiquement valide (ne vérifie pas l'existence
         * de l'adresse)
         * @param string $mail le mail à tester
         * @return boolean vrai ou faux suivant que le mail est valide ou non
         */
        private function mailValide($mail) {

                $regexp_mail = '^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+)*(\.[a-z]{2,3})$';
                return eregi($regexp_mail, $mail);

        }
}
?>