class SimpleFbConnectFbManager in Simple FB Connect 8.3

Contains all Simple FB Connect logic that is related to Facebook interaction.

Hierarchy

• class \Drupal\simple_fb_connect\SimpleFbConnectFbManager

2 files declare their use of SimpleFbConnectFbManager

SimpleFbConnectController.php in src/Controller/SimpleFbConnectController.php

SimpleFbConnectFbManagerTest.php in tests/src/Unit/SimpleFbConnectFbManagerTest.php

1 string reference to 'SimpleFbConnectFbManager'

simple_fb_connect.services.yml in ./simple_fb_connect.services.yml

simple_fb_connect.services.yml

1 service uses SimpleFbConnectFbManager

simple_fb_connect.fb_manager in ./simple_fb_connect.services.yml

Drupal\simple_fb_connect\SimpleFbConnectFbManager

File

src/SimpleFbConnectFbManager.php, line 18

Namespace

Drupal\simple_fb_connect

class SimpleFbConnectFbManager {
  protected $loggerFactory;
  protected $eventDispatcher;
  protected $entityFieldManager;
  protected $urlGenerator;
  protected $persistentDataHandler;
  protected $facebook;

  /**
   * Constructor.
   *
   * @param \Drupal\Core\Logger\LoggerChannelFactoryInterface $logger_factory
   *   Used for logging errors.
   * @param \Symfony\Component\EventDispatcher\EventDispatcherInterface $event_dispatcher
   *   Used for dispatching events to other modules.
   * @param \Drupal\Core\Entity\EntityFieldManagerInterface $entity_field_manager
   *   Used for accessing Drupal user picture preferences.
   * @param \Drupal\Core\Routing\UrlGeneratorInterface $url_generator
   *   Used for generating absoulute URLs.
   * @param \Drupal\simple_fb_connect\SimpleFbConnectPersistentDataHandler $persistent_data_handler
   *   Used for reading data from and writing data to session.
   */
  public function __construct(LoggerChannelFactoryInterface $logger_factory, EventDispatcherInterface $event_dispatcher, EntityFieldManagerInterface $entity_field_manager, UrlGeneratorInterface $url_generator, SimpleFbConnectPersistentDataHandler $persistent_data_handler) {
    $this->loggerFactory = $logger_factory;
    $this->eventDispatcher = $event_dispatcher;
    $this->entityFieldManager = $entity_field_manager;
    $this->urlGenerator = $url_generator;
    $this->persistentDataHandler = $persistent_data_handler;
    $this->facebook = NULL;
  }

  /**
   * Dependency injection setter for Facebook service.
   *
   * @param \Facebook\Facebook $facebook
   *   Facebook service.
   */
  public function setFacebookService(Facebook $facebook) {
    $this->facebook = $facebook;
  }

  /**
   * Returns the Facebook login URL where user will be redirected.
   *
   * @return string
   *   Absolute Facebook login URL where user will be redirected
   */
  public function getFbLoginUrl() {
    $login_helper = $this->facebook
      ->getRedirectLoginHelper();

    // Define the URL where Facebook should return the user.
    $return_url = $this->urlGenerator
      ->generateFromRoute('simple_fb_connect.return_from_fb', [], [
      'absolute' => TRUE,
    ]);

    // Define the initial array of Facebook permissions.
    $scope = [
      'public_profile',
      'email',
    ];

    // Dispatch an event so that other modules can modify the permission scope.
    // Set the scope twice on the event: as the main subject but also in the
    // list of arguments.
    $e = new GenericEvent($scope, [
      'scope' => $scope,
    ]);
    $event = $this->eventDispatcher
      ->dispatch('simple_fb_connect.scope', $e);
    $final_scope = $event
      ->getArgument('scope');

    // Generate and return the URL where we should redirect the user.
    return $login_helper
      ->getLoginUrl($return_url, $final_scope);
  }

  /**
   * Returns the Facebook login URL for re-requesting email permission.
   *
   * @return string
   *   Absolute Facebook login URL where user will be redirected
   */
  public function getFbReRequestUrl() {
    $login_helper = $this->facebook
      ->getRedirectLoginHelper();

    // Define the URL where Facebook should return the user.
    $return_url = $this->urlGenerator
      ->generateFromRoute('simple_fb_connect.return_from_fb', [], [
      'absolute' => TRUE,
    ]);

    // Define the array of Facebook permissions to re-request.
    $scope = [
      'public_profile',
      'email',
    ];

    // Generate and return the URL where we should redirect the user.
    return $login_helper
      ->getReRequestUrl($return_url, $scope);
  }

