Subversion Repositories eFlore/Applications.cel

Rev

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

<?php
// ATTENTION ! Classe compatible uniquement avec nouveau format de bdd du cel //

/**
 * Service fournissant des informations concernant les images du CEL au format RSS1, RSS2 ou ATOM.
 * Encodage en entrée : utf8
 * Encodage en sortie : utf8
 *
 * @author Jean-Pascal MILCENT <jpm@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
 */
// TODO : résoudre le problème des images liées à plusieurs obs. Cela créé plusieurs item avec le même id pour atom...
class CelSyndicationImage extends Cel {

        private $parametres_origines = null;
        private $format = null;
        private $service = null;
        private $squelette = null;
        private $squelette_dossier = null;
        private $auteurs = array();
        private $flux = array();

        private $format_image = 'XL';

        private $criteres = array(
                'utilisateur' => 'c.courriel_utilisateur',
                'commune' => 'b.zone_geo',
                'dept' => 'b.ce_zone_geo',
                'taxon' => 'b.nom_ret',
                'num_taxon' => 'b.nt',
                'commentaire' => 'c.commentaire',
                'date' => 'c.date_prise_de_vue',
                'tag' => 'tag',
                'motcle' => 'tag',
                'projet' => 'projet');

        /**
         * Méthode appelée avec une requête de type GET.
         */
        public function getElement($params = array()) {
                // Initialisation des variables
                $this->parametres_origines = $params;
                $info = array();
                $contenu = '';

                if (! $this->etreFluxAdmin() || $this->authentifierAdmin()) {
                        // Pré traitement des paramêtres
                        $pour_bdd = false;
                        $p = $this->traiterParametres(array('service', 'format'), $params, $pour_bdd);
                        extract($p);
                        $this->parametres = $params;
                        $this->squelette_dossier = dirname(__FILE__).DIRECTORY_SEPARATOR.'squelettes'.DIRECTORY_SEPARATOR;

                        // Récupération de la liste des flux
                        $this->chargerListeDesFlux();

                        // Chargement du bon type de service demandé
                        if (isset($service)) {
                                $this->service = $this->traiterNomService($service);
                                $methode = $this->getNomMethodeService();
                                if (method_exists($this, $methode)) {
                                        if (isset($format) && preg_match('/^(?:rss1|rss2|atom)$/i', $format)) {
                                                // Mise en minuscule de l'indication du format
                                                $this->format = strtolower($format);
                                                // Définition du fichier squelette demandé
                                                $this->squelette = $this->squelette_dossier.$this->format.'.tpl.xml';
                                        } else if (isset($this->flux[$this->service])) {
                                                $this->format = '';
                                                $this->messages[] = "Le service CEL Syndication nécessite d'indiquer en second paramètre le format : rss1, rss2 ou atom.";
                                        }

                                        if (!isset($this->flux[$this->service]) || isset($this->format)) {
                                                // Suppression des deux premiers paramètres (service et format)  pour le reste des méthodes
                                                array_shift($this->parametres);
                                                array_shift($this->parametres);

                                                // Récupération du contenu à renvoyer
                                                $contenu = $this->$methode();
                                        }
                                } else {
                                        $this->messages[] = "Le type d'information demandé '$this->service' n'est pas disponible.";
                                }
                        } else {
                                $this->messages[] = "Le service CEL Syndication Image nécessite d'indiquer en premier paramètre le type d'information demandé.";
                        }
                }

                // Envoie sur la sortie standard
                $encodage = 'utf-8';
                $mime = $this->getTypeMime();
                $formatage_json = $this->getFormatageJson();
                $this->envoyer($contenu, $mime, $encodage, $formatage_json);
        }

