Subversion Repositories Applications.annuaire

Rev

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

Rev Author Line No. Line
332 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
333 jpm 4
 * Service retournant les prénoms et nom  d'un utilisateur en fonction de son courriel.
5
 * UNe liste de courriel peut être passé dans la ressource.
6
 * Exemple :
7
 * /utilisateur/Prenom-nom-par-courriel/jpm@tela-botanica.org,aurelien@tela-botanica.org
332 jpm 8
 *
9
 * @category	php 5.2
10
 * @package		Annuaire::Services
11
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
12
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
13
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
14
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
15
 * @version		$Id$
16
 */
17
class Utilisateur extends JRestService {
391 jpm 18
 
348 jpm 19
	private $donnees = null;
344 jpm 20
	private $idAnnuaire = null;
348 jpm 21
	private $utilisateurId = null;
344 jpm 22
	private $metadonneeModele = null;
23
	private $annuaireModele = null;
348 jpm 24
	private $messagerieModele = null;
391 jpm 25
 
394 jpm 26
	/*+----------------------------------------------------------------------------------------------------+*/
27
	// GET : consultation
28
 
332 jpm 29
	public function getElement($ressources){
30
		$this->ressources = $ressources;
344 jpm 31
		$this->idAnnuaire = Config::get('annuaire_defaut');
332 jpm 32
		$infos = null;
391 jpm 33
 
332 jpm 34
		if (isset($this->ressources[0])) {
451 jpm 35
			if (preg_match('/^[0-9]+$/', $this->ressources[0])) {
450 jpm 36
				// ATTENTION : Ces web services ne doivent être accessible que depuis des applis installées sur nos serveurs
37
				// pour les communications inter-serveurs.
38
				$this->controlerIpAutorisees();
39
				$infos = $this->getInfosParId($this->ressources[0]);
332 jpm 40
			} else {
450 jpm 41
				$methode_demande = array_shift($this->ressources);
42
				$methode = $this->traiterNomMethodeGet($methode_demande);
43
				if (method_exists($this, $methode)) {
44
					$infos = $this->$methode();
45
				} else {
46
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete GET.";
47
				}
332 jpm 48
			}
49
		} else {
50
			$this->messages[] = "Le premier paramêtre du chemin du service doit correspondre au type de ressource demandée.";
51
		}
52
 
53
		if (!is_null($infos)) {
54
			$this->envoyerJson($infos);
55
		} else {
56
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
57
			$this->envoyerTxt($info);
58
		}
59
	}
391 jpm 60
 
450 jpm 61
 
348 jpm 62
	/**
450 jpm 63
	 * Permet d'obtenir des infos pour un id utilisateur indiqué dans la ressource.
64
	 * RESSOURCE : /utilisateur/#id
65
	 * PARAMÊTRES : aucun
66
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
67
	 *  - id : identifiant numérique de l'utilisateur
68
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
69
	 *  - pseudo : pseudo de l'utilisateur.
70
	 *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
71
	 *  - prenom : prénom
72
	 *  - nom : nom de famille.
73
	 *  - courriel : courriel
74
	 */
75
	public function getInfosParId($id_utilisateur) {
452 jpm 76
		$infos = $this->getAnnuaire()->obtenirInfosUtilisateurParId($this->idAnnuaire, $id_utilisateur);
450 jpm 77
 
452 jpm 78
		$infos['pseudoUtilise'] = $this->obtenirPseudoUtilise($id_utilisateur);
79
		$infos['pseudo'] = $this->obtenirPseudo($id_utilisateur);
453 jpm 80
		$infos['intitule'] = $this->formaterIntitule($infos);
450 jpm 81
 
452 jpm 82
		return $infos;
450 jpm 83
	}
84
 
85
	/**
348 jpm 86
	 * Permet d'obtenir les prénoms et noms des courriels des utilisateurs indiqués dans la ressource.
87
	 * RESSOURCE : /utilisateur/prenom-nom-par-courriel/[courriel,courriel,...]
391 jpm 88
	 * PARAMÊTRES : aucun
348 jpm 89
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
90
	 *  - id : identifiant numérique de l'utilisateur
91
	 *  - prenom : prénom
92
	 *  - nom : nom de famille.
93
	 */
332 jpm 94
	public function getPrenomNomParCourriel() {
95
		$courriels = explode(',', $this->ressources[0]);
344 jpm 96
		$infos = $this->getAnnuaire()->obtenirPrenomNomParCourriel($this->idAnnuaire, $courriels);
408 jpm 97
		$infous_courriel_minuscule = array();
98
		foreach ($infos as $courriel => $utilisateur) {
99
			$courriel = strtolower($courriel);
100
			$infous_courriel_minuscule[$courriel] = $utilisateur;
101
		}
332 jpm 102
		return $infos;
103
	}
391 jpm 104
 
348 jpm 105
	/**
106
	 * Permet d'obtenir les identités des utilisateurs indiqués dans la ressource.
107
	 * RESSOURCE : /utilisateur/identite-par-courriel/[courriel,courriel,...]
391 jpm 108
	 * PARAMÊTRES : aucun
348 jpm 109
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
110
	 *  - id : identifiant numérique de l'utilisateur
111
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
112
	 *  - pseudo : pseudo de l'utilisateur.
113
	 *  - prenom : prénom
114
	 *  - nom : nom de famille.
115
	 */
344 jpm 116
	public function getIdentiteParCourriel() {
378 aurelien 117
		$infos_utilisateurs = array();
413 jpm 118
		$utilisateurs = $this->getPrenomNomParCourriel();
344 jpm 119
		foreach ($utilisateurs as $courriel => $utilisateur) {
120
			$id = $utilisateur['id'];
121
			$utilisateur['pseudo'] = $this->obtenirPseudo($id);
122
			$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
123
			$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
408 jpm 124
			$infos_utilisateurs[$courriel] = $utilisateur;
344 jpm 125
		}
378 aurelien 126
		return $infos_utilisateurs;
344 jpm 127
	}
391 jpm 128
 
344 jpm 129
	private function getAnnuaire() {
130
		if (!isset($this->annuaireModele)) {
131
			$this->annuaireModele = new AnnuaireModele();
132
		}
133
		return $this->annuaireModele;
134
	}
391 jpm 135
 
344 jpm 136
	private function getMeta() {
137
		if (!isset($this->metadonneeModele)) {
138
			$this->metadonneeModele = new MetadonneeModele();
139
		}
140
		return $this->metadonneeModele;
141
	}
391 jpm 142
 
344 jpm 143
	private function obtenirPseudo($id_utilisateur) {
144
		$pseudo = '';
145
		$id_champ_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'pseudo');
146
		if ($this->getMeta()->valeurExiste($id_champ_pseudo, $id_utilisateur)) {
147
			$pseudo = $this->getMeta()->obtenirValeurMetadonnee($id_champ_pseudo, $id_utilisateur);
148
		}
149
		return $pseudo;
150
	}
