Subversion Repositories Applications.annuaire

<?
/**
* 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/
*/

/**
 * 
 * Classe mère des controleurs de l'application, abstraite, elle contient
 * les fonctions utiles à tous les controleurs
 * @author aurelien
 *
 */
abstract class AppControleur 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) {

                // ajout de l'url de l'appli
                $donnees['base_url'] = new Url(Config::get('base_url_application'));
                
                $donnees['base_url_styles'] = $this->getUrlBase();
                
                $donnees['url_cette_page'] = $this->getUrlCettePage() ;
                
                $donnees['base_url_application'] = $this->getUrlBaseComplete();
                
                $this->chargerModele('AnnuaireModele');

                //ajout des variables d'identification
                $donnees['est_admin'] = Registre::getInstance()->get('est_admin');
                $donnees['identification_id'] = Registre::getInstance()->get('identification_id');
                $donnees['identification_mail'] = Registre::getInstance()->get('identification_mail');
                                
                $format = Config::get('date_format_simple');
                
                if($format) {
                        $donnees['format_date_simple'] = $format;
                } else {
                        $donnees['format_date_simple'] = 'd/m/Y';
                }

                return $donnees;
        }
                
        public function getUrlBase() {
                
                $base_vrai_chemin = str_replace(realpath($_SERVER['DOCUMENT_ROOT']),'',realpath(Application::getChemin()));
                $base_vrai_chemin .= '/';
                
                return new Url($base_vrai_chemin);
        }
        
        public function getUrlBaseComplete() {
                return new Url('http://'.$_SERVER['SERVER_NAME'].str_replace(realpath($_SERVER['DOCUMENT_ROOT']),'',realpath(Application::getChemin())));
        }
        
        public function getUrlCettePage() {
                return $_SERVER['SERVER_NAME'].$_SERVER['REQUEST_URI'];
        }
        
        /**
         * Renvoie le template de pagination, considérant des éléments donnés en paramètre
         * @param int $numero_page le numéro de page en cours
         * @param int $taille_page la taille de page
         * @param int $total le nombre total de pages
         * @param object $url_base l'url de base de la page
         * @param array $valeurs les valeurs à concatener à l'url
         * @return string le html contenu la template de pagination rempli avec les infos
         */
        protected function paginer($numero_page = 1, $taille_page = 50, $total, $url_base, $valeurs) {

                // TODO, faire plus complexe, tri alphabétique etc...
                $page_precedente = $numero_page-1;
                $page_suivante = $numero_page+1;

                if($taille_page <= 0) {
                        $taille_page = 1;
                }

                $nombre_pages = ceil($total/$taille_page) ;

                foreach($valeurs as $cle => $variable) {
                        $url_base->setVariableRequete($cle,$variable);
                }

                if($numero_page < 2) {
                        $page_precedente = false;
                        $url_page_precedente = '';
                } else {
                        $url_page_prec = clone($url_base);
                                $url_page_prec->setVariableRequete('numero_page',($page_precedente));
                                $url_page_prec->setVariableRequete('taille_page',($taille_page));
                                $url_page_precedente = $url_page_prec->getUrl();
                }

                if($taille_page*($numero_page) >= $total) {
                        $page_suivante = false;
                        $url_page_suivante = '';
                } else {
                        $url_page_suiv = clone($url_base);
                                $url_page_suiv->setVariableRequete('numero_page',($page_suivante));
                                $url_page_suiv->setVariableRequete('taille_page',($taille_page));
                                $url_page_suivante = $url_page_suiv->getUrl();
                }

                $url_pages = array();

                for($i = 1; $i <= $nombre_pages ; $i++) {

                                $url_page_prev = clone($url_base);
                                $url_page_prev->setVariableRequete('numero_page',($i));
                                $url_page_prev->setVariableRequete('taille_page',($taille_page));
                                $url_pages[$i] = $url_page_prev->getUrl();
                }

                $donnees = array('url_pages' => $url_pages, 'numero_page' => $numero_page,
                                                        'page_precedente' => $page_precedente, 'page_suivante' => $page_suivante,
                                                        'url_page_precedente' => $url_page_precedente, 'url_page_suivante' => $url_page_suivante,
                                                        'nombre_pages' => $nombre_pages, 'taille_page' => $taille_page);
                $donnees['base_url_pagination'] = $url_base;

                return $this->getVue(Config::get('dossier_squelettes_elements').'pagination',$donnees);
        }

        
        public function obtenirIdParMail($id_annuaire, $mail_utilisateur) {
                
                $this->chargerModele('AnnuaireModele');
                $id = $this->AnnuaireModele->obtenirIdParMail($id_annuaire, $mail_utilisateur);
                
                return $id;
        }
        
        public function utilisateurExiste($id_annuaire,$id, $utilise_mail = true) {

                $this->chargerModele('AnnuaireModele');

                if($utilise_mail) {
                        $existe = $this->AnnuaireModele->utilisateurExisteParMail($id_annuaire,$id);
                } else {
                        $existe = $this->AnnuaireModele->utilisateurExisteParId($id_annuaire,$id);
                }

                return $existe;
        }