        private function chargerListeDesFlux() {
                $this->setFlux('simple', 'Nouvelles images liées à une observation dans le CEL',
                        "Ce flux fournit l'url des nouvelles images du CEL liées à une observation.");
                $this->setFlux('complet', 'Nouvelles images liées à une observation dans le CEL (détails)',
                        "Ce flux fournit les informations sur les nouvelles images du CEL liées à une observation.");
                $this->setFlux('par-mots-cles', 'Flux de syndication obsolète',
                        "Ce flux est désormais accessible via le flux multicriteres/atom/M?tag='mot-cle'.");
                $this->setFlux('par-commune','Flux de syndication obsolète',
                        "Ce flux  est désormais accessible via le flux multicriteres/atom/M?commune='commune'.");
                $this->setFlux('multicriteres','Flux de syndication des nouvelles images liées à une observation publique du CEL '.
                        'filtrées par un ou plusieurs critères',
                        "Ce flux fournit des informations sur les nouvelles images liées à une observation du CEL filtrées par ".
                        "auteur (mail), commune (nom), departement (code postal), taxon (nom scientifique), commentaire, tag ".
                        "et/ou date.");
        }

        private function setFlux($nom, $titre, $description) {
                $url_base = $this->config['settings']['baseURLAbsoluDyn'].'CelSyndicationImage/';
                $formats = array('atom', 'rss2', 'rss1');
                $flux = array();
                foreach ($formats as $format) {
                        $url = $url_base.$nom.'/'.$format;
                        $flux[$format] = $url;
                }
                $this->flux[$nom] = array('titre' => $titre, 'description' => $description, 'urls' => $flux);
        }

        private function getFlux($nom) {
                return isset($this->flux[$nom]) ? $this->flux[$nom] : array();
        }

        private function traiterNomService($nom) {
                $nom = strtolower($nom);
                return $nom;
        }

        private function getNomMethodeService() {
                $methode = '';
                $service_formate = str_replace(' ', '', ucwords(implode(' ', explode('-', $this->service))));
                $methode = 'getService'.$service_formate;
                return $methode;
        }

        private function getUrlBase() {
                $url_base = sprintf($this->config['settings']['baseURLAbsolu'], get_class($this).'/');
                return $url_base;
        }

        private function getUrlServiceBase() {
                $url_service = $this->getUrlBase().implode('/', $this->parametres_origines);
                return $url_service;
        }

        private function getTypeMime() {
                $mime = '';
                switch ($this->format) {
                        case 'atom' :
                                $mime = 'application/atom+xml';
                                break;
                        case 'rss1' :
                        case 'rss2' :
                                $mime = 'application/rss+xml';
                                break;
                        case 'opml' :
                                $mime = 'text/x-opml';
                                break;
                        default:
                                $mime = 'text/html';
                }
                return $mime;
        }

        private function getFormatageJson() {
                $json = false;
                switch ($this->service) {
                        case 'liste-des-flux' :
                                $json = true;
                                break;
                        default:
                                $json = false;
                }
                return $json;
        }

        private function creerCategorie($element) {
                $categorie = '';
                $categorie = 'Image';
                $categorie = $this->nettoyerTexte($categorie);
                return $categorie;
        }

        private function etreFluxAdmin() {
                return (isset($_GET['admin']) && $_GET['admin'] == '1') ? true : false;
        }

        private function creerUrlService() {
                $url_service = $this->getUrlServiceBase();
                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;
        }

        protected function executerRequete($requete, $retour = 'All', $mode = PDO::FETCH_ASSOC) {
                $infos = null;
                try {
                        $infos = Cel::db()->query($requete)->fetchAll(PDO::FETCH_ASSOC);
                        if ($infos === false) {
                                $this->messages[] = "La requête suivante a retourné aucun résultat :\n$requete";
                        }
                } catch (PDOException $e) {
                        $msgTpl = 'Requête echec. Fichier : "%s". Ligne : "%s". Message : %s';
                        $this->messages[] = sprintf($msgTpl, $e->getFile(), $e->getLine(), $e->getMessage());
                }
                return $infos;
        }

        private function executerService($elements) {
                // Prétraitement des données
                $donnees = $this->construireDonneesCommunesAuFlux($elements);
                foreach ($elements as $element) {
                        $identifiants[$element['courriel_utilisateur']] = $element['courriel_utilisateur'];
                }
                $this->auteurs = $this->creerAuteurs($identifiants);

                foreach ($elements as $element) {
                        $donnees['items'][] = $this->construireDonneesCommunesAuxItems($element);
                }

                // Création du contenu à partir d'un template PHP
                $contenu = Cel::traiterSquelettePhp($this->squelette, $donnees);

                return $contenu;
        }