391 jpm 151
 
344 jpm 152
	private function obtenirPseudoUtilise($id_utilisateur) {
153
		$pseudo_utilise = false;
154
		$id_champ_utilise_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'utilise_pseudo');
155
		if ($this->getMeta()->valeurExiste($id_champ_utilise_pseudo, $id_utilisateur)) {
156
				$booleen = $this->getMeta()->obtenirValeurMetadonnee($id_champ_utilise_pseudo, $id_utilisateur);
157
				$pseudo_utilise = ($booleen == 0) ? false : true;
158
		}
159
		return $pseudo_utilise;
160
	}
391 jpm 161
 
344 jpm 162
	private function formaterIntitule($utilisateur) {
163
		$intitule = '';
345 jpm 164
		if ($utilisateur['pseudoUtilise'] && trim($utilisateur['pseudo']) != '') {
344 jpm 165
			$intitule = $utilisateur['pseudo'];
166
		} else {
167
			$intitule = $utilisateur['prenom'].' '.$utilisateur['nom'];
168
		}
169
		return $intitule;
170
	}
391 jpm 171
 
394 jpm 172
	/*+----------------------------------------------------------------------------------------------------+*/
173
	// POST : mise à jour
174
 
348 jpm 175
	public function updateElement($ressources, $donnees) {
176
		$this->ressources = $ressources;
177
		$this->donnees = $donnees;
178
		$this->idAnnuaire = Config::get('annuaire_defaut');
391 jpm 179
 
348 jpm 180
		$infos = null;
181
		if (isset($this->ressources[0])) {
182
			$this->utilisateurId = array_shift($this->ressources);
183
			if (isset($this->ressources[0])) {
184
				$methode_demande = array_shift($this->ressources);
185
				$methode = $this->traiterNomMethodePost($methode_demande);
186
				if (method_exists($this, $methode)) {
187
					$infos = $this->$methode();
188
				} else {
189
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete POST.";
190
				}
191
			} else {
192
				$this->messages[] = "La seconde ressource du service pour les requêtes POST doit correspondre au type de ressource demandée.";
193
			}
194
		} else {
195
			$this->messages[] = "La première ressource du service pour les requêtes POST doit être l'identifiant de l'utilisateur.";
196
		}
197
 
198
		if (!is_null($infos)) {
199
			$this->envoyerJson($infos);
200
		} else {
201
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
202
			$this->envoyerTxt($info);
203
		}
204
	}
