Subversion Repositories Applications.annuaire

<?php
// declare(encoding='UTF-8');
/**
 * Service retournant les prénoms et nom  d'un utilisateur en fonction de son courriel.
 * UNe liste de courriel peut être passé dans la ressource.
 * Exemple :
 * /utilisateur/Prenom-nom-par-courriel/jpm@tela-botanica.org,aurelien@tela-botanica.org
 *
 * @category    php 5.2
 * @package             Annuaire::Services
 * @author              Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @copyright   Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
 * @license             http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @license             http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 * @version             $Id$
 */
class Utilisateur extends JRestService {

        private $donnees = null;
        private $idAnnuaire = null;
        private $utilisateurId = null;
        private $metadonneeModele = null;
        private $annuaireModele = null;
        private $messagerieModele = null;

        const FORMAT_JSON = "json";
        const FORMAT_XML = "xml";
        const FORMAT_LDEHYDE = "méthanal"; // hihi hoho

        /*+----------------------------------------------------------------------------------------------------+*/
        // GET : consultation

        public function getElement($ressources){
                $this->ressources = $ressources;
                $this->idAnnuaire = Config::get('annuaire_defaut');
                $infos = null;

                if (isset($this->ressources[0])) {
                        if (preg_match('/^[0-9]+$/', $this->ressources[0])) {
                                // ATTENTION : Ces web services ne doivent être accessible que depuis des applis installées sur nos serveurs
                                // pour les communications inter-serveurs.
                                $this->controlerIpAutorisees();
                                $infos = $this->getInfosParId($this->ressources[0]);
                        } else {
                                $methode_demande = array_shift($this->ressources);
                                $methode = $this->traiterNomMethodeGet($methode_demande);
                                if (method_exists($this, $methode)) {
                                        $infos = $this->$methode();
                                } else {
                                        $this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete GET.";
                                }
                        }
                } else {
                        $this->messages[] = "Le premier paramètre du chemin du service doit correspondre au type de ressource demandée.";
                }

                // possibilité d'envoyer en plusieurs formats @TODO faire ça plus proprement
                $format = self::FORMAT_JSON;
                $dernierIndex = count($this->ressources) - 1;
                if ($dernierIndex >= 0) {
                        $dernierParametre = $this->ressources[$dernierIndex];
                        if (in_array($dernierParametre, array(self::FORMAT_JSON, self::FORMAT_XML))) {
                                $format = $dernierParametre;
                        }
                }

                if (!is_null($infos)) {
                        switch ($format) {
                                case self::FORMAT_XML :
                                        $this->envoyerXml($infos);
                                break;
                                case self::FORMAT_JSON :
                                default :
                                        $this->envoyerJson($infos);
                        }
                } else {
                        $info = 'Un problème est survenu : '.print_r($this->messages, true);
                        $this->envoyerTxt($info);
                }
        }

        /**
         * Permet d'obtenir des infos pour un id utilisateur indiqué dans la ressource.
         * RESSOURCE : /utilisateur/#id
         * PARAMÈTRES : aucun
         * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
         *  - id : identifiant numérique de l'utilisateur
         *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
         *  - pseudo : pseudo de l'utilisateur.
         *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
         *  - prenom : prénom
         *  - nom : nom de famille.
         *  - courriel : courriel
         */
        public function getInfosParId($id_utilisateur) {
                $infos = $this->getAnnuaire()->obtenirInfosUtilisateurParId($this->idAnnuaire, $id_utilisateur);

                $infos['pseudoUtilise'] = $this->obtenirPseudoUtilise($id_utilisateur);
                $infos['pseudo'] = $this->obtenirPseudo($id_utilisateur);
                $infos['intitule'] = $this->formaterIntitule($infos);

                return $infos;
        }