        private function construireDonneesCommunesAuFlux($infos) {
                $donnees = $this->getFlux($this->service);
                $donnees['guid'] = $this->getUrlServiceBase();
                $donnees['lien_service'] = $this->creerUrlService();
                $donnees['lien_cel'] = (isset($infos['nom_sel_nn']) && $infos['nom_sel_nn'] != '' && $infos['nom_sel_nn'] != 0) ?
                        $this->getUrlEflore($infos['nom_referentiel'], $infos['nom_sel_nn']) : '';
                $donnees['editeur'] = $this->config['settings']['editeur'];
                $derniere_info_en_date = reset($infos);
                $date_modification_timestamp = strtotime($derniere_info_en_date['date_creation']);
                $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'] = 'CEL - Jrest - CelSyndicationImage';
                $donnees['generateur_version'] = (preg_match('/([0-9]+)/', '$Revision$', $match)) ?  $match[1] : '0';
                return $donnees;
        }

        private function construireDonneesCommunesAuxItems($info) {
                $item = array();
                $date_modification_timestamp = $this->convertirDateHeureMysqlEnTimestamp($info['date_creation']);
                $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(Cel::protegerCaracteresHtmlDansChamps($info), $item);
                $item['description_encodee'] = htmlspecialchars($this->creerDescription($info, $item));
                $item['modifier_par'] = $this->getIntituleAuteur($info['courriel_utilisateur']);
                return $item;
        }

        private function creerGuidItem($element) {
                $guid = $this->getUrlImage($element['id_image']);
                return $guid;
        }

        private function creerTitre($element) {
                $methode = 'creerTitre'.$this->service;
                $methode = (method_exists($this, $methode)) ? $methode : 'creerTitreSimple';
                $titre = $this->$methode($element);
                $titre = $this->nettoyerTexte($titre);
                return $titre;
        }

        private function creerDescription($donnees, $item) {
                $methode = 'creerDescription'.$this->service;
                $methode = (method_exists($this, $methode)) ? $methode : 'creerDescriptionComplet';
                $description = $this->$methode($donnees, $item);
                $description = $this->nettoyerTexte($description);
                return $description;
        }

        private function creerLienItem($element) {

                if ($this->etreNull($element['id_observation'])) {
                        // Lien vers image grand format
                        $lien = $this->getUrlImage($element['id_image'], $this->format_image);
                } else {
                        // Lien vers fiche eFlore onglet Illustration
                        $lien = $this->getUrlEflore($element['nom_referentiel'], $element['nom_sel_nn'], 'illustration');
                }
                return $lien;
        }

        private function getServiceListeDesFlux() {
                return $this->flux;
        }

        private function getServiceOpml() {
                $donnees = array();
                $id = 1;
                foreach ($this->flux as $flux_nom => $flux){
                        $info = array();
                        $info['type'] = 'atom';
                        $info['titre'] = $flux['titre'];
                        $info['texte'] = "CEL - Images - $flux_nom";
                        $info['description'] = $flux['description'];
                        $info['url_xml'] = $this->getUrlBase().$flux_nom.'/atom';
                        $info['url_html'] = $this->config['settings']['aideCelUrl'].'FluxSyndication';
                        $donnees['liste_flux'][] = $info;
                }

                $this->squelette = $this->squelette_dossier.'opml.tpl.xml';
                $contenu = Cel::traiterSquelettePhp($this->squelette, $donnees);
                return $contenu;
        }

        private function getServiceSimple() {
                if (isset($this->parametres[0])) {
                        $this->format_image = $this->parametres[0];
                }

                // Construction de la requête
                $requete =      (isset($this->distinct) ? 'SELECT DISTINCT' : 'SELECT').' ci.*, '.
                        ' cim.id_image, cim.ce_utilisateur, nom_original, cim.date_creation, cim.mots_cles_texte as mots_cles_texte_images,
                                 ci.mots_cles_texte as mots_cles_texte_images_obs, cim.commentaire, note_qualite, nom_referentiel  '.
                        'FROM cel_obs_images AS coi '.
                        'LEFT JOIN cel_obs AS ci '.
                                'ON (coi.id_observation = ci.id_observation) '.
                        'LEFT JOIN cel_images AS cim '.
                                'ON (coi.id_image = cim.id_image) '.
                        'WHERE ci.transmission = 1 '.
                        '       AND ci.ce_utilisateur = cim.ce_utilisateur '.
                        'ORDER BY '.(isset($this->orderby) && (!is_null($this->orderby)) ? $this->orderby  : 'cim.date_creation DESC').' '.
                        "LIMIT $this->start, $this->limit ";

                $elements = $this->executerRequete($requete);

                // Création du contenu
                $contenu = $this->executerService($elements);
                return $contenu;
        }

