Subversion Repositories Applications.annuaire

<?

/**

* PHP Version 5

*

* @category  PHP

* @package   annuaire

* @author    aurelien <aurelien@tela-botanica.org>

* @copyright 2010 Tela-Botanica

* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL

* @version   SVN: <svn_id>

* @link      /doc/annuaire/

*/

/**

 *

 * Classe mère des controleurs de l'application, abstraite, elle contient

 * les fonctions utiles à tous les controleurs

 * @author aurelien

 *

 */

abstract class AppControleur extends Controleur {

	/**

	 * (fonction héritée de la classe Controleur)

	 * Avant chaque chargement de vue, on ajoute l'url de la page dans

	 * les variables à insérer.

	 * @param Array $donnes les données à insérer dans la vue

	 * @return Array $donnees les données modifiées

	 */

	public function preTraiterDonnees($donnees) {

		// ajout de l'url de l'appli

		$donnees['base_url'] = new Url(Config::get('base_url_application'));

		$donnees['base_url_styles'] = new Url(Config::get('base_url_styles'));

		$donnees['url_cette_page'] = $_SERVER['SERVER_NAME'].$_SERVER['REQUEST_URI'];

		//ajout des variables d'identification

		$donnees['est_admin'] = Registre::getInstance()->get('est_admin');

		$donnees['identification_id'] =	Registre::getInstance()->get('identification_id');

		$donnees['identification_mail']	= Registre::getInstance()->get('identification_mail');

		return $donnees;

	}

	/**

	 * Renvoie le template de pagination, considérant des éléments donnés en paramètre

	 * @param int $numero_page le numéro de page en cours

	 * @param int $taille_page la taille de page

	 * @param int $total le nombre total de pages

	 * @param object $url_base l'url de base de la page

	 * @param array $valeurs les valeurs à concatener à l'url

	 * @return string le html contenu la template de pagination rempli avec les infos

	 */

	protected function paginer($numero_page = 1, $taille_page = 50, $total, $url_base, $valeurs) {

		// TODO, faire plus complexe, tri alphabétique etc...

		$page_precedente = $numero_page-1;

		$page_suivante = $numero_page+1;

		if($taille_page <= 0) {

			$taille_page = 1;

		}

		$nombre_pages = round($total/$taille_page,'PHP_ROUND_HALF_DOWN') ;

		foreach($valeurs as $cle => $variable) {

			$url_base->setVariableRequete($cle,$variable);

		}

		if($numero_page < 2) {

			$page_precedente = false;

			$url_page_precedente = '';

		} else {

			$url_page_prec = clone($url_base);

				$url_page_prec->setVariableRequete('numero_page',($page_precedente));

				$url_page_prec->setVariableRequete('taille_page',($taille_page));

				$url_page_precedente = $url_page_prec->getUrl();

		}

		if($taille_page*($numero_page) >= $total) {

			$page_suivante = false;

			$url_page_suivante = '';

		} else {

			$url_page_suiv = clone($url_base);

				$url_page_suiv->setVariableRequete('numero_page',($page_suivante));

				$url_page_suiv->setVariableRequete('taille_page',($taille_page));

				$url_page_suivante = $url_page_suiv->getUrl();

		}

		$url_pages = array();

		for($i = 1; $i <= $nombre_pages ; $i++) {

				$url_page_prev = clone($url_base);

				$url_page_prev->setVariableRequete('numero_page',($i));

				$url_page_prev->setVariableRequete('taille_page',($taille_page));

				$url_pages[$i] = $url_page_prev->getUrl();

		}

		$donnees = array('url_pages' => $url_pages, 'numero_page' => $numero_page,

							'page_precedente' => $page_precedente, 'page_suivante' => $page_suivante,

							'url_page_precedente' => $url_page_precedente, 'url_page_suivante' => $url_page_suivante,

							'nombre_pages' => $nombre_pages, 'taille_page' => $taille_page);

		$donnees['base_url_pagination'] = $url_base;

		return $this->getVue(Config::get('dossier_squelettes_elements').'pagination',$donnees);

	}

	public function obtenirIdParMail($id_annuaire, $mail_utilisateur) {

		$this->chargerModele('AnnuaireModele');

		$id = $this->AnnuaireModele->obtenirIdParMail($id_annuaire, $mail_utilisateur);

		return $id;

	}