/** ---------------------------------    Fonction d'extraction des champs de mappage -------------------------------------------*/      
        
        /**
         * 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
         *
         */
        protected function obtenirChampsMappageAnnuaire($id_annuaire) {

                $this->chargerModele('AnnuaireModele');
                $tableau_mappage = $this->AnnuaireModele->obtenirChampsMappageAnnuaire($id_annuaire);

                return $tableau_mappage;
        }
        
        protected function obtenirNomsChampsMappageAnnuaire($id_annuaire) {

                $this->chargerModele('AnnuaireModele');
                $tableau_mappage = $this->AnnuaireModele->obtenirChampsMappageAnnuaire($id_annuaire);
                
                $this->chargerModele('MetadonneeModele');
                $metadonnees = $this->MetadonneeModele->chargerListeMetadonneeAnnuaire($id_annuaire);
                
                $tableau_nom_champs = array();
                
                foreach($metadonnees as $id_champ => $valeur) {

                        // Si le champ fait partie des champs mappés
                        $cle_champ_mappage = array_search($id_champ, $tableau_mappage[1]);
                        
                        if($cle_champ_mappage) {
                                $tableau_nom_champs[$cle_champ_mappage] = $valeur['amc_abreviation'];
                        }
                }

                return $tableau_nom_champs;
        }
        
        
        

/** ---------------------------------    Fonction d'affichage des champs de metadonnées -------------------------------------------*/  
        
        /**
         * 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) {

                // 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;

                if(isset($donnees['amc_ce_template_affichage'])) {
                        $nom_type_champ = $donnees['amc_ce_template_affichage'];
                } else {
                        $this->chargerModele('MetadonneeModele');
                        $nom_type_champ = $this->MetadonneeModele->renvoyerTypeAffichageParId($donnees['amc_ce_type_affichage']);
                }

                return $this->getVue(Config::get('dossier_squelettes_champs').$nom_type_champ,$donnees);
        }
        
        
/** ---------------------------------    Fonction d'existence et de génération des formulaires -------------------------------------------*/
        
        /**
         * Renvoie le formulaire demandé s'il existe, sinon faux
         * @param string $nom_formulaire le nom du formulaire demandé (qui est normalement le code d'un annuaire)
         * @return boolean true si le formulaire existe, false sinon
         */
        protected function formulaireExiste($nom_formulaire) {

                return $this->templateExiste($nom_formulaire.'_inscription', Config::get('dossier_squelettes_formulaires'));
        }

        /**
         * Renvoie le template demandé s'il existe, sinon faux
         * @param string $nom_formulaire le nom du formulaire demandé (qui est normalement le code d'un annuaire)
         * @param string $dossier le nom du dossier sous dossier demandé
         * @return boolean true si le formulaire existe, false sinon
         */
        protected function templateExiste($nom_template, $dossier = '/') {
                
                return file_exists(Config::get('chemin_squelettes').$dossier.$nom_template.'.tpl.html');
        }
        
        
        /**
         * Renvoie une fiche utilisateur minimale auto-générée
         * @param string $donnees les données à inclure dans le formulaire
         * @return string la vue contenant le formulaire généré
         */
        protected function genererFicheInscrit($donnees) {

                $formulaire_modele = $this->getVue(Config::get('dossier_squelettes_fiches').'fiche',$donnees);

                if($formulaire_modele) {
                        return $formulaire_modele;
                } else {
                        trigger_error("impossible de trouver le squelette de référence pour le formulaire");
                }

                return false;
        }

        /**
         * Renvoie un formulaire d'inscription minimal auto-généré
         * @param string $donnees les donnée à inclure dans le formulaire
         * @return string la vue contenant le formulaire généré
         */
        protected function genererFormulaireInscription($donnees) {

                $formulaire_modele = $this->getVue(Config::get('dossier_squelettes_formulaires').'inscription',$donnees);

                if($formulaire_modele) {
                        return $formulaire_modele;
                } else {
                        trigger_error("impossible de trouver le squelette de référence pour le formulaire");
                }

                return false;
        }
        
        /**
         * Renvoie un formulaire d'inscription minimal auto-généré
         * @param string $donnees les donnée à inclure dans le formulaire
         * @return string la vue contenant le formulaire généré
         */
        protected function genererFormulaireModificationInscription($donnees) {

                $formulaire_modele = $this->getVue(Config::get('dossier_squelettes_formulaires').'modification',$donnees);

                if($formulaire_modele) {
                        return $formulaire_modele;
                } else {
                        trigger_error("impossible de trouver le squelette de référence pour le formulaire");
                }

                return false;
        }

        /**
         * Renvoie un formulaire d'inscription minimal auto-généré
         * @param string $donnees les donnée à inclure dans le formulaire
         * @return string la vue contenant le formulaire généré
         */
        protected function genererFormulaireRecherche($donnees) {

                $formulaire_modele = $this->getVue(Config::get('dossier_squelettes_formulaires').'recherche',$donnees);

                if($formulaire_modele) {
                        return $formulaire_modele;
                } else {
                        trigger_error("impossible de trouver le squelette de référence pour le formulaire");
                }

                return false;
        }
        
