Contributte Facebook
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
2
If you are using PHP 8.0+, you need to use forked version of facebook/graph-sdk. You can rely on our fork holyfork/facebook-graph-sdk (opens new window), it's tested and working.
{
"repositories": [
{ "type": "git", "url": "https://github.com/holyfork/facebook-graph-sdk" }
]
}
1
2
3
4
5
2
3
4
5
# 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
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->getValue(), ['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
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
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15