Obsługa logowania użytkownika

Do skorzystania z tej funkcjonalności niezbędne jest zaimplementowanie obsługi sesji po stronie własnego serwera web.

Funkcja getLoggedUserData(callBack)

Przyjmowane parametry

callBack - Funkcja wywoływana po pobraniu wyników,
- returnStatus - Obiekt statusu odpowiedzi,
- response - Zwrócone dane o zalogowaniu.

W konfiguracji API należy zdefiniować ścieżkę, pod którą dostępne są dane o zalogowaniu:


var cfg = {
  "paths" : {
	"loggedUserData" : {
	  "url" : 'http://moj.host.pl/loggedUserData.php'
	}
  }
};

Następnie należy zdefiniować funkcję, która obsłuży pobraną zawartość:


function loggedUserDataFnc(retStatus, response) {
  if (!retStatus.failed) {
	//wyświetlimy dane pod mapą
	jQuery('#result').show().find('pre').html(jQuery.dump(response, 0, "Dane użytkownika"));
  }
}

I uruchomić funkcjonalność:


DoCelu.getLoggedUserData(loggedUserDataFnc);

Powyższe wywołanie wykona żądanie AJAX'owe w postaci:

http://moj.host.pl/loggedUserData.php?callback=jsonp1241424941463

Po stronie serwera należy obsłużyć powyższy request i zwrócić odpowiedź w formacie:



jsonp1241424941463({
  //czy użytkownik jest zalogowany
  "logged" :  1,
  //czy konto jest aktywne
  "profileState" :  1,
  //login
  "login" :  "jkowalski",
  //adres e-mail
  "mail" :  "jkowalski@wp.pl",
  //imię i nazwisko
  "userNameSurname" :  "Jan Kowalski"
});

jsonp1241424941463 to nazwa wywoływanej funkcji javascriptowej przekazywana w URL'u jako parametr callback. Funkcja przyjmuje jeden parametr z obiektem, który później dostaniemy do funkcji loggedUserDataFnc jako parametr response. Parametr zapisany jest w notacji JSON.

Przykładowy kod i efekt jego zastosowania:


<div id="map" style="width:800px; height:600px; "></div>
<script type="text/javascript">
//<![CDATA[
	jQuery(document).ready(function() {
		var cfg = {
			"paths" : {
				"loggedUserData" : {
					"url" : 'loggedUserData.mock.json'
				}
			}
		};
		function loggedUserDataFnc(retStatus, response) {
			if (!retStatus.failed) {
				//wyświetlimy dane pod mapą
				jQuery('#result').show().find('code').html(jQuery.dump(response, 0, "Dane użytkownika")).chili();
			}
		}

		DoCelu.loadMap(document.getElementById('map'), cfg);
		jQuery('#test').mousedown(function() {
			DoCelu.getLoggedUserData(loggedUserDataFnc);
		});
	});
//]]>
</script>

Wypróbujmy zatem działanie w praktyce

Ten dokument nie wyjaśnia wszystkich wątpliwości? Szczegółowa dokumentacja techniczna API DoCelu.pl

Sprawdź toczące się dyskusje na Forum API DoCelu.pl