Rev 1284 | Blame | Last modification | View Log | RSS feed
<?php
/**
* Service fournissant des informations concernant les votes sur les images de DEL en fonction d'un protocole
* au format RSS1, RSS2 ou ATOM.
* Encodage en entrée : utf8
* Encodage en sortie : utf8
*
* @author Grégoire DUCHE <gregoire@tela-botanica.org>
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
* @version $Id$
* @copyright 2010
*/
class SyndicationVotesParProtocole {
/**
* Paramètres du service
* */
private $ressources = null;
private $parametres = null;
private $format = null;
private $service = null;
private $squelette = null;
private $squelette_dossier = null;
private $masque = array();
private $mappingFiltre = array();
private $conteneur = null;
private $gestionBdd = null;
private $navigation = null;
private $type_rss = null;
/**
* Constructeur
* Initialiser les configurations
* */
public function __construct(Conteneur $conteneur = null) {
$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
$this->conteneur->chargerConfiguration('config_syndication_votesparprotocole.ini');
$this->mappingFiltre = $this->conteneur->getParametre('mapping_masque');
$this->masque = $conteneur->getMasque();
$this->gestionBdd = $conteneur->getGestionBdd();
$this->navigation = $conteneur->getNavigation();
}
/**
* Consulter
* Méthode par défaut pour récupérer l'ensemble des votes.
* Vérifie la configuration et retourne les derniers votes formatés
* */
public function consulter($params = array()) {
$this->verifierConfiguration();
$this->type_rss = $params[1];
if ($this->fluxAdminDemande()) {
$this->demanderAutorisationAdmin();
}
$donnees_brutes = $this->getDerniersVotesImage();
$commentaires_formates = $this->formaterPourRss($donnees_brutes) ;
return $commentaires_formates;
}
/**
* Vérifier que le service est bien configuré
* */
public function verifierConfiguration() {
$erreurs = array();
$tableauImages = $this->conteneur->getParametre('mapping_masque');
if (empty($this->mappingFiltre)) {
$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_masque] ou celui-ci est vide ;';
} else {
$champsMappingFiltre = array('image', 'protocole');
foreach ($champsMappingFiltre as $champ) {
if (!isset($this->mappingFiltre[$champ])) {
$erreurs[] = '- le mapping du champ "'.$champ.'" pour le commentaire est manquant ;';
}
}
}
if (!empty($erreurs)) {
$e = 'Erreur lors de la configuration : '."\n";
$e .= implode("\n", $erreurs);
throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
}
}
/**
* Verifier si le flux admin est demandé
*/
private function fluxAdminDemande() {
return $this->conteneur->getParametre('admin') != null && $this->conteneur->getParametre('admin') == 1;
}
/**
* Si le flux est un flux admin, demander un mot de passe
* */
private function demanderAutorisationAdmin() {
$verification = new ControleAcces($this->conteneur);
$verification->demanderAuthentificationAdmin();
}
/**
* Formater les données pour mettre en page le RSS
* */
private function formaterPourRss($elements) {
$donnees = $this->construireDonneesCommunesAuFlux($elements);
foreach ($elements as $element) {
$identifiants[$element['id_vote']] = $element['id_vote'];
}
foreach ($elements as $element) {
$donnees['items'][] = $this->construireDonneesCommunesAuxItems($element);
}
return $donnees;
}
/**
* Générer les métadonnées du flux (titre, dates, editeur etc.)
* */
private function construireDonneesCommunesAuFlux($infos) {
$donnees = array();
$donnees['guid'] = '';
$donnees['titre'] = 'pictoFlora : votes';
$donnees['description'] = 'Ce flux regroupe les derniers votes sur les images de pictoFlora';
$donnees['lien_service'] = $this->creerUrlService();
$donnees['lien_del'] = $this->conteneur->getParametre('pictoAppliLien');
$donnees['editeur'] = $this->conteneur->getParametre('editeur');
$derniere_info_en_date = reset($infos);
$date_modification_timestamp = strtotime($derniere_info_en_date['date_vote']);
$donnees['date_maj_RSS'] = date(DATE_RSS, $date_modification_timestamp);
$donnees['date_maj_ATOM'] = date(DATE_ATOM, $date_modification_timestamp);
$donnees['date_maj_W3C'] = date(DATE_W3C, $date_modification_timestamp);
$donnees['annee_courante'] = date('Y');
$donnees['generateur'] = 'DEL - SyndicationCommentaire';
$donnees['generateur_version'] = (preg_match('/([0-9]+)/', '$Revision$', $match)) ? $match[1] : '0';
return $donnees;
}
/**
* Générer le lien du flux RSS
* */
private function creerUrlService() {
$url_service = $this->conteneur->getParametre('url_service');
$url_service .= '/'.$this->type_rss;
//$url_service = '';
if (count($_GET) > 0) {
$parametres_get = array();
foreach ($_GET as $cle => $valeur) {
$parametres_get[] = $cle.'='.$valeur;
}
$url_service .= '?'.implode('&', $parametres_get);
}
return $url_service;
}
/**
* Générer les données communes & spécifiques à chaque item
* */
private function construireDonneesCommunesAuxItems($info) {
$item = array();
$date_modification_timestamp = strtotime($info['date_vote']);
$item['date_maj_simple'] = strftime('%A %d %B %Y à %H:%M', $date_modification_timestamp);
$item['date_maj_RSS'] = date(DATE_RSS, $date_modification_timestamp);
$item['date_maj_ATOM'] = date(DATE_ATOM, $date_modification_timestamp);
$item['date_maj_W3C'] = date(DATE_W3C, $date_modification_timestamp);
$item['titre'] = $this->creerTitre($info);
$item['guid'] = $this->creerGuidItem($info);
$item['lien'] = $this->creerLienItem($info);
$item['categorie'] = $this->creerCategorie($item);
$item['description'] = $this->creerDescription($info, $item);
$item['description_encodee'] = htmlspecialchars($this->creerDescription($info, $item));
$item['modifie_par'] = $this->creerAuteur($info);
return $item;
}
private function creerCategorie($element) {
$categorie = 'Vote protocole';
$categorie = htmlentities($categorie);
return $categorie;
}
private function creerGuidItem($element) {
$guid = sprintf($this->conteneur->getParametre('voteParProtocole'), $element['id_vote']);
return $guid;
}
private function creerLienItem($element) {
$lien = sprintf($this->conteneur->getParametre('pictofloraFicheObsTpl'), $element['id_observation']);
return $lien;
}
private function creerTitre($element) {
$noteVote = $element['valeur'];
$nomSci = htmlspecialchars($element['nom_sel']);
$votant = array('prenom' => $element['votant_prenom'], 'nom' => $element['votant_nom']);
$votantTxt = htmlspecialchars($this->creerAuteur($votant));
$observateur = array('prenom' => $element['observateur_prenom'], 'nom' => $element['observateur_nom']);
$observateurTxt = htmlspecialchars($this->creerAuteur($observateur));
$titre = "Vote $noteVote par $votantTxt pour $nomSci de $observateurTxt";
return $titre;
}
private function creerDescription($donnees, $item) {
$idVote = htmlspecialchars($donnees['id_vote']);
$idObs = htmlspecialchars($donnees['id_observation']);
$idImg = htmlspecialchars($donnees['ce_image']);
$urlImg = $this->getUrlImage($donnees['ce_image']);
$miniatureUrl = $this->getUrlImage($donnees['ce_image'], 'CRX2S');
$proposition = htmlspecialchars($donnees['nom_sel']);
$protocole = htmlspecialchars($donnees['intitule']);
$votant = array('prenom' => $donnees['votant_prenom'], 'nom' => $donnees['votant_nom']);
$votantTxt = htmlspecialchars($this->creerAuteur($votant));
$observateur = array('prenom' => $donnees['observateur_prenom'], 'nom' => $donnees['observateur_nom']);
$observateurTxt = htmlspecialchars($this->creerAuteur($observateur));
$description = '<ul>'.
"<li>Vote pictoFlora #$idVote</li>".
'<li>'.
' <a href="'.$urlImg.'">'.
' <img src="'.$miniatureUrl.'" alt="Img #'.$idImg.'"/>'.
' Image #'.$idImg.
' </a>'.
'</li>'.
"<li>Auteur de l'image : $observateurTxt</li>".
"<li>Observation #$idObs : <em>$proposition</em></li>".
"<li>Protocole : $protocole</li>".
'<li>Valeur : <strong>'.$donnees['valeur'].'</strong>/5</li>'.
'<li>Votant : '.$votantTxt.'</li>'.
'</ul>';
return $description;
}
private function getUrlImage($id, $format = 'L') {
$url_tpl = $this->conteneur->getParametre('celImgUrlTpl');
$id = sprintf('%09s', $id).$format;
$url = sprintf($url_tpl, $id);
return $url;
}
private function creerAuteur($info) {
$intitule = 'Anonyme';
if (isset($info['prenom']) && isset($info['nom'])) {
$intitule = $info['prenom'].' '.$info['nom'];
}
return $intitule;
}
/**
* Retrouver les derniers votes image
* */
private function getDerniersVotesImage() {
$requete = 'SELECT DISTINCT id_vote, ce_image, valeur, divo.date AS date_vote, '.
' duo.prenom AS observateur_prenom, duo.nom AS observateur_nom, '.
' duv.prenom AS votant_prenom, duv.nom AS votant_nom, '.
' do.id_observation, do.nom_sel, dip.intitule '.
'FROM del_image_vote AS divo '.
' INNER JOIN del_obs_image AS doi '.
' ON divo.ce_image = doi.id_image '.
' INNER JOIN del_observation AS do '.
' ON do.id_observation = doi.id_observation '.
' INNER JOIN del_image_protocole AS dip '.
' ON ce_protocole = id_protocole '.
' LEFT JOIN del_utilisateur AS duo '.
' ON do.ce_utilisateur = duo.id_utilisateur '.
' LEFT JOIN del_utilisateur AS duv '.
' ON CAST(divo.ce_utilisateur AS UNSIGNED) = duv.id_utilisateur '.
$this->chargerClauseWhere().' '.
'ORDER BY divo.date DESC '.
'LIMIT '.$this->navigation->getDepart().','.$this->navigation->getLimite();
$elements = $this->gestionBdd->getBdd()->recupererTous($requete);
return $elements;
}
/**
* Charger la clause WHERE en fonction des paramètres de masque
* */
private function chargerClauseWhere() {
$where = array();
$tableauMasque = $this->masque->getMasque();
if (!empty($tableauMasque)) {
foreach($tableauMasque as $idMasque => $valeurMasque) {
$idMasque = str_replace('masque.', '', $idMasque);
switch ($idMasque) {
case 'image':
$where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->gestionBdd->getBdd()->proteger($valeurMasque);
break;
case 'protocole':
$where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->gestionBdd->getBdd()->proteger($valeurMasque).' ';
break;
default:
$where[] = ' '.$this->mappingFiltre[$idMasque].' = '.$this->gestionBdd->getBdd()->proteger($valeurMasque);
break;
}
}
}
if (!empty($where)) {
return ' WHERE '.implode('AND', $where);
} else {
return;
}
}
private function creerFiltreAuteur($valeurMasque) {
$masque = '';
$auteurId = $valeurMasque;
if (is_numeric($auteurId)) {
$masque = ' dc.ce_utilisateur = '.$auteurId;
} else {
if (strpos($auteurId, '@') === false) {
$tableauNomPrenom = explode(' ',$auteurId, 2);
if(count($tableauNomPrenom) == 2) {
// on teste potentiellement un nom prenom ou bien un prénom nom
$masque = '('.
'(dc.utilisateur_nom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[0].'%').' AND '.
'dc.utilisateur_prenom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[1].'%').') OR '.
'(dc.utilisateur_nom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[1].'%').' AND '.
'dc.utilisateur_prenom LIKE '.$this->gestionBdd->getBdd()->proteger($tableauNomPrenom[0].'%').')'.
')';
} else {
$masque = '(
(dc.utilisateur_nom LIKE '.$this->gestionBdd->getBdd()->proteger($auteurId.'%').' OR '.
'dc.utilisateur_prenom LIKE '.$this->gestionBdd->getBdd()->proteger($auteurId.'%').')'.
')';
}
} else {
$masque = " do.utilisateur_courriel LIKE ".$this->gestionBdd->getBdd()->proteger($valeurMasque.'%')." ";
}
}
return $masque;
}
}
?>