Subversion Repositories eFlore/Applications.eflore-consultation

Rev

Rev 494 | Rev 912 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
10 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
 * Classe abstraite dont chaque controleur de l'application doit hériter.
5
 *
6
 * @category	PHP 5.2
7
 * @package		eflore-consultation
8
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
9
 * @author		Delphine CAUQUIL <delphine@tela-botanica.org>
10
 * @copyright	2011 Tela-Botanica
11
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
12
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
13
 * @version		$Id$
14
 */
15
abstract class aControleur extends Controleur {
106 jpm 16
 
11 jpm 17
	const META_TITRE = 'titre';
18
	const META_DESCRIPTION = 'description';
19
	const META_TAGS = 'tags';
517 jpm 20
	const ENTETE = 'entete';
11 jpm 21
	const RENDU_TETE = 'tete';
22
	const RENDU_CORPS = 'corps';
23
	const RENDU_PIED = 'pied';
14 jpm 24
	const RENDU_NAVIGATION = 'navigation';
25
	const RENDU_MENU = 'menu';
106 jpm 26
 
11 jpm 27
	private $sortie = array();
61 jpm 28
	protected $urlBase = null;
29
	protected $urlCourante = null;
155 delphine 30
	protected $urls = null;
106 jpm 31
 
155 delphine 32
	public function __construct(AppUrls $urls = null)  {
34 jpm 33
		$chemin = Config::get('chemin_modules').
36 jpm 34
			AppControleur::getNomDossierDepuisClasse(get_class($this)).DS.
34 jpm 35
			Config::get('dossier_squelettes').DS;
36
		Registre::set('tbf.chemin_squelettes', $chemin);
106 jpm 37
 
61 jpm 38
		$this->urlBase = Registre::get('eFlore.urlBase');
39
		$this->urlCourante = Registre::get('eFlore.urlCourante');
40
		$this->urlRedirection = Registre::get('eFlore.urlRedirection');
155 delphine 41
		$this->urls = (is_null($urls)) ? new AppUrls() : $urls;
494 jpm 42
 
11 jpm 43
		parent::__construct();
44
	}
106 jpm 45
 
61 jpm 46
	//+------------------------------------------------------------------------------------------------------+
47
	// GESTION de l'AFFICHAGE en SORTIE
106 jpm 48
 
11 jpm 49
	/**
50
 	* Attribue une position de sortie à un contenu.
51
 	*/
52
	protected function setSortie($position, $contenu, $fusionner = false) {
53
		if ($this->verifierExistenceTypeSortie($position)) {
54
			if ($fusionner) {
79 jpm 55
				if (isset($this->sortie[$position])) {
56
					$this->sortie[$position] .= $contenu;
57
				} else {
58
					$this->sortie[$position] = $contenu;
59
				}
11 jpm 60
			} else {
61
				$this->sortie[$position] = $contenu;
62
			}
63
		}
64
	}
106 jpm 65
 
11 jpm 66
	/**
67
	 * Vérifie l'existence du type de sortie indiqué pour son utilisation dans le tableau de sortie.
68
	 * @param string le type de sortie à tester.
69
	 * @return bool true si le type de sortie est valide, sinon false.
70
	 */
71
	private function verifierExistenceTypeSortie($type) {
72
		$existe = true;
73
		if ($type != self::RENDU_TETE &&
74
			$type != self::RENDU_CORPS &&
75
			$type != self::RENDU_PIED &&
14 jpm 76
			$type != self::RENDU_NAVIGATION &&
77
			$type != self::RENDU_MENU &&
517 jpm 78
			$type != self::ENTETE &&
11 jpm 79
			$type != self::META_TITRE &&
80
			$type != self::META_DESCRIPTION &&
81
			$type != self::META_TAGS) {
82
			trigger_error("Le type de sortie '$type' n'est pas une valeur prédéfinie.", E_USER_WARNING);
83
			$existe = false;
84
		}
85
		return $existe;
86
	}
106 jpm 87
 
11 jpm 88
	/**
89
	 * Retourne le tableau de sortie à utiliser dans le controleur principal de l'application.
90
	 */
91
	public function getSortie() {
92
		return $this->sortie;
93
	}
10 jpm 94
 
11 jpm 95
	/**
61 jpm 96
	 * Fusionne un tableau de sortie par défaut avec le tableau passé en paramêtre.
97
	 * @param array le tableau à fusionner
98
	 */
79 jpm 99
	private function fusionnerSortie($nouvelleSortie) {
100
		$sortieActuelle = $this->getSortie();
101
		foreach ($nouvelleSortie as $position => $nouveauContenu) {
102
			if ($nouveauContenu != '') {
103
				$contenuPrecedent = isset($sortieActuelle[$position]) ? $sortieActuelle[$position] : null;
104
				if ($nouveauContenu != $contenuPrecedent) {
105
					$this->setSortie($position, $nouveauContenu, true);
106
				}
107
			}
108
		}
61 jpm 109
	}
110
 
111
	/**
11 jpm 112
	 * Execute l'action d'un module donnée et fusionne le résultat avec le tableau de sortie.
41 jpm 113
	 * Permet à une action d'un module donnée de charger le résultat d'une autre action de module.
11 jpm 114
	 */
216 delphine 115
	protected function executerAction($ClasseModule, $action, $parametres = array()) {
11 jpm 116
		$module = new $ClasseModule();
79 jpm 117
		$sortiePrecedente = $this->getSortie();
83 jpm 118
		// Initialisation du module demandé
119
		if (method_exists($module, 'initialiser')) {
120
			$module->initialiser();
121
		}
122
		// Lancement de l'action demandé du module chargé
123
		if (method_exists($module, $action)) {
216 delphine 124
			if (isset($parametres)) {
125
				$module->$action($parametres);
126
			} else {
127
				$module->$action();
128
			}
83 jpm 129
			$nouvelleSortie = $module->getSortie();
130
			$this->fusionnerSortie($nouvelleSortie);
131
		} else {
132
			$m = "La méthode '$action' du controleur '$ClasseModule' est introuvable.";
133
			trigger_error($m, E_USER_ERROR);
106 jpm 134
		}
11 jpm 135
	}
106 jpm 136
 
61 jpm 137
	//+------------------------------------------------------------------------------------------------------+
138
	// GESTION du VUES COMMUNES
11 jpm 139
	/**
106 jpm 140
	 * Charge un squelette de vue depuis l'emplacement commune.
41 jpm 141
	 * @param String $tpl le nom du squelette à charger sans l'extenssion de fichier.
142
	 * @param Array $donnees les données à passer au squelette PHP.
143
	 */
144
	private function getVueCommune($tpl, $donnees) {
145
		$cheminOrigine = $this->getCheminSquelette();
146
		$this->setCheminSquelette(Config::get('chemin_squelettes'));
147
		$vue = $this->getVue($tpl, $donnees);
148
		$this->setCheminSquelette($cheminOrigine);
149
		return $vue;
150
	}
106 jpm 151
 
41 jpm 152
	/**
11 jpm 153
	 * Pour mutualiser la création du pied de page de l'application, sa gestion est gérée dans cette classe.
154
	 */
47 jpm 155
	public function chargerEnteteGeneral() {
11 jpm 156
		$donnees['appli'] = Framework::getInfoAppli();
41 jpm 157
		$donnees['i18n'] = array_merge(I18n::get('Entete'), I18n::get('General'));
158
		$donnees['referentiel_titre'] = I18n::get('Referentiels-titres.'.Registre::get('parametres.referentiel'));
106 jpm 159
 
41 jpm 160
		$this->setSortie(self::RENDU_TETE, $this->getVueCommune('entete_page', $donnees));
161
	}
106 jpm 162
 
41 jpm 163
	/**
47 jpm 164
	 * Pour mutualiser la création du menu de l'application, sa gestion est gérée dans cette classe.
165
	 */
166
	public function chargerMenuGeneral() {
167
		$donnees['appli'] = Framework::getInfoAppli();
168
		$donnees['i18n'] = array_merge(I18n::get('Pied'), I18n::get('General'));
169
		$donnees['courrielContact'] = Config::get('courriel_contact');
106 jpm 170
 
47 jpm 171
		$this->setSortie(self::RENDU_MENU, $this->getVueCommune('menu', $donnees));
172
	}
106 jpm 173
 
47 jpm 174
	/**
41 jpm 175
	 * Pour mutualiser la création du pied de page de l'application, sa gestion est gérée dans cette classe.
176
	 */
47 jpm 177
	public function chargerPiedGeneral() {
41 jpm 178
		$donnees['appli'] = Framework::getInfoAppli();
27 jpm 179
		$donnees['i18n'] = array_merge(I18n::get('Pied'), I18n::get('General'));
41 jpm 180
		$donnees['courrielContact'] = Config::get('courriel_contact');
106 jpm 181
 
41 jpm 182
		$this->setSortie(self::RENDU_PIED, $this->getVueCommune('pied_page', $donnees));
11 jpm 183
	}
106 jpm 184
 
61 jpm 185
	//+------------------------------------------------------------------------------------------------------+
186
	// GESTION du CHARGEMENT des CLASSES MÉTIERS
187
	protected function getEfloreNoms() {
188
		if (! isset($this->EfloreNoms)) {
189
			$this->EfloreNoms = new Noms();
27 jpm 190
		}
61 jpm 191
		return $this->EfloreNoms;
192
	}
106 jpm 193
 
61 jpm 194
	protected function getEfloreTaxons() {
195
		if (! isset($this->EfloreTaxons)) {
196
			$this->EfloreTaxons = new Taxons();
197
		}
198
		return $this->EfloreTaxons;
199
	}
106 jpm 200
 
155 delphine 201
	public function obtenirUrlBase() {
61 jpm 202
		$url = $this->urlBase->getURL();
27 jpm 203
		return $url;
204
	}
494 jpm 205
 
155 delphine 206
	public function redirigerVers($url) {
69 delphine 207
		$url = str_replace('&amp;', '&', $url);
208
		header("Location: $url");
209
	}
494 jpm 210
 
155 delphine 211
	public function getParametresUrlListe() {
61 jpm 212
		$parametres = array(
155 delphine 213
					'referentiel' => Registre::get('parametres.referentiel'),
214
					'module' => 'liste',
215
					'action' => 'liste',
216
					'rang' => $this->rang,
217
					'lettre' => $this->lettre
61 jpm 218
		);
219
		return $parametres;
220
	}
494 jpm 221
 
155 delphine 222
	public function obtenirUrlListeFamille() {
61 jpm 223
		$parametres = $this->getParametresUrlListe();
224
		$parametres['rang'] = 'F';
225
		$this->urlBase->setRequete($parametres);
226
		$url = $this->urlBase->getURL();
227
		return $url;
228
	}
494 jpm 229
 
155 delphine 230
	public function obtenirUrlListeGenre() {
61 jpm 231
		$parametres = $this->getParametresUrlListe();
232
		$parametres['rang'] = 'G';
233
		$this->urlBase->setRequete($parametres);
234
		$url = $this->urlBase->getURL();
235
		return $url;
236
	}
106 jpm 237
 
494 jpm 238
 
239
 
155 delphine 240
	public function getParametresUrlResultat() {
69 delphine 241
		$parametres = array(
155 delphine 242
					'referentiel' => Registre::get('parametres.referentiel'),
243
					'module' => 'recherche',
244
					'action' => Registre::get('parametres.action'),
245
					'submit' => 'Rechercher',
246
					'type_nom' => isset($_GET['type_nom']) ? $_GET['type_nom'] : 'nom_scientifique',
247
					'nom' => isset($_GET['nom']) ? $_GET['nom'] : ''
69 delphine 248
		);
249
		return $parametres;
250
	}
494 jpm 251
 
155 delphine 252
	public function obtenirUrlResultatDetermination() {
83 jpm 253
		$parametres = $this->getParametresUrlResultat();
106 jpm 254
		$parametres['resultat'] = 'determination';
83 jpm 255
		$this->urlBase->setRequete($parametres);
256
		$url = $this->urlBase->getURL();
257
		return $url;
258
	}
494 jpm 259
 
155 delphine 260
	public function obtenirUrlResultatAlphab() {
106 jpm 261
		$parametres = $this->getParametresUrlResultat();
262
		$parametres['resultat'] = 'alphab';
263
		$this->urlBase->setRequete($parametres);
264
		$url = $this->urlBase->getURL();
265
		return $url;
266
	}
494 jpm 267
 
155 delphine 268
	public function obtenirUrlResultatRetenu() {
83 jpm 269
		$parametres = $this->getParametresUrlResultat();
270
		$parametres['resultat'] = 'retenu';
271
		$this->urlBase->setRequete($parametres);
272
		$url = $this->urlBase->getURL();
273
		return $url;
274
	}
494 jpm 275
 
155 delphine 276
	public function obtenirUrlResultatDecompo() {
95 delphine 277
		$parametres = $this->getParametresUrlResultat();
106 jpm 278
		$parametres['resultat'] = 'decompo';
95 delphine 279
		$this->urlBase->setRequete($parametres);
280
		$url = $this->urlBase->getURL();
281
		return $url;
282
	}
106 jpm 283
 
494 jpm 284
 
10 jpm 285
}
286
?>