  /**
   * Reads user's access token from Facebook and set is as default token.
   *
   * This method can only be called from route simple_fb_connect.return_from_fb
   * because RedirectLoginHelper will use the URL parameters set by Facebook.
   *
   * @return \Facebook\Authentication\AccessToken|null
   *   User's Facebook access token, if it could be read from Facebook.
   *   Null, otherwise.
   */
  public function getAccessTokenFromFb() {
    $helper = $this->facebook
      ->getRedirectLoginHelper();

    // URL where Facebook returned the user.
    $return_url = $this->urlGenerator
      ->generateFromRoute('simple_fb_connect.return_from_fb', [], [
      'absolute' => TRUE,
    ]);
    try {
      $access_token = $helper
        ->getAccessToken($return_url);
    } catch (FacebookResponseException $ex) {

      // Graph API returned an error.
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not get Facebook access token. FacebookResponseException: @message', [
        '@message' => json_encode($ex
          ->getMessage()),
      ]);
      return FALSE;
    } catch (FacebookSDKException $ex) {

      // Validation failed or other local issues.
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not get Facebook access token. Exception: @message', [
        '@message' => $ex
          ->getMessage(),
      ]);
    }

    // If login was OK on Facebook, we now have user's access token.
    if (isset($access_token)) {

      // All FB API requests use this token unless otherwise defined.
      $this->facebook
        ->setDefaultAccessToken($access_token);
      return $access_token;
    }

    // If we're still here, user denied the login request on Facebook.
    $this->loggerFactory
      ->get('simple_fb_connect')
      ->error('Could not get Facebook access token. User cancelled the dialog in Facebook or return URL was not valid.');
    return NULL;
  }

  /**
   * Makes an API call to check if user has granted given permission.
   *
   * @param string $permission_to_check
   *   Permission to check.
   *
   * @return bool
   *   True if user has granted given permission.
   *   False otherwise.
   */
  public function checkPermission($permission_to_check) {
    try {
      $permissions = $this->facebook
        ->get('/me/permissions')
        ->getGraphEdge()
        ->asArray();
      foreach ($permissions as $permission) {
        if ($permission['permission'] == $permission_to_check && $permission['status'] == 'granted') {
          return TRUE;
        }
      }
    } catch (FacebookResponseException $ex) {
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not check Facebook permissions: FacebookResponseException: @message', [
        '@message' => json_encode($ex
          ->getMessage()),
      ]);
    } catch (FacebookSDKException $ex) {
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not check Facebook permissions: FacebookSDKException: @message', [
        '@message' => $ex
          ->getMessage(),
      ]);
    }

    // We don't have permission or we got an exception during the API call.
    return FALSE;
  }

  /**
   * Makes an API call to get user's Facebook profile.
   *
   * @return \Facebook\GraphNodes\GraphNode|false
   *   GraphNode representing the user
   *   False if exception was thrown
   */
  public function getFbProfile() {
    try {
      return $this->facebook
        ->get('/me?fields=id,name,email')
        ->getGraphNode();
    } catch (FacebookResponseException $ex) {
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not load Facebook user profile: FacebookResponseException: @message', [
        '@message' => json_encode($ex
          ->getMessage()),
      ]);
    } catch (FacebookSDKException $ex) {
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not load Facebook user profile: FacebookSDKException: @message', [
        '@message' => $ex
          ->getMessage(),
      ]);
    }

    // Something went wrong.
    return FALSE;
  }

  /**
   * Makes an API call to get the URL of user's Facebook profile picture.
   *
   * @return \Facebook\GraphNodes\GraphNode
   *   GraphNode object representing user's Facebook profile picture.
   */
  public function getFbProfilePic() {

    // Determine preferred resolution for the profile picture.
    $resolution = $this
      ->getPreferredResolution();

    // Generate FB API query.
    $query = '/me/picture?redirect=false';
    if (is_array($resolution)) {
      $query .= '&width=' . $resolution['width'] . '&height=' . $resolution['height'];
    }

    // Call Graph API to request profile picture.
    try {
      $graph_node = $this->facebook
        ->get($query)
        ->getGraphNode();
      return $graph_node;
    } catch (FacebookResponseException $ex) {
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not load Facebook profile picture. FacebookResponseException: @message', [
        '@message' => json_encode($ex
          ->getMessage()),
      ]);
    } catch (FacebookSDKException $ex) {
      $this->loggerFactory
        ->get('simple_fb_connect')
        ->error('Could not load Facebook profile picture. FacebookSDKException: @message', [
        '@message' => $ex
          ->getMessage(),
      ]);
    }

    // Something went wrong and the picture could not be loaded.
    return FALSE;
  }

  /**
   * Returns the URL of user's Facebook profile picture.
   *
   * @deprecated This method is deprecated as of 8.x-3.1 and exists only for
   * backwards compatibility. Please use getFbProfilePic() instead.
   *
   * @return string|false
   *   Absolute URL of the profile picture.
   *   False if user did not have a profile picture on FB or an error occured.
   */
  public function getFbProfilePicUrl() {

    // Read the user's profile picture from Facebook API.
    if ($graph_node = $this
      ->getFbProfilePic()) {
      return $graph_node
        ->getField('url');
    }

    // Something went wrong.
    return FALSE;
  }

  /**
   * Returns user's email address from Facebook profile.
   *
   * @param \Facebook\GraphNodes\GraphNode $fb_profile
   *   GraphNode object representing user's Facebook profile.
   *
   * @return string|false
   *   User's email address if found
   *   False otherwise
   */
  public function getEmail(GraphNode $fb_profile) {
    if ($email = $fb_profile
      ->getField('email')) {
      return $email;
    }

    // Email address was not found. Log error and return FALSE.
    $this->loggerFactory
      ->get('simple_fb_connect')
      ->error('No email address in Facebook user profile');
    return FALSE;
  }

  /**
   * Determines preferred profile pic resolution from account settings.
   *
   * Return order: max resolution, min resolution, FALSE.
   *
   * @return array|false
   *   Array of resolution, if defined in Drupal account settings
   *   False otherwise
   */
  protected function getPreferredResolution() {
    $field_definitions = $this->entityFieldManager
      ->getFieldDefinitions('user', 'user');
    if (!isset($field_definitions['user_picture'])) {
      return FALSE;
    }
    $max_resolution = $field_definitions['user_picture']
      ->getSetting('max_resolution');
    $min_resolution = $field_definitions['user_picture']
      ->getSetting('min_resolution');

    // Return order: max resolution, min resolution, FALSE.
    if ($max_resolution) {
      $resolution = $max_resolution;
    }
    elseif ($min_resolution) {
      $resolution = $min_resolution;
    }
    else {
      return FALSE;
    }
    $dimensions = explode('x', $resolution);
    return [
      'width' => $dimensions[0],
      'height' => $dimensions[1],
    ];
  }

}