	public function utilisateurExiste($id_annuaire,$id, $utilise_mail = true) {

		$this->chargerModele('AnnuaireModele');

		if($utilise_mail) {

			$existe = $this->AnnuaireModele->utilisateurExisteParMail($id_annuaire,$id);

		} else {

			$existe = $this->AnnuaireModele->utilisateurExisteParId($id_annuaire,$id);

		}

		return $existe;

	}

/** ---------------------------------    Fonction d'extraction des champs de mappage -------------------------------------------*/

	/**

	 * Renvoie les champs de mappage correspondant à un annuaire donné

	 * @param int $id_annuaire l'indentifant de l'annuaire pour lequel on veut ces informations

	 * @return Array un tableau de mappage des champs

	 *

	 */

	protected function obtenirChampsMappageAnnuaire($id_annuaire) {

		$this->chargerModele('AnnuaireModele');

		$tableau_mappage = $this->AnnuaireModele->obtenirChampsMappageAnnuaire($id_annuaire);

		return $tableau_mappage;

	}

/** ---------------------------------    Fonction d'affichage des champs de metadonnées -------------------------------------------*/

	/**

	 * Charge et affiche le champ correspondant à la modification ou l'ajout d'un champ de metadonnée

	 * @param int $id_champ l'identifiant du champ demandé

	 * @return string la vue contenant le champ de formulaire correspondant

	 */

	public function afficherFormulaireChampMetadonnees($id_champ, $donnees) {

		// si le champ est restreint à une valeur de liste

		if($donnees['amc_ce_ontologie'] != 0) {

				$this->chargerModele('OntologieModele');

				$donnees['liste_valeurs'] = $this->OntologieModele->chargerListeOntologie($donnees['amc_ce_ontologie']);

		}

		$donnees['amc_id_champ'] = $id_champ;

		if(isset($donnees['amc_ce_template_affichage'])) {

			$nom_type_champ = $donnees['amc_ce_template_affichage'];

		} else {

			$this->chargerModele('MetadonneeModele');

			$nom_type_champ = $this->MetadonneeModele->renvoyerTypeAffichageParId($donnees['amc_ce_type_affichage']);

		}

		return $this->getVue(Config::get('dossier_squelettes_champs').$nom_type_champ,$donnees);

	}

/** ---------------------------------    Fonction d'existence et de génération des formulaires -------------------------------------------*/

	/**

	 * Renvoie le formulaire demandé s'il existe, sinon faux

	 * @param string $nom_formulaire le nom du formulaire demandé (qui est normalement le code d'un annuaire)

	 * @return boolean true si le formulaire existe, false sinon

	 */

	protected function formulaireExiste($nom_formulaire) {

		return $this->templateExiste($nom_formulaire.'_inscription', Config::get('dossier_squelettes_formulaires'));

	}

	/**

	 * Renvoie le template demandé s'il existe, sinon faux

	 * @param string $nom_formulaire le nom du formulaire demandé (qui est normalement le code d'un annuaire)

	 * @param string $dossier le nom du dossier sous dossier demandé

	 * @return boolean true si le formulaire existe, false sinon

	 */

	protected function templateExiste($nom_template, $dossier = '/') {

		return file_exists(Config::get('chemin_squelettes').$dossier.$nom_template.'.tpl.html');

	}

	/**

	 * Renvoie un formulaire d'inscription minimal auto-généré

	 * @param string $donnees les donnée à inclure dans le formulaire

	 * @return string la vue contenant le formulaire généré

	 */

	protected function genererFormulaireInscription($donnees) {

		$formulaire_modele = $this->getVue(Config::get('dossier_squelettes_formulaires').'inscription',$donnees);

		if($formulaire_modele) {

			return $formulaire_modele;

		} else {

			trigger_error("impossible de trouver le squelette de référence pour le formulaire");

		}

		return false;

	}

	/**

	 * Renvoie un formulaire d'inscription minimal auto-généré

	 * @param string $donnees les donnée à inclure dans le formulaire

	 * @return string la vue contenant le formulaire généré

	 */

	protected function genererFormulaireRecherche($donnees) {

		$formulaire_modele = $this->getVue(Config::get('dossier_squelettes_formulaires').'recherche',$donnees);

		if($formulaire_modele) {

			return $formulaire_modele;

		} else {

			trigger_error("impossible de trouver le squelette de référence pour le formulaire");

		}

		return false;

	}

/** ---------------------------------    Fonction d'extraction d'informations utilisées entre autres par les web services -------------------------------------------*/

