Subversion Repositories eFlore/Applications.cel

Rev

Rev 3792 | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php
// declare(encoding='UTF-8');
/**
 * Service fournissant des informations concernant les images du CEL au format RSS1, RSS2 ou ATOM.
 
 *
 * @internal   Mininum PHP version : 5.2
 * @category   CEL
 * @package    Services
 * @subpackage Syndication
 * @version    0.1
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author     Aurelien PERONNET <aurelien@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>
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
 */
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' => 'b.courriel_utilisateur',
        'commune' => 'b.zone_geo',
        'dept' => 'b.dept',
        'taxon' => 'b.nom_ret',
        'num_taxon' => 'b.nt',
        'num_nom' => 'b.nom_sel_nn',
        'commentaire' => 'c.commentaire',
        'date' => 'c.date_prise_de_vue',
        'tag' => 'tag',
        'motcle' => 'tag',
        'projet' => 'projet',
        'referentiel' => 'referentiel',
        'groupe_zones_geo' => 'groupe_zones_geo'
    );
    
    /**
     * 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 n'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->nettoyerTexte($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').' co.*, '.
            ' ci.id_image, co.ce_utilisateur, nom_original, ci.date_creation, ci.mots_cles_texte AS mots_cles_texte_images, '.
            ' co.mots_cles_texte AS mots_cles_texte_images_obs, "" as commentaire, "" as note_qualite, nom_referentiel '.
            'FROM cel_export_total AS co JOIN cel_images_export AS ci ON (co.id_observation = ci.ce_observation) '.
            'WHERE co.transmission = 1 '.
            '   AND co.ce_utilisateur = ci.ce_utilisateur '.
            'ORDER BY '.(isset($this->orderby) && (!is_null($this->orderby)) ? $this->orderby  : 'ci.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;
        }
        $zoneGeo = $element['zone_geo'];
        if ($zoneGeo) {
            $titre .= " - $zoneGeo";
        }
        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').' co.*, '.
            '   ci.id_image, co.ce_utilisateur, nom_original, ci.date_creation, ci.mots_cles_texte AS mots_cles_texte_images, '.
            '   co.mots_cles_texte AS mots_cles_texte_obs, ci.commentaire AS commentaire_img, note_qualite, nom_referentiel, '.
            '   co.commentaire AS commentaire_obs '.
            'FROM cel_images_export AS ci '.
            '   JOIN cel_export AS co '.
            '           ON (ci.ce_observation = co.id_observation) '.
            (($this->etreFluxAdmin()) ? '' : 'WHERE co.transmission = 1 ').
            'ORDER BY '.(isset($this->orderby) && (!is_null($this->orderby)) ? $this->orderby  : 'ci.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 {
                // ne pas faire ça, car ça déclenche une erreur 500 à tort !
                //$this->messages[] = "Aucune image disponible.";
                $contenu = array();
            }
            
            return $contenu;
    }
    
    private function getServiceMultiCriteres() {
        $contenu = '';
        if (isset($_GET['debut'])) $this->start = Cel::db()->proteger($_GET['debut']);
        if (isset($_GET['limite'])) $this->limit = Cel::db()->proteger($_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 {
            // ne pas faire ça, car ça déclenche une erreur 500 à tort !
            //$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() {
        // 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, "" AS commentaire_img, nom_referentiel '.
            'FROM cel_images_export c '.
            '   JOIN cel_export AS b '.
            '           ON (c.ce_observation = b.id_observation) ';
        $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 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, "" as commentaire_img, nom_referentiel '.
            'FROM cel_images_export AS c '.
            '   JOIN cel_export_total AS b '.
            '           ON (c.ce_observation = b.id_observation) '.
            'WHERE '.
            (($this->etreFluxAdmin()) ? '' : ' b.transmission = 1 ').
            '   AND ';
            
            if ($this->estUneRechercheGenerale()) {
                $chaine_requete = $_GET['recherche'];
                $requete .= "donnees_standard =  1 AND ".$this->creerSousRequeteRechercheGenerale($chaine_requete);
            } else {
                $criteres = $this->traiterCriteresMultiples($_GET) ;
                if (!isset($_GET["standard"])) {
                    $requete .= "donnees_standard =  1 AND ";
                } elseif ($_GET["standard"] = 1) {
                    $requete .= "donnees_standard =  1 AND ";
                }
                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 ";
            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 "%'.$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;
                    case "referentiel" : $requete .= $this->creerSousRequeteReferentiel($nom_valeur[1]).' AND '; break;
                    case "groupe_zones_geo" : $requete .= $this->creerSousRequeteGroupeZonesGeo($nom_valeur[1])." AND "; break;
                    default : $requete .= $nom_valeur[0].' = "'.$nom_valeur[1].'" AND '; break;
                }
            }
        }
        $requete = rtrim($requete,' AND ');
        return $requete;
    }
    
    private function creerSousRequeteGroupeZonesGeo($groupe_zones_geo) {
        $req = "SELECT valeur FROM cel_groupes_zones WHERE id_groupe = ".Cel::db()->proteger($groupe_zones_geo);
        $res = Cel::db()->requeter($req);
        $zones = array();
        foreach($res as &$r) {
            $zones[] = Cel::db()->proteger($r['valeur']);
        }
        $sql = '(b.ce_zone_geo IN ('.implode(',', $zones).')) ';
        
        return $sql;
    }
    
    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 creerSousRequeteReferentiel($referentiel) {
        $requete = "b.nom_referentiel LIKE '$referentiel%'";
        return $requete;
    }
    
    private function creerSousRequeteRechercheGenerale($chaine_requete) {
        $requete = '';
        $chaine_requete = Cel::deb()->proteger($chaine_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 '.
                'b.ce_utilisateur LIKE '.$chaine_requete.
                ' OR '.
                'b.courriel_utilisateur LIKE '.$chaine_requete.
                ' OR '.
                'b.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])) {
                //$valeur_critere = Cel::db()->proteger($valeur_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 =  $this->formaterZoneGeoEtCodePourAffichage($donnees).' > '.$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.'.jpg" 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 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;
    }
}