Members

Name	Modifiers	Type	Description	Overrides
SimpleFbConnectFbManager::$entityFieldManager	protected	property
SimpleFbConnectFbManager::$eventDispatcher	protected	property
SimpleFbConnectFbManager::$facebook	protected	property
SimpleFbConnectFbManager::$loggerFactory	protected	property
SimpleFbConnectFbManager::$persistentDataHandler	protected	property
SimpleFbConnectFbManager::$urlGenerator	protected	property
SimpleFbConnectFbManager::checkPermission	public	function	Makes an API call to check if user has granted given permission.
SimpleFbConnectFbManager::getAccessTokenFromFb	public	function	Reads user's access token from Facebook and set is as default token.
SimpleFbConnectFbManager::getEmail	public	function	Returns user's email address from Facebook profile.
SimpleFbConnectFbManager::getFbLoginUrl	public	function	Returns the Facebook login URL where user will be redirected.
SimpleFbConnectFbManager::getFbProfile	public	function	Makes an API call to get user's Facebook profile.
SimpleFbConnectFbManager::getFbProfilePic	public	function	Makes an API call to get the URL of user's Facebook profile picture.
SimpleFbConnectFbManager::getFbProfilePicUrl Deprecated	public	function	Returns the URL of user's Facebook profile picture.
SimpleFbConnectFbManager::getFbReRequestUrl	public	function	Returns the Facebook login URL for re-requesting email permission.
SimpleFbConnectFbManager::getPreferredResolution	protected	function	Determines preferred profile pic resolution from account settings.
SimpleFbConnectFbManager::setFacebookService	public	function	Dependency injection setter for Facebook service.
SimpleFbConnectFbManager::__construct	public	function	Constructor.