        private function creerTitreSimple($element) {
                $date = $element['date_observation'];
                $date = date("d/m/Y", strtotime($date));
                if ($this->etreNull($element['nom_sel']) && $this->etreNull($element['nom_sel_nn'])) {
                        $titre = "Ajout d'une photo par ".$this->getIntituleAuteur($element['courriel_utilisateur']).' le '.$date;;
                } else {
                        $titre = $element['nom_sel'].' [nn'.$element['nom_sel_nn'].'] par '.$this->getIntituleAuteur($element['courriel_utilisateur']).' le '.$date;;
                }
                return $titre;
        }

        private function creerDescriptionSimple($donnees, $item) {
                $description = $this->getUrlEflore($element['nom_referentiel'], $element['nom_sel_nn'], 'illustration');
                return $description;
        }

        private function getServiceComplet() {

                // Construction de la requête
                $requete =      (isset($this->distinct) ? 'SELECT DISTINCT' : 'SELECT').' ci.*, '.
                        '       cim.id_image, ci.ce_utilisateur, nom_original, cim.date_creation, cim.mots_cles_texte as mots_cles_texte_images, '.
                        '   ci.mots_cles_texte as mots_cles_texte_obs, cim.commentaire as commentaire_img, note_qualite, nom_referentiel, '.
                        '       ci.commentaire as commentaire_obs '.
                        'FROM cel_images AS cim '.
                        '       LEFT JOIN cel_obs_images AS coi '.
                        '               ON (coi.id_image = cim.id_image) '.
                        '       LEFT JOIN cel_obs AS ci '.
                        '               ON (coi.id_observation = ci.id_observation) '.
                        (($this->etreFluxAdmin()) ? '' : 'WHERE ci.transmission = 1 ').
                        'ORDER BY '.(isset($this->orderby) && (!is_null($this->orderby)) ? $this->orderby  : 'cim.date_creation DESC').' '.
                        "LIMIT $this->start, $this->limit ";
                //echo $requete;
                $elements = $this->executerRequete($requete);

                // Création du contenu
                if ($elements != false && count($elements) > 0) {
                        $contenu = $this->executerService($elements);
                } else {
                        $this->messages[] = "Aucune image disponible.";
                        $contenu = array();
                }

                return $contenu;
        }

        private function getServiceMultiCriteres() {
                $contenu = '';
                if (isset($_GET['debut'])) $this->start = $_GET['debut'];
                if (isset($_GET['limite'])) $this->limit = $_GET['limite'];

                $this->limit = ($this->limit < 1000) ? $this->limit : 1000;// Pour éviter les abus !

                if ($this->parametresSontDemandes()) {
                        $requete = $this->creerRequeteAvecParametres();
                } else {
                        $requete = $this->creerRequeteSansParametres();
                }
                $elements = $this->executerRequete($requete);

                // Création du contenu
                if ($elements != false && count($elements) > 0) {
                        $contenu = $this->executerService($elements);
                } else {
                        $this->messages[] = "Aucune image disponible.";
                }

        return $contenu;
        }

        private function parametresSontDemandes() {
                $criteres = $this->traiterCriteresMultiples($_GET) ;
                return (isset($_GET['recherche']) && $_GET['recherche'] != '') || !empty($criteres);
        }