        /**
         * Permet d'obtenir les prénoms et noms des courriels des utilisateurs indiqués dans la ressource.
         * RESSOURCE : /utilisateur/prenom-nom-par-courriel/[courriel,courriel,...]
         * PARAMÈTRES : aucun
         * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
         *  - id : identifiant numérique de l'utilisateur
         *  - prenom : prénom
         *  - nom : nom de famille.
         */
        public function getPrenomNomParCourriel() {
                $courriels = explode(',', $this->ressources[0]);
                $infos = $this->getAnnuaire()->obtenirPrenomNomParCourriel($this->idAnnuaire, $courriels);
                return $infos;
        }

        /**
         * Permet d'obtenir les identités des utilisateurs indiqués dans la ressource.
         * RESSOURCE : /utilisateur/identite-par-courriel/[courriel,courriel,...]
         * PARAMÈTRES : aucun
         * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
         *  - id : identifiant numérique de l'utilisateur
         *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
         *  - pseudo : pseudo de l'utilisateur.
         *  - prenom : prénom
         *  - nom : nom de famille.
         */
        public function getIdentiteParCourriel() {
                $infos_utilisateurs = array();
                $utilisateurs = $this->getPrenomNomParCourriel();
                foreach ($utilisateurs as $courriel => $utilisateur) {
                        $id = $utilisateur['id'];
                        $utilisateur['pseudo'] = $this->obtenirPseudo($id);
                        $utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
                        $utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
                        $courriel = strtolower($courriel);
                        $infos_utilisateurs[$courriel] = $utilisateur;
                }
                return $infos_utilisateurs;
        }

        /**
         * Même principe que getIdentiteParCourriel() mais pour un seul courriel, et renvoie plus d'infos :
         * RESSOURCE : /utilisateur/identite-complete-par-courriel/courriel[/format]
         * PARAMÈTRES : format : "json" (par défaut) ou "xml" (pour
         *   rétrocompatibilité avec le service eFlore_chatin/annuaire_tela/xxx/courriel) 
         * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
         * - id : identifiant numérique de l'utilisateur
         * - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
         * - pseudo : pseudo de l'utilisateur.
         * - prenom : prénom
         * - nom : nom de famille.
         * - mot_de_passe : le mot de passe haché (15% de matières grasses, peut contenir des traces de soja)
         * - fonction
         * - titre
         * - site_web
         * - adresse01
         * - adresse02
         * - code_postal
         * - ville
         * - departement
         * - region
         * - pays
         * - date_inscription
         */
        public function getIdentiteCompleteParCourriel() {

                $this->authentificationHttpSimple();

                $infos_utilisateurs = array();
                $courriel = $this->ressources[0];
                $utilisateur = $this->getAnnuaire()->obtenirMaximumInfosParCourriel($this->idAnnuaire, $courriel);

                $id = $utilisateur['id'];
                $utilisateur['pseudo'] = $this->obtenirPseudo($id);
                $utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
                $utilisateur['intitule'] = $this->formaterIntitule($utilisateur);

                // ouksépabo
                $this->baliseMaitresse = "personne";

                return $utilisateur;
        }

        private function getAnnuaire() {
                if (!isset($this->annuaireModele)) {
                        $this->annuaireModele = new AnnuaireModele();
                }
                return $this->annuaireModele;
        }

        private function getMeta() {
                if (!isset($this->metadonneeModele)) {
                        $this->metadonneeModele = new MetadonneeModele();
                }
                return $this->metadonneeModele;
        }