	public function obtenirValeursUtilisateur($id_annuaire, $id_utilisateur) {

		$this->chargerModele('AnnuaireModele');

		$annuaire = $this->AnnuaireModele->chargerAnnuaire($id_annuaire, false);

		$this->chargerModele('MetadonneeModele');

		$metadonnees = $this->MetadonneeModele->chargerListeMetadonneeAnnuaire($id_annuaire);

		$tableau_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

		$valeurs_annuaire = $this->AnnuaireModele->obtenirValeursUtilisateur($id_annuaire, $id_utilisateur,$tableau_mappage[0]);

		$valeurs_metadonnees= $this->MetadonneeModele->chargerListeValeursMetadonneesUtilisateur($id_annuaire, $id_utilisateur);

		foreach($tableau_mappage[0] as $cle => $nom_champ) {

			if($cle != 'champ_id') {

				$nom_champ_formulaire = $metadonnees[$tableau_mappage[1][$cle]]['amc_abreviation'];

				$valeur = $valeurs_annuaire[$nom_champ] ;

				if(isset($valeurs_metadonnees[$nom_champ_formulaire])) {

					if(isset($valeurs_metadonnees[$nom_champ_formulaire]['amv_valeur']) && $valeurs_metadonnees[$nom_champ_formulaire]['amv_valeur'] != '') {

						$valeur = $valeurs_metadonnees[$nom_champ_formulaire]['amv_valeur'];

					}

					$informations_champ = array('amv_valeur' => $valeur,'amc_id_champ' => $tableau_mappage[1][$cle]) ;

					$valeurs_metadonnees[$nom_champ_formulaire] = array_merge($valeurs_metadonnees[$nom_champ_formulaire],$informations_champ);

				} else {

					$informations_champ = array('amv_valeur' => $valeur,'amc_id_champ' => $tableau_mappage[1][$cle]) ;

					$valeurs_metadonnees[$nom_champ_formulaire] = $informations_champ;

				}

			}

		}

		foreach($valeurs_metadonnees as $nom_champ => $valeur) {

			$verificateur = new VerificationControleur();

			$valeurs_metadonnees[$nom_champ] = $verificateur->verifierEtRemplacerValeurChampPourAffichage($valeur['amc_ce_type_affichage'],$valeur, 1);

		}

		return $valeurs_metadonnees;

	}

	public function obtenirInfosUtilisateurOpenId($id_annuaire,$id, $mail = true) {

		$this->chargerModele('AnnuaireModele');

		if($mail) {

			$id = $this->AnnuaireModele->obtenirIdParMail($id_annuaire,$id);

		}

		$champs_mappage = $this->AnnuaireModele->obtenirChampsMappageAnnuaire($id_annuaire);

		$valeurs = $this->AnnuaireModele->obtenirValeursUtilisateur($id_annuaire,$id, $champs_mappage[0]);

		// TODO: valeurs incomplètes, voir ce qu'on renvoie obligatoirement

		// et ce qu'on ne renvoie pas

		$valeurs_open_id = array('fullname' => $valeurs[$champs_mappage[0]['champ_nom']].' '.$valeurs[$champs_mappage[0]['champ_prenom']],

                           'nickname' => $valeurs[$champs_mappage[0]['champ_nom']],

                           'dob' => '25/10/1984',

                           'email' => $valeurs[$champs_mappage[0]['champ_mail']],

                           'gender' => 'M',

                           'postcode' => $valeurs[$champs_mappage[0]['champ_code_postal']],

                           'country' => 'FR',

                           'language' => 'fr',

                           'timezone' => 'Europe/Paris');

		return $valeurs_open_id;

	}

	public function comparerIdentifiantMotDePasse($id_annuaire,$id_utilisateur,$mot_de_passe, $utilise_mail = true, $mdp_deja_crypte = true) {

		$this->chargerModele('AnnuaireModele');

		if($utilise_mail) {

			$id_utilisateur = $this->AnnuaireModele->obtenirIdParMail($id_annuaire,$id_utilisateur);

		}

		if(!$mdp_deja_crypte) {

			$mot_de_passe = VerificationControleur::encrypterMotDePasseStatic($mot_de_passe);

		}

		return $this->AnnuaireModele->comparerIdentifiantMotDePasse($id_annuaire,$id_utilisateur,$mot_de_passe);

	}

}