        private function creerRequeteSansParametres() {
                // Première sous requete pour que le limite se fasse d'abord sur les images
                // et pas la jointure de toutes les tables
                $sous_requete = 'SELECT * '.
                        'FROM cel_images c '.
                        'WHERE id_image '.
                        ' IN (SELECT id_image FROM cel_obs_images a '.
                        (($this->etreFluxAdmin()) ? '' : 'INNER JOIN cel_obs b ON b.id_observation = a.id_observation AND b.transmission = 1 ').
                        ') ';
                $sous_requete .= ' ORDER BY '.(isset($this->orderby) && (!is_null($this->orderby)) ? $this->orderby  : 'c.date_creation DESC').' '.
                        "LIMIT $this->start,$this->limit ";

                // Construction de la requête
                $requete = 'SELECT *, b.mots_cles_texte as mots_cles_texte_obs, c.mots_cles_texte as mots_cles_texte_images, '.
                        ' b.commentaire as commentaire_obs, c.commentaire as commentaire_img, nom_referentiel '.
                        'FROM ('.$sous_requete.') as c '.
                        '       INNER JOIN cel_obs_images AS a '.
                        '               ON (a.id_image = c.id_image) '.
                        '       INNER JOIN cel_obs AS b '.
                        '               ON (a.id_observation = b.id_observation) AND b.ce_utilisateur = c.ce_utilisateur ';
                //echo $requete;
                return $requete;
        }

        private function creerRequeteAvecParametres() {
                // Construction de la requête
                $requete = 'SELECT *, b.mots_cles_texte as mots_cles_texte_obs, c.mots_cles_texte as mots_cles_texte_images, '.
                    ' b.commentaire as commentaire_obs, c.commentaire as commentaire_img, nom_referentiel '.
                        'FROM cel_obs_images AS a '.
                        '       INNER JOIN cel_obs AS b '.
                        '               ON (a.id_observation = b.id_observation) '.
                        '       INNER JOIN cel_images AS c '.
                        '               ON (a.id_image = c.id_image) '.
                        'WHERE b.ce_utilisateur = c.ce_utilisateur '.
                        (($this->etreFluxAdmin()) ? '' : 'AND b.transmission = 1 ').
                        '       AND ';

                if ($this->estUneRechercheGenerale()) {
                        $chaine_requete = $_GET['recherche'];
                        $requete .= $this->creerSousRequeteRechercheGenerale($chaine_requete);
                } else {
                        $criteres = $this->traiterCriteresMultiples($_GET) ;
                        if (!empty($criteres)) {
                                $requete .= $this->creerSousRequeteRechercheParCriteres($criteres);
                        }
                }
                $requete = str_replace(' AND ) ',' ', $requete);
                $requete = rtrim($requete, 'AND ');
                $requete .= ' ORDER BY '.(isset($this->orderby) && (!is_null($this->orderby)) ? $this->orderby  :
                        'c.date_creation DESC').' '."LIMIT $this->start,$this->limit ";
                //echo $requete;
                return $requete;
        }

        private function creerSousRequeteRechercheParCriteres($criteres) {
                $requete = '';
                foreach ($criteres as $pair) {
                        $nom_valeur = explode("=",$pair);
                        if (sizeof($nom_valeur) != 0) {
                                switch ($nom_valeur[0]) {
                                        case "ci_limite" : $this->limit = Cel::db()->quote($nom_valeur[1]); break;
                                        case "c.ci_numero_page" : $this->limit*Cel::db()->quote($nom_valeur[1]); break;
                                        case "c.commentaire" : $mots_comment_liste = explode(" " , $nom_valeur[1]);
                                                foreach($mots_comment_liste as $mot_comment) {
                                                        $mot_comment = trim($mot_comment) ;
                                                        $requete .= $nom_valeur[0].' LIKE '.Cel::db()->quote('%'.$mot_comment.'%').' AND ';
                                                }
                                                break;
                                        case "c.date_prise_de_vue" :
                                                $nom_valeur[1] = str_replace('/', '-', $nom_valeur[1]);
                                                if (preg_match('/(^[0-9]{2})-([0-9]{2})-([0-9]{4}$)/', $nom_valeur[1], $matches)) {
                                                        $nom_valeur[1] = $matches[3].'-'.$matches[2].'-'.$matches[1];
                                                }
                                                $requete .= $nom_valeur[0].' LIKE '.Cel::db()->quote($nom_valeur[1]."%").' AND '; break;
                                        case "b.ce_zone_geo" :
                                                $requete .= ' ('.$nom_valeur[0].' LIKE "%INSEE-C:'.$nom_valeur[1].'%") AND '; break;
                                        case "b.nom_ret" :
                                                if ($nom_valeur[1] == "indetermine") $nom_valeur[1] = 'null';
                                                $requete .= ' ('.$nom_valeur[0].' LIKE "%'.$nom_valeur[1].'%" OR b.nom_sel LIKE "%'.
                                                        $nom_valeur[1].'%") AND '; break;
                                        case "tag" : $requete .= $this->creerSousRequeteMotsCles($nom_valeur[1]).' AND '; break;
                                        case "projet" : $requete .= $this->creerSousRequeteProjet($nom_valeur[1]).' AND '; break;
                                        default : $requete .= $nom_valeur[0].' = "'.$nom_valeur[1].'" AND '; break;
                                }
                        }
                }
                $requete = rtrim($requete,' AND ');
                return $requete;
        }