        private function obtenirPseudo($id_utilisateur) {
                $pseudo = '';
                $id_champ_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'pseudo');
                if ($this->getMeta()->valeurExiste($id_champ_pseudo, $id_utilisateur)) {
                        $pseudo = $this->getMeta()->obtenirValeurMetadonnee($id_champ_pseudo, $id_utilisateur);
                }
                return $pseudo;
        }

        private function obtenirPseudoUtilise($id_utilisateur) {
                $pseudo_utilise = false;
                $id_champ_utilise_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'utilise_pseudo');
                if ($this->getMeta()->valeurExiste($id_champ_utilise_pseudo, $id_utilisateur)) {
                                $booleen = $this->getMeta()->obtenirValeurMetadonnee($id_champ_utilise_pseudo, $id_utilisateur);
                                $pseudo_utilise = ($booleen == 0) ? false : true;
                }
                return $pseudo_utilise;
        }

        private function formaterIntitule($utilisateur) {
                $intitule = '';
                if ($utilisateur['pseudoUtilise'] && trim($utilisateur['pseudo']) != '') {
                        $intitule = $utilisateur['pseudo'];
                } else {
                        $intitule = $utilisateur['prenom'].' '.$utilisateur['nom'];
                }
                return $intitule;
        }

        /*+----------------------------------------------------------------------------------------------------+*/
        // POST : mise à jour

        public function updateElement($ressources, $donnees) {
                $this->ressources = $ressources;
                $this->donnees = $donnees;
                $this->idAnnuaire = Config::get('annuaire_defaut');

                $infos = null;
                if (isset($this->ressources[0])) {
                        $this->utilisateurId = array_shift($this->ressources);
                        if (isset($this->ressources[0])) {
                                $methode_demande = array_shift($this->ressources);
                                $methode = $this->traiterNomMethodePost($methode_demande);
                                if (method_exists($this, $methode)) {
                                        $infos = $this->$methode();
                                } else {
                                        $this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete POST.";
                                }
                        } else {
                                $this->messages[] = "La seconde ressource du service pour les requêtes POST doit correspondre au type de ressource demandée.";
                        }
                } else {
                        $this->messages[] = "La première ressource du service pour les requêtes POST doit être l'identifiant de l'utilisateur.";
                }

                if (!is_null($infos)) {
                        $this->envoyerJson($infos);
                } else {
                        $info = 'Un problème est survenu : '.print_r($this->messages, true);
                        $this->envoyerTxt($info);
                }
        }

        /**
         * Permet d'envoyer un message à un utilisateur.
         * RESSOURCE : /utilisateur/[id]/message
         * POST :
         *  - sujet : contient le sujet du message à envoyer.
         *  - message : contient le contenu du message à envoyer.
         *  - message_txt : (optionnel) si format HTML, peut contenir le contenu du message au format texte comme alternative au HTML à envoyer.
         *              Sinon le texte est extrait du HTML (attention à la mise en page!).
         *  - utilisateur_courriel : contient le courriel de l'utilisateur qui envoie le message (Il doit être
         *              inscrit dans l'annuaire par défaut de Tela Botanica).
         *  - copies : peut contenir une liste de courriels séparés par des virguels auxquels une copie du
         *              message sera envoyée.
         *  - format (optionnel) : text ou html
         * RÉPONSE :
         *  - message : contient le message d'information concernant l'envoie.
         */
        private function updateMessage() {
                $destinataireId = $this->utilisateurId;//$this->donnees['destinataire_id'];
                $sujet = stripslashes($this->donnees['sujet']);
                $contenu = stripslashes($this->donnees['message']);
                $contenuTxt = (isset($this->donnees['message_txt'])) ? $this->donnees['message_txt'] : null;
                $envoyeur = $this->donnees['utilisateur_courriel'];
                $adresse_reponse = (isset($this->donnees['reponse_courriel']) ? $this->donnees['reponse_courriel'] : $this->donnees['utilisateur_courriel']);
                $copies = array_key_exists('copies', $this->donnees) ? explode(',', $this->donnees['copies']) : null;
                $format = isset($this->donnees['format']) ? $this->donnees['format'] : 'text';

                $info = null;
                if ($this->estAutoriseMessagerie($envoyeur) || $this->getAnnuaire()->utilisateurExisteParMail($this->idAnnuaire, $envoyeur)) {
                        // il est possible de passer directement un email ou bien un id utilisateur
                        if(filter_var($destinataireId, FILTER_VALIDATE_EMAIL)) {
                                $destinataire = $destinataireId;
                        } else {
                                $destinataire = $this->getAnnuaire()->obtenirMailParId($this->idAnnuaire, $destinataireId);
                        }
                        if ($destinataire) {
                                if ($format == 'html') {
                                        if (isset($contenuTxt)) {
                                                $envoie = $this->getMessagerie()
                                                        ->envoyerMail($envoyeur, $destinataire, $sujet, $contenu, $contenuTxt, $adresse_reponse);
                                        } else {
                                                $envoie = $this->getMessagerie()
                                                        ->envoyerMail($envoyeur, $destinataire, $sujet, $contenu, '', $adresse_reponse);
                                        }
                                } else {
                                        $envoie = $this->getMessagerie()->envoyerMailText($envoyeur, $destinataire, $sujet, $contenu, '', $adresse_reponse);
                                }
                                if ($envoie) {
                                        $info['message'] = "Votre message a bien été envoyé.";
                                        foreach ($copies as $copie) {
                                                $sujet = '[COPIE] '.$sujet;
                                                $contenu = "Message original envoyé par $envoyeur pour $destinataire.\n--\n".$contenu;
                                                $this->getMessagerie()->envoyerMailText($envoyeur, $copie, $sujet, $contenu, '', $adresse_reponse);
                                        }
                                } else {
                                        $info['message'] = "Le message n'a pas pu être envoyé.";
                                }
                        } else {
                                $info['message'] = "Aucun courriel ne correspond à l'id du destinataire.";
                        }
                } else {
                        $info['message'] = "Vous n'êtes pas inscrit à Tela Botanica avec le courriel : $envoyeur.\n".
                                "Veuillez saisir votre courriel d'inscription ou vous inscrire à Tela Botanica.";
                }
                return $info;
        }

        private function getMessagerie() {
                if (!isset($this->messagerieModele)) {
                        $this->messagerieModele = new MessageControleur();
                }
                return $this->messagerieModele;
        }

        /*+----------------------------------------------------------------------------------------------------+*/
        // PUT : ajout

        public function createElement($donnees) {
                $this->donnees = $donnees;
                $this->idAnnuaire = Config::get('annuaire_defaut');

                $infos = null;
                if (isset($this->donnees['methode'])) {
                        $methode_demande = $this->donnees['methode'];
                        $methode = $this->traiterNomMethodePut($methode_demande);
                        if (method_exists($this, $methode)) {
                                $infos = $this->$methode();
                        } else {
                                $this->messages[] = "Ce type de méthode '$methode_demande' n'est pas disponible pour la requete PUT.";
                        }
                } else {
                        $this->messages[] = "Ce service n'est pas implémanté.";
                }

                if (!is_null($infos)) {
                        $this->envoyerJson($infos);
                } else {
                        $info = 'Un problème est survenu : '.print_r($this->messages, true);
                        $this->envoyerTxt($info);
                }
        }

        /**
         * Permet d'identifier un utilisateur.
         * RESSOURCE : /utilisateur
         * POST :
         *  - methode = 'connexion' : methode doit valoir 'connexion' pour connecter l'utilisateur.
         *  - courriel : contient le courriel de l'utilisateur .
         *  - mdp : le mot de passe de l'utilisateur.
         *  - persistance : true si on veut laisser l'utilisateur connecté au delà de la session sinon false
         * RÉPONSE :
         *  - identifie : indiquer si l'utilisateur a été identifié (true) ou pas (false)
         *  - message : contient un message d'information complémentaire de l'état.
         */
        private function createConnexion() {
                $courriel = stripslashes($this->donnees['courriel']);
                $mdp = stripslashes($this->donnees['mdp']);
                $persistance = (stripslashes($this->donnees['persistance']) == 'true') ? true : false;

                $infos = null;
                $infos['persistance'] = $persistance;
                if ($this->verifierAcces($courriel, $mdp)) {
                        $infos['identifie'] = true;
                        $infos['message'] = "Bienvenu.";
                        $dureeCookie = 0;
                        if ($persistance === true) {
                                $dureeCookie = time()+3600*24*30;
                                $this->creerCookiePersistant($dureeCookie, $courriel, $mdp);
                        }
                        $this->creerCookieUtilisateur($dureeCookie, $courriel);
                        $infos['message'] = $_COOKIE;
                } else {
                        $infos['identifie'] = false;
                        $infos['message'] = "Le courriel ou le mot de passe saisi est incorrect.";
                }
                return $infos;
        }
}
?>