Easy-to-use Facebook wrapper for Nette Framework (opens new window).

# Content

# Setup

composer require contributte/facebook
1
extensions:
	facebook: Contributte\Facebook\DI\Nette\FacebookExtension
1
2

# Configuration

You need to create a FacebookApp and supply these parameters:

  • appId
  • appSecret
  • defaultGraphVersion (optional)
  • persistentDataHandler (optional) default value: session
  • httpClientHandler (optional)
facebook:
	appId: %yourAppId%
	appSecret: %yourAppSecret%
1
2
3

# Usage

Simple example how to use Facebook Login in Presenter

namespace App\Presenters;

use Contributte\Facebook\Exceptions\FacebookLoginException;
use Contributte\Facebook\FacebookLogin;
use Nette\Application\Responses\RedirectResponse;
use Nette\Application\UI\Presenter;
use Nette\Security\AuthenticationException;

final class SignPresenter extends Presenter
{

	/** @var FacebookLogin @inject */
	public $facebookLogin;

	public function actionFacebook()
	{
		// Redirect to FB and ask customer to grant access to his account
		$url = $this->facebookLogin->getLoginUrl($this->link('//facebookAuthorize'), ['email', 'public_profile']);
		$this->sendResponse(new RedirectResponse($url));
	}

	/**
	 * Log in user with accessToken obtained after redirected from FB
	 *
	 * @return void
	 */
	public function actionFacebookAuthorize()
	{
		// Fetch User data from FB and try to login
		try {
			$token = $this->facebookLogin->getAccessToken();

			$this->user->login('facebook', $this->facebookLogin->getMe($token, ['first_name', 'last_name', 'email', 'gender']));
			$this->flashMessage('Login successful :-).', 'success');
		} catch (FacebookLoginException | AuthenticationException $e) {
			$this->flashMessage('Login failed. :-( Try again.', 'danger');
		}
	}

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

If you need to specify your own state param (more info here (opens new window) mind also checking Enable Strict Mode). Facebook::getLoginUrl() takes optional third parameter $stateParam which FB passes back unchanged.

# JavaScript

You can also use FB login button, for example:

<div
    class="fb-login-button"
    onlogin="fbAfterLogin()"
    data-width="200"
    data-max-rows="1"
    data-size="medium"
    data-button-type="continue_with"
    data-show-faces="false"
    data-auto-logout-link="false"
    data-use-continue-as="true"
    data-scope="email,public_profile"
>
Login
</div>
1
2
3
4
5
6
7
8
9
10
11
12
13
14

And use onlogin event to call backend code which takes care of registration/login process:

/**
 * Log in user with accessToken from cookie/session after javascript authorization
 */
public function actionFacebookCookie()
{
	// Fetch User data from FB and try to login
	try {
		$token = $this->facebookLogin->getAccessTokenFromCookie();

		$this->user->login('facebook', $this->facebookLogin->getMe($token, ['first_name', 'last_name', 'email', 'gender']));
		$this->flashMessage('Login successful :-).', 'success');
	} catch (FacebookLoginException | AuthenticationException $e) {
		$this->flashMessage('Login failed. :-( Try again.', 'danger');
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15