        private function creerSousRequeteMotsCles($mot_cle) {
        $requete = '';
                if (preg_match('/.*OU.*/', $mot_cle)) {
                        $mots_cles_tab = explode('OU',$mot_cle);
                        foreach($mots_cles_tab as $mot_cle_item) {
                                $requete .= '(c.mots_cles_texte LIKE '.Cel::db()->proteger('%'.$mot_cle_item.'%').') OR ';
                        }
                        $requete = '('.rtrim($requete,'OR ').')';
                } else if (preg_match('/.*ET.*/', $mot_cle)) {
                        $mots_cles_tab = explode('ET',$mot_cle);
                        foreach($mots_cles_tab as $mot_cle_item) {
                                $requete .= '(c.mots_cles_texte LIKE '.Cel::db()->proteger('%'.$mot_cle_item.'%').') AND ';
                        }
                        $requete = '('.rtrim($requete, 'AND ').') ';
                } else {
                        $requete = "(c.mots_cles_texte LIKE ".Cel::db()->proteger('%'.$mot_cle.'%').') ';
                }
                return $requete;
        }

        private function creerSousRequeteProjet($mot_cle) {
                $requete = '';
                if (preg_match('/.*OU.*/', $mot_cle)) {
                        $mots_cles_tab = explode('OU',$mot_cle);
                        foreach($mots_cles_tab as $mot_cle_item) {
                                $requete .= '(b.mots_cles_texte LIKE '.Cel::db()->proteger('%'.$mot_cle_item.'%').') OR ';
                        }
                        $requete = '('.rtrim($requete,'OR ').')';
                } else if (preg_match('/.*ET.*/', $mot_cle)) {
                        $mots_cles_tab = explode('ET',$mot_cle);
                        foreach($mots_cles_tab as $mot_cle_item) {
                                $requete .= '(b.mots_cles_texte LIKE '.Cel::db()->proteger('%'.$mot_cle_item.'%').') AND ';
                        }
                        $requete = '('.rtrim($requete, 'AND ').') ';
                } else {
                        $requete = "(b.mots_cles_texte LIKE ".Cel::db()->proteger('%'.$mot_cle.'%').') ';
                }
                return $requete;
        }

        private function creerSousRequeteRechercheGenerale($chaine_requete) {
                $requete = '';
                if (trim($chaine_requete) != '') {
                        $chaine_requete = strtolower($chaine_requete);
                        $chaine_requete = str_replace(' ', '_', $chaine_requete);
                        $requete = ' ('.
                                'b.nom_ret LIKE "'.$chaine_requete.'%"'.
                                ' OR '.
                                'b.nom_sel LIKE "'.$chaine_requete.'%"'.
                                ' OR '.
                                'b.zone_geo LIKE "'.$chaine_requete.'%" '.
                                ' OR '.
                                'b.ce_zone_geo LIKE "INSEE-C:'.$chaine_requete.'%" '.
                                ' OR '.
                                'b.ce_zone_geo LIKE "'.$chaine_requete.'%" '.
                                ' OR '.
                                'c.ce_utilisateur LIKE "'.$chaine_requete.'%" '.
                                ' OR '.
                                'c.courriel_utilisateur LIKE "'.$chaine_requete.'%" '.
                                ' OR '.
                                'b.mots_cles_texte LIKE "'.$chaine_requete.'%" '.
                                ' OR '.
                                'c.mots_cles_texte LIKE "'.$chaine_requete.'%" '.
                                ') ';
                }
                return $requete;
        }

