Subversion Repositories eFlore/Applications.eflore-consultation

Rev

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