/** ---------------------------------    Fonction d'extraction d'informations utilisées entre autres par les web services -------------------------------------------*/

        public function obtenirValeursUtilisateur($id_annuaire, $id_utilisateur) {
                
                $this->chargerModele('AnnuaireModele');
                $annuaire = $this->AnnuaireModele->chargerAnnuaire($id_annuaire, false);

                $this->chargerModele('MetadonneeModele');

                $metadonnees = $this->MetadonneeModele->chargerListeMetadonneeAnnuaire($id_annuaire);
                $tableau_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

                $valeurs_annuaire = $this->AnnuaireModele->obtenirValeursUtilisateur($id_annuaire, $id_utilisateur,$tableau_mappage[0]);
                $valeurs_metadonnees= $this->MetadonneeModele->chargerListeValeursMetadonneesUtilisateur($id_annuaire, $id_utilisateur);
                
                foreach($tableau_mappage[0] as $cle => $nom_champ) {

                        if($cle != 'champ_id') {

                                $nom_champ_formulaire = $metadonnees[$tableau_mappage[1][$cle]]['amc_abreviation'];
                                $valeur = $valeurs_annuaire[$nom_champ] ;
                                
                                if(isset($valeurs_metadonnees[$nom_champ_formulaire])) {
                                        if(isset($valeurs_metadonnees[$nom_champ_formulaire]['amv_valeur']) && $valeurs_metadonnees[$nom_champ_formulaire]['amv_valeur'] != '') {
                                                $valeur = $valeurs_metadonnees[$nom_champ_formulaire]['amv_valeur'];
                                        } 
                                        $informations_champ = array('amv_valeur' => $valeur,'amc_id_champ' => $tableau_mappage[1][$cle]) ;
                                        $valeurs_metadonnees[$nom_champ_formulaire] = array_merge($valeurs_metadonnees[$nom_champ_formulaire],$informations_champ);
                                } else {
                                        $informations_champ = array('amv_valeur' => $valeur,'amc_id_champ' => $tableau_mappage[1][$cle]) ;
                                        $valeurs_metadonnees[$nom_champ_formulaire] = $informations_champ;
                                }
                        }
                }
                
                foreach($valeurs_metadonnees as $nom_champ => $valeur) {
                        $verificateur = new VerificationControleur();
                        $valeurs_metadonnees[$nom_champ] = $verificateur->verifierEtRemplacerValeurChampPourAffichage($valeur['amc_ce_type_affichage'],$valeur, 1);
                }
                
                return $valeurs_metadonnees;
        }
        
        public function obtenirInfosUtilisateurOpenId($id_annuaire,$id, $mail = true) {

                $this->chargerModele('AnnuaireModele');

                if($mail) {
                        $id = $this->AnnuaireModele->obtenirIdParMail($id_annuaire,$id);
                }

                $champs_mappage = $this->AnnuaireModele->obtenirChampsMappageAnnuaire($id_annuaire);

                $valeurs = $this->AnnuaireModele->obtenirValeursUtilisateur($id_annuaire,$id, $champs_mappage[0]);

                // TODO: valeurs incomplètes, voir ce qu'on renvoie obligatoirement
                // et ce qu'on ne renvoie pas
                $valeurs_open_id = array('fullname' => $valeurs[$champs_mappage[0]['champ_nom']].' '.$valeurs[$champs_mappage[0]['champ_prenom']],
                           'nickname' => $valeurs[$champs_mappage[0]['champ_nom']],
                           'dob' => '25/10/1984',
                           'email' => $valeurs[$champs_mappage[0]['champ_mail']],
                           'gender' => 'M',
                           'postcode' => $valeurs[$champs_mappage[0]['champ_code_postal']],
                           'country' => 'FR',
                           'language' => 'fr',
                           'timezone' => 'Europe/Paris');

                return $valeurs_open_id;
        }

        public function comparerIdentifiantMotDePasse($id_annuaire,$id_utilisateur,$mot_de_passe, $utilise_mail = true, $mdp_deja_crypte = true) {

                $this->chargerModele('AnnuaireModele');

                if($utilise_mail) {
                        $id_utilisateur = $this->AnnuaireModele->obtenirIdParMail($id_annuaire,$id_utilisateur);
                }

                if(!$mdp_deja_crypte) {
                        $mot_de_passe = VerificationControleur::encrypterMotDePasseStatic($mot_de_passe);
                }

                return $this->AnnuaireModele->comparerIdentifiantMotDePasse($id_annuaire,$id_utilisateur,$mot_de_passe);
        }
        
}