        private function estUneRechercheGenerale() {
                return isset($_GET['recherche']);
        }

        private function traiterCriteresMultiples($tableau_criteres) {
                $tableau_criteres_pour_bdd = array();

                foreach($tableau_criteres as $nom_critere => $valeur_critere) {
                        if (isset($this->criteres[$nom_critere])) {
                                $tableau_criteres_pour_bdd[] = $this->criteres[$nom_critere].'='.$valeur_critere;
                        }
                }
                return $tableau_criteres_pour_bdd;
        }

        private function creerDescriptionComplet($donnees, $item) {
                $auteur = $this->getIntituleAuteur($donnees['courriel_utilisateur']);
                $auteur_mail = $donnees['courriel_utilisateur'];

                $id_img = $donnees['id_image'];
                $nom_fichier = $donnees['nom_original'];
                $url_img = $this->getUrlImage($donnees['id_image'], 'CS');
                $url_img_normale = $this->getUrlImage($donnees['id_image'], 'XL');
                //
                $mots_cles_image = $donnees['mots_cles_texte_images'];
                $note = ($donnees['note_qualite'] +1).'/5';
                $commentaire_img = $donnees['commentaire_img'];

                $id_obs = $donnees['id_observation'];
                $famille = $donnees['famille'];
                $nom_saisi = $donnees['nom_sel'];
                $nom_retenu = $donnees['nom_ret'];
                //
                $mots_cles_obs = $donnees['mots_cles_texte_obs'];
                $lieu =  $donnees['zone_geo'].' ('.$this->convertirCodeZoneGeoVersCodeInsee($donnees['ce_zone_geo']).') > '.$donnees['lieudit'].' > '.$donnees['station'];
                $milieu = $donnees['milieu'];
                $coordonnees = ($this->etreNull($donnees['latitude']) && $this->etreNull($donnees['longitude'])) ? '' : $donnees['latitude'].'/'.$donnees['longitude'];
                $commentaire_obs = $donnees['commentaire_obs'];
                $date_observation = $this->formaterDate($donnees['date_observation'], '%A %d %B %Y');
                $date_transmission = $this->formaterDate($donnees['date_transmission']);
                $date_modification = $this->formaterDate($donnees['date_modification']);
                $date_creation = $this->formaterDate($donnees['date_creation']);
                $transmission = $donnees['transmission'] == 1 ? "oui ($date_transmission)" : 'non';

                $description = '<style>.champ{color:grey} .gauche{float:left;padding:0 20px 0 0;} ul{list-style-type:none;padding:0;}</style>'.
                        '<h2>'.(!$this->etreNull($id_obs) ? "Image #$id_img liée à l'observation #$id_obs" : "Image #$id_img non liée à une observation.").'</h2>'.
                        '<a href="'.$url_img_normale.'"><img class="gauche" src="'.$url_img.'" alt="'.$nom_fichier.'" /></a>'.
                        '<div class="gauche">'.
                        '<h3>'.'Image'.'</h3>'.
                        '<ul>'.
                        '<li>'.'<span class="champ">URL :</span> <a href="'.$url_img_normale.'" onclick="javascript:window.open(this.href);return false;">'.$url_img_normale.'</a></li>'.
                        '<li>'.'<span class="champ">Importée le :</span> '.$item['date_maj_simple'].'</li>'.
                        '<li>'.'<span class="champ">Par :</span> '.
                                (($this->etreFluxAdmin()) ? '<a href="mailto:'.$auteur_mail.'">'.$auteur.'</a>' : $auteur).
                        '</li>'.
                        '<li>'.'<span class="champ">Nom du fichier :</span> '.$this->nePasInterpreterXml($nom_fichier).'</li>'.
                        '<li>'.'<span class="champ">Note qualité :</span> '.$note.'</li>'.
                        '<li>'.'<span class="champ">Commentaires :</span> '.$this->nePasInterpreterXml($commentaire_img).'</li>'.
                        '<li>'.'<span class="champ">Mots-clés :</span> '.$this->nePasInterpreterXml($mots_cles_image).'</li>'.
                        '</ul>'.
                        '</div>';
                        // TODO : ajouter le champ commentaire EXIF.
                if (! $this->etreNull($id_obs)) {
                        $description .=
                                '<div class="gauche">'.
                                '<h3>'.'Observation'.'</h3>'.
                                '<ul>'.
                                '<li>'.'<span class="champ">Famille :</span> '.$famille.'</li>'.
                                '<li>'.'<span class="champ">Nom saisi :</span> '.$nom_saisi.'</li>'.
                                '<li>'.'<span class="champ">Nom retenu :</span> '.$nom_retenu.'</li>'.
                                '<li>'.'<span class="champ">Observée le :</span> '.$date_observation.'</li>'.
                                '<li>'.'<span class="champ">Lieu :</span> '.$lieu.'</li>'.
                                '<li>'.'<span class="champ">Milieu :</span> '.$milieu.'</li>'.
                                (($this->etreFluxAdmin()) ? '<li><span class="champ">Coordonnées (Lat/Long) :</span> '.$coordonnees.'</li>' : '').
                                '<li>'.'<span class="champ">Commentaire :</span> '.$this->nePasInterpreterXml($commentaire_obs).'</li>'.
                                '<li>'.'<span class="champ">Mots-clés :</span> '.$this->nePasInterpreterXml($mots_cles_obs).'</li>'.
                                (($this->etreFluxAdmin()) ? '<li><span class="champ">Transmis (= public) :</span> '.$transmission.'</li>' : '').
                                '<li><span class="champ">Modifiée le :</span> '.$date_modification.'</li>'.
                                '<li><span class="champ">Créée le :</span> '.$date_creation.'</li>'.
                                '</ul>'.
                                '</div>';
                }
                $description = $this->nettoyerTexte($description);
                return $description;
        }

