Subversion Repositories eFlore/Applications.del

<?php
/**
 * Service fournissant des informations concernant les votes sur les images de DEL en fonction d'un protocole 
 * au format RSS1, RSS2 ou ATOM.
 * Encodage en entrée : utf8
 * Encodage en sortie : utf8
 * 
 * @author Grégoire DUCHE <gregoire@tela-botanica.org>
 * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 * @version $Id$
 * @copyright 2010
 */
class SyndicationVotesParProtocole {
        
        
        /**
         * Paramètres du service
         * */
        private $ressources = null;
        private $parametres = null;
        private $format = null;
        private $service = null;
        private $squelette = null;
        private $squelette_dossier = null;
        private $masque = array();
        private $mappingFiltre = array();
        private $conteneur = null;
        private $gestionBdd = null;
        private $navigation = null;
        private $type_rss = null;
        
        /**
         * Constructeur
         * Initialiser les configurations
         * */
        public function __construct(Conteneur $conteneur = null) {
                $this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
                $this->conteneur->chargerConfiguration('config_syndication_votesparprotocole.ini');
                $this->mappingFiltre = $this->conteneur->getParametre('mapping_masque');
                $this->masque = $conteneur->getMasque();
                $this->gestionBdd = $conteneur->getGestionBdd();
                $this->navigation = $conteneur->getNavigation();
        }
        
        /**
         * Consulter 
         * Méthode par défaut pour récupérer l'ensemble des votes.
         * Vérifie la configuration et retourne les derniers votes formatés
         * */
        public function consulter($params = array()) {
                $this->verifierConfiguration();
                $this->type_rss = $params[1];
                if ($this->fluxAdminDemande()) {
                        $this->demanderAutorisationAdmin();
                } 
                
                $donnees_brutes = $this->getDerniersVotesImage();
                $commentaires_formates = $this->formaterPourRss($donnees_brutes) ; 
                return $commentaires_formates;
        }
        
        /**
        * Vérifier que le service est bien configuré
        * */
        public function verifierConfiguration() {
        
                $erreurs = array();
                $tableauImages = $this->conteneur->getParametre('mapping_masque');
        
                if (empty($this->mappingFiltre)) {
                        $erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_masque] ou celui-ci est vide ;';
                } else {
                        $champsMappingFiltre = array('image', 'protocole');
                        foreach ($champsMappingFiltre as $champ) {
                                if (!isset($this->mappingFiltre[$champ])) {
                                        $erreurs[] = '- le mapping du champ "'.$champ.'" pour le commentaire est manquant ;';
                                }
                        }
                }
        
