<?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' => '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->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, ci.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, ci.commentaire, note_qualite, nom_referentiel '.
			'FROM cel_obs AS co LEFT JOIN cel_images 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;;
		}
		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 AS ci '.
			'	LEFT JOIN cel_obs 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 {
			$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_images a '.
			(($this->etreFluxAdmin()) ? '' : 'INNER JOIN cel_obs b ON a.ce_observation = b.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 AS b '.
			'		ON (c.ce_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_images AS c '.
			'	INNER JOIN cel_obs AS b '.
			'		ON (c.ce_observation = b.id_observation) '.
			'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 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;
	}
}