        private function nePasInterpreterXml($txt) {
                return '<![CDATA['.$txt.']]>';
        }

        private function getServiceParMotsCles() {
                $infos=array();
                $infos[0]['nom_sel_nn'] = '';
                $infos[0]['date_creation'] = '2011-06-28';
                $donnees = $this->construireDonneesCommunesAuFlux($infos);
                $donnees['items'][0]['guid'] = 0;
                $donnees['items'][0]['description'] =  'Ce flux est devenu obsolète. Veuillez utiliser le flux '.
                        '<b>http://www.tela-botanica.org/eflore/cel2/jrest/CelSyndicationImage/multicriteres/atom?tag=';
                if (isset($this->parametres[0])) {
                        $donnees['items'][0]['description'] .= $this->parametres[0].'</b>';
                } else {
                        $donnees['items'][0]['description'] .= '</b>';
                }
                $donnees['items'][0]['titre'] = '';
                $contenu = Cel::traiterSquelettePhp($this->squelette, $donnees);
                return $contenu;
        }

        private function getServiceParCommune() {
                $infos=array();
                $infos[0]['nom_sel_nn'] = '';
                $infos[0]['date_creation'] = '2011-06-28';
                $donnees = $this->construireDonneesCommunesAuFlux($infos);
                $donnees['items'][0]['guid'] = 0;
                $donnees['items'][0]['description'] = 'Ce flux est devenu obsolète. Veuillez utiliser le flux '.
                        '<b>http://www.tela-botanica.org/eflore/cel2/jrest/CelSyndicationImage/multicriteres/atom?commune=';
                if (isset($this->parametres[0])) {
                        $donnees['items'][0]['description'] .= $this->parametres[0].'</b>';
                } else {
                        $donnees['items'][0]['description'] .= '</b>';
                }
                $donnees['items'][0]['titre'] = '';
                $contenu = Cel::traiterSquelettePhp($this->squelette, $donnees);
                return $contenu;
        }

        private function getIntituleAuteur($courriel) {
                $courriel = strtolower($courriel);
                $intitule = $this->auteurs[$courriel];
                return $intitule;
        }
}