Subversion Repositories eFlore/Applications.cel

<?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('&', $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;

    }

}