                if (!empty($erreurs)) {
                        $e = 'Erreur lors de la configuration : '."\n";
                        $e .= implode("\n", $erreurs);
                        throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
                }
        }
        
        /**
         * Verifier si le flux admin est demandé
         */
        private function fluxAdminDemande() {
                return $this->conteneur->getParametre('admin') != null && $this->conteneur->getParametre('admin') == 1; 
        }
        
        /**
         * Si le flux est un flux admin, demander un mot de passe
         * */
        private function demanderAutorisationAdmin() {
                $verification = new ControleAcces($this->conteneur);
                $verification->demanderAuthentificationAdmin();
        }
        
        
        /**
         * Retrouver les derniers votes image
         * */
        private function getDerniersVotesImage() {
                
                $requete =  'SELECT DISTINCT id_vote, duo.prenom AS observateur_prenom, duo.nom AS observateur_nom, du.prenom AS utilisateur_prenom, du.nom AS utilisateur_nom, nom_sel, intitule, ce_image,  valeur, dob.id_observation as del_obs, divo.date as date_vote '.
                                        ' FROM `del_image_vote` divo '.
                                        ' LEFT JOIN del_utilisateur AS du ON divo.ce_utilisateur = du.id_utilisateur '.
                                        ' INNER JOIN del_obs_image doi ON divo.ce_image = doi.id_image '.
                                        ' INNER JOIN del_observation dob ON dob.id_observation = doi.id_observation '.
                                        ' INNER JOIN del_image_protocole ON ce_protocole = id_protocole '.
                                        ' INNER JOIN del_utilisateur AS duo ON dob.ce_utilisateur = duo.id_utilisateur '.
                                        $this->chargerClauseWhere()." ".
                                        ' ORDER BY divo.date DESC '.
                                        ' LIMIT '.$this->navigation->getDepart().','.$this->navigation->getLimite();
                $elements = $this->gestionBdd->getBdd()->recupererTous($requete);
                return $elements;
        }
        
        
        /**
         * Formater les données pour mettre en page le RSS
         * */
        private function formaterPourRss($elements) {
                $donnees = $this->construireDonneesCommunesAuFlux($elements);
                foreach ($elements as $element) {
                        $identifiants[$element['id_vote']] = $element['id_vote'];
                }
                foreach ($elements as $element) {
                        $donnees['items'][] = $this->construireDonneesCommunesAuxItems($element);
                }
                return $donnees;
        }
                
        /**
         * Générer les métadonnées du flux (titre, dates, editeur etc.)
         * */
        private function construireDonneesCommunesAuFlux($infos) {
                $donnees = array();
                $donnees['guid'] = '';
                $donnees['titre'] = 'Derniers votes sur les images de l\'application PictoFlora';
                $donnees['description'] = 'Ce flux regroupe les derniers votes sur les images de Pictoflora';
                $donnees['lien_service'] = $this->creerUrlService();
                $donnees['lien_del'] = $this->conteneur->getParametre('pictoAppliLien');
                $donnees['editeur'] = $this->conteneur->getParametre('editeur');
                $derniere_info_en_date = reset($infos);
                $date_modification_timestamp = strtotime($derniere_info_en_date['date_vote']);
                $donnees['date_maj_RSS'] = date(DATE_RSS, $date_modification_timestamp);
                $donnees['date_maj_ATOM'] = date(DATE_ATOM, $date_modification_timestamp);
                $donnees['date_maj_W3C'] = date(DATE_W3C, $date_modification_timestamp);
                $donnees['annee_courante'] = date('Y');
                $donnees['generateur'] = 'DEL - SyndicationCommentaire';
                $donnees['generateur_version'] = (preg_match('/([0-9]+)/', '$Revision$', $match)) ?  $match[1] : '0';
                return $donnees; 
        }
        
        /**
         * Générer le lien du flux RSS
         * */
        private function creerUrlService() {
                $url_service = $this->conteneur->getParametre('url_service');
                $url_service .= '/'.$this->type_rss;
                //$url_service = '';
                if (count($_GET) > 0) {
                        $parametres_get = array();
                        foreach ($_GET as $cle => $valeur) {
                                $parametres_get[] = $cle.'='.$valeur;
                        }
                        $url_service .= '?'.implode('&amp;', $parametres_get);
                }
                return $url_service;
        }
        
        /**
         * Générer les données communes & spécifiques à chaque item
         * */
        private function construireDonneesCommunesAuxItems($info) {
                $item = array();
                $date_modification_timestamp = strtotime($info['date_vote']);
                $item['date_maj_simple'] = strftime('%A %d %B %Y à %H:%M', $date_modification_timestamp);
                $item['date_maj_RSS'] = date(DATE_RSS, $date_modification_timestamp);
                $item['date_maj_ATOM'] = date(DATE_ATOM, $date_modification_timestamp);
                $item['date_maj_W3C'] = date(DATE_W3C, $date_modification_timestamp);
                $item['titre'] = $this->creerTitre($info);
                $item['guid'] = $this->creerGuidItem($info);
                $item['lien'] = $this->creerLienItem($info);
                $item['categorie'] = $this->creerCategorie($item);
                $item['description'] = $this->creerDescription($info, $item);
                $item['description_encodee'] = htmlspecialchars($this->creerDescription($info, $item));
                $item['modifie_par'] = $this->creerAuteur($info);
                return $item;
        }
        
        
        private function creerCategorie($element) {
                $categorie = 'Vote protocole';
                $categorie = htmlentities($categorie);
                return $categorie;
        }
        
        private function creerGuidItem($element) {
                $guid = sprintf($this->conteneur->getParametre('voteParProtocole'), $element['id_vote']);
                return $guid;
        }

        private function creerLienItem($element) {
                $lien = sprintf($this->conteneur->getParametre('pictofloraFicheObsTpl'), $element['del_obs']);
                return $lien;
        }
        
        private function creerTitre($element) {
                $intitule = 'Vote';
                $utilisateur = array('prenom' => $element['utilisateur_prenom'], 'nom' => $element['utilisateur_nom']);
                $observateur = array('prenom' => $element['observateur_prenom'], 'nom' => $element['observateur_nom']);
                $titre = $intitule.' '.$element['valeur'].' - '.htmlspecialchars($this->creerAuteur($observateur)).' ('.htmlspecialchars($element['nom_sel']).', par '.htmlspecialchars($this->creerAuteur($utilisateur));
                return $titre;
        }
        
        private function creerDescription($donnees, $item) {
                $utilisateur = array('prenom' => $donnees['utilisateur_prenom'], 'nom' => $donnees['utilisateur_nom']);
                $utilisateurTxt = htmlspecialchars($this->creerAuteur($utilisateur));

                $observateur = array('prenom' => $donnees['observateur_prenom'], 'nom' => $donnees['observateur_nom']);
                $observateurTxt = htmlspecialchars($this->creerAuteur($observateur));
                
                $description = '<ul>'.
                        '<li>Image : '.htmlspecialchars($donnees['ce_image']).'</li>'.
                        '<li>Proposition : <em>'.htmlspecialchars($donnees['nom_sel']).'</em></li>'.
                        '<li>Protocole : '.htmlspecialchars($donnees['intitule']).'</li>'.
                        '<li>Valeur : '.$donnees['valeur'].'</li>'.
                        '<li>Auteur : '.$observateurTxt.'</li>'.
                        '<li>Votant : '.$utilisateurTxt.'</li>'.
                        '</ul>';
                return $description;
        }
        
        private function creerAuteur($info) {
                $intitule = '';
                if (isset($info['prenom']) && isset($info['nom'])) {
                        $intitule = $info['prenom'].' '.$info['nom'];
                }
                return $intitule;
        }
        
        
        
        /**
        * Charger la clause WHERE en fonction des paramètres de masque
        * */
        private function chargerClauseWhere() {
                $where = array();
                $tableauMasque = $this->masque->getMasque();
                if (!empty($tableauMasque)) {
                        foreach($tableauMasque as $idMasque => $valeurMasque) {
                                $idMasque = str_replace('masque.', '', $idMasque);
                                switch ($idMasque) {
                                        case 'image':
                                                $where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->gestionBdd->getBdd()->proteger($valeurMasque);                                                                                                             
                                        break;
                                        case 'protocole':
                                                $where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->gestionBdd->getBdd()->proteger($valeurMasque).' ';                                                                                                        
                                        break;
                                        default:
                                                $where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->gestionBdd->getBdd()->proteger($valeurMasque);
                                        break;
                                }
                        }       
                }
                if (!empty($where)) {
                        return ' WHERE '.implode('AND', $where);
                } else {
                        return;
                }
        }
        
        private function creerFiltreAuteur($valeurMasque) {
                $masque = '';
                $auteurId = $valeurMasque;
                if (is_numeric($auteurId)) {
                        $masque = ' dc.ce_utilisateur = '.$auteurId;
                } else {
                        if (strpos($auteurId, '@') === false) {
                                $tableauNomPrenom = explode(' ',$auteurId, 2);
                                if(count($tableauNomPrenom) == 2) {
                                        // on teste potentiellement un nom prenom ou bien un prénom nom
                                        $masque = '('.
                                                                        '(dc.utilisateur_nom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[0].'%').' AND '.
                                                                                'dc.utilisateur_prenom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[1].'%').') OR '.
                                                                                '(dc.utilisateur_nom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[1].'%').' AND '.
                                                                                'dc.utilisateur_prenom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[0].'%').')'.
                                                                          ')';
                                } else {
                                        $masque = '(
                                                                    (dc.utilisateur_nom LIKE '.$this->gestionBdd->getBdd()->proteger($auteurId.'%').' OR '.
                                                                                'dc.utilisateur_prenom LIKE '.$this->gestionBdd->getBdd()->proteger($auteurId.'%').')'.
                                                                          ')';
                                }
                        } else {
                                $masque = " dob.utilisateur_courriel LIKE ".$this->gestionBdd->getBdd()->proteger($valeurMasque.'%')." ";
                        }
                }
                return $masque;
        }
}