391 jpm 205
 
348 jpm 206
	/**
207
	 * Permet d'envoyer un message à un utilisateur.
208
	 * RESSOURCE : /utilisateur/[id]/message
391 jpm 209
	 * POST :
348 jpm 210
	 *  - sujet : contient le sujet du message à envoyer.
211
	 *  - message : contient le contenu du message à envoyer.
455 jpm 212
	 *  - message_txt : (optionnel) si format HTML, peut contenir le contenu du message au format texte comme alternative au HTML à envoyer.
213
	 *		Sinon le texte est extrait du HTML (attention à la mise en page!).
348 jpm 214
	 *  - utilisateur_courriel : contient le courriel de l'utilisateur qui envoie le message (Il doit être
422 jpm 215
	 *		inscrit dans l'annuaire par défaut de Tela Botanica).
348 jpm 216
	 *  - copies : peut contenir une liste de courriels séparés par des virguels auxquels une copie du
422 jpm 217
	 *		message sera envoyée.
218
	 *  - format (optionnel) : text ou html
348 jpm 219
	 * RÉPONSE :
220
	 *  - message : contient le message d'information concernant l'envoie.
221
	 */
222
	private function updateMessage() {
223
		$destinataireId = $this->utilisateurId;//$this->donnees['destinataire_id'];
224
		$sujet = stripslashes($this->donnees['sujet']);
225
		$contenu = stripslashes($this->donnees['message']);
455 jpm 226
		$contenuTxt = (isset($this->donnees['message_txt'])) ? $this->donnees['message_txt'] : null;
348 jpm 227
		$envoyeur = $this->donnees['utilisateur_courriel'];
228
		$copies = array_key_exists('copies', $this->donnees) ? explode(',', $this->donnees['copies']) : null;
388 aurelien 229
		$format = isset($this->donnees['format']) ? $this->donnees['format'] : 'text';
391 jpm 230
 
348 jpm 231
		$info = null;
388 aurelien 232
		if ($this->estAutoriseMessagerie($envoyeur) || $this->getAnnuaire()->utilisateurExisteParMail($this->idAnnuaire, $envoyeur)) {
410 aurelien 233
			// il est possible de passer directement un email ou bien un id utilisateur
234
			if(filter_var($destinataireId, FILTER_VALIDATE_EMAIL)) {
235
				$destinataire = $destinataireId;
236
			} else {
237
				$destinataire = $this->getAnnuaire()->obtenirMailParId($this->idAnnuaire, $destinataireId);
238
			}
348 jpm 239
			if ($destinataire) {
422 jpm 240
				if ($format == 'html') {
455 jpm 241
					if (isset($contenuTxt)) {
242
						$envoie = $this->getMessagerie()
243
							->envoyerMail($envoyeur, $destinataire, $sujet, $contenu, $contenuTxt);
244
					} else {
245
						$envoie = $this->getMessagerie()
246
							->envoyerMail($envoyeur, $destinataire, $sujet, $contenu);
247
					}
388 aurelien 248
				} else {
249
					$envoie = $this->getMessagerie()->envoyerMailText($envoyeur, $destinataire, $sujet, $contenu);
250
				}
348 jpm 251
				if ($envoie) {
252
					$info['message'] = "Votre message a bien été envoyé.";
253
					foreach ($copies as $copie) {
254
						$sujet = '[COPIE] '.$sujet;
255
						$contenu = "Message original envoyé par $envoyeur pour $destinataire.\n--\n".$contenu;
256
						$this->getMessagerie()->envoyerMailText($envoyeur, $copie, $sujet, $contenu);
257
					}
258
				} else {
259
					$info['message'] = "Le message n'a pas pu être envoyé.";
260
				}
261
			} else {
262
				$info['message'] = "Aucun courriel ne correspond à l'id du destinataire.";
263
			}
264
		} else {
265
			$info['message'] = "Vous n'êtes pas inscrit à Tela Botanica avec le courriel : $envoyeur.\n".
352 jpm 266
				"Veuillez saisir votre courriel d'inscription ou vous inscrire à Tela Botanica.";
348 jpm 267
		}
268
		return $info;
269
	}
391 jpm 270
 
348 jpm 271
	private function getMessagerie() {
272
		if (!isset($this->messagerieModele)) {
273
			$this->messagerieModele = new MessageControleur();
274
		}
275
		return $this->messagerieModele;
276
	}
391 jpm 277
 
394 jpm 278
	/*+----------------------------------------------------------------------------------------------------+*/
279
	// PUT : ajout
280
 
281
	public function createElement($donnees) {
282
		$this->donnees = $donnees;
283
		$this->idAnnuaire = Config::get('annuaire_defaut');
284
 
285
		$infos = null;
286
		if (isset($this->donnees['methode'])) {
287
			$methode_demande = $this->donnees['methode'];
288
			$methode = $this->traiterNomMethodePut($methode_demande);
289
			if (method_exists($this, $methode)) {
290
				$infos = $this->$methode();
291
			} else {
292
				$this->messages[] = "Ce type de méthode '$methode_demande' n'est pas disponible pour la requete PUT.";
293
			}
294
		} else {
295
			$this->messages[] = "Ce service n'est pas implémanté.";
296
		}
297
 
298
		if (!is_null($infos)) {
299
			$this->envoyerJson($infos);
300
		} else {
301
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
302
			$this->envoyerTxt($info);
303
		}
304
	}
305
 
306
	/**
307
	 * Permet d'identifier un utilisateur.
308
	 * RESSOURCE : /utilisateur
309
	 * POST :
310
	 *  - methode = 'connexion' : methode doit valoir 'connexion' pour connecter l'utilisateur.
311
	 *  - courriel : contient le courriel de l'utilisateur .
312
	 *  - mdp : le mot de passe de l'utilisateur.
396 jpm 313
	 *  - persistance : true si on veut laisser l'utilisateur connecté au delà de la session sinon false
394 jpm 314
	 * RÉPONSE :
315
	 *  - identifie : indiquer si l'utilisateur a été identifié (true) ou pas (false)
316
	 *  - message : contient un message d'information complémentaire de l'état.
317
	 */
318
	private function createConnexion() {
319
		$courriel = stripslashes($this->donnees['courriel']);
320
		$mdp = stripslashes($this->donnees['mdp']);
399 jpm 321
		$persistance = (stripslashes($this->donnees['persistance']) == 'true') ? true : false;
394 jpm 322
 
323
		$infos = null;
399 jpm 324
		$infos['persistance'] = $persistance;
394 jpm 325
		if ($this->verifierAcces($courriel, $mdp)) {
326
			$infos['identifie'] = true;
327
			$infos['message'] = "Bienvenu.";
396 jpm 328
			$dureeCookie = 0;
399 jpm 329
			if ($persistance === true) {
396 jpm 330
				$dureeCookie = time()+3600*24*30;
331
				$this->creerCookiePersistant($dureeCookie, $courriel, $mdp);
332
			}
333
			$this->creerCookieUtilisateur($dureeCookie, $courriel);
334
			$infos['message'] = $_COOKIE;
394 jpm 335
		} else {
336
			$infos['identifie'] = false;
337
			$infos['message'] = "Le courriel ou le mot de passe saisi est incorrect.";
338
		}
339
		return $infos;
340
	}
332 jpm 341
}
333 jpm 342
?>