Fandjango

applications Facebook sont tout simplement des sites Web qui charge dans les iframes sur Facebook. Facebook fournir les documents chargés au sein de ces iframes avec diverses données, telles que les informations relatives à l'utilisateur d'y accéder ou la page Facebook, il est accessible à partir. Ces données est encapsulé dans demandes signées.
Fandjango est un module qui analyse demandes signées, les résumés des informations contenues à l'intérieur et remplit l'objet de la demande en conséquence.
Mise en route
Vous pouvez trouver un exemple d'application et un walkthrough de le reproduire au référentiel Fandjango exemple.

Utilisation:
Utilisateurs
Fandjango sauve clients qui ont autorisé votre demande dans son modèle de l'utilisateur. Vous pouvez accéder à l'instance de modèle correspondant request.facebook.user.
Les instances du modèle de l'utilisateur ont les propriétés suivantes:
& Nbsp; facebook_id - Un entier décrivant de l'utilisateur Facebook ID.
& Nbsp; facebook_username - Une chaîne décrivant Facebook le nom d'utilisateur de l'utilisateur.
& Nbsp; prenom - Une chaîne décrivant le prénom de l'utilisateur.
& Nbsp; nom_famille - Une chaîne décrivant le nom de l'utilisateur.
& Nbsp; profile_url - Une chaîne décrivant l'URL au profil Facebook de l'utilisateur.
& Nbsp; le sexe - Une chaîne décrivant le sexe de l'utilisateur.
& Nbsp; ville natale - Une chaîne décrivant la ville natale de l'utilisateur (nécessite 'user_hometown' autorisation étendue).
& Nbsp; l'emplacement - Une chaîne décrivant l'emplacement actuel de l'utilisateur (nécessite 'user_location' d'autorisation étendu).
& Nbsp; bio - Une chaîne décrivant "about me" le champ de l'utilisateur sur Facebook (nécessite 'user_about_me' autorisation étendue).
& Nbsp; relationship_status - Une chaîne décrivant l'état de la relation de l'utilisateur (nécessite l'autorisation prolongée 'user_relationships').
& Nbsp; political_views - Une chaîne décrivant vues politiques de l'utilisateur (nécessite l'autorisation prolongée 'user_religion_politics').
& Nbsp; email - Une chaîne décrivant l'adresse email de l'utilisateur (nécessite 'email' étendue permission).
& Nbsp; site - Une chaîne décrivant le site web de l'utilisateur (nécessite 'user_website' autorisation étendue).
& Nbsp; locale - Une chaîne décrivant la locale de l'utilisateur.
& Nbsp; vérifié - Un booléen indiquant si ou non l'utilisateur est vérifiée par Facebook.
& Nbsp; anniversaire - Un objet datetime décrivant l'anniversaire de l'utilisateur (nécessite 'user_birthday' autorisation étendue)
& Nbsp; oauth_token - Un objet OAuth Token.
& Nbsp; created_at - Un objet datetime décrivant lorsque l'utilisateur a été enregistré.
& Nbsp; last_seen_at - Un objet datetime décrit lorsque l'utilisateur était la dernière fois.
Vous pouvez synchroniser ces propriétés avec Facebook à tout moment avec la méthode de synchronisation du modèle.
oauth_token est une instance de modèle OAuthToken, qui a les propriétés suivantes:
- Jeton - Une chaîne décrivant le jeton OAuth lui-même.
- Issued_at - Un objet datetime décrivant lorsque le jeton a été délivré.
- Expires_at - Un objet datetime décrivant lorsque le jeton expire (ou None si ce ne est pas)
Si le client n'a pas autorisé votre demande, request.facebook.user est Aucun.
Autorisant les utilisateurs
Vous pouvez avoir besoin d'un client d'autoriser votre demande avant d'accéder à une vue avec le décorateur facebook_authorization_required.
de fandjango.decorators importer facebook_authorization_required
facebook_authorization_required ()
def foo (demande, * args, ** kwargs):
& Nbsp; passe
Cela va rediriger la demande de la boîte de dialogue d'autorisation Facebook, qui à son tour rediriger retour à l'URI d'origine. Le décorateur accepte un argument redirect_uri option, vous permettant de personnaliser l'emplacement l'utilisateur est redirigé après autorisant la demande:
à partir des paramètres d'importation FACEBOOK_APPLICATION_TAB_URL
de fandjango.decorators importer facebook_authorization_required
facebook_authorization_required (redirect_uri = FACEBOOK_APPLICATION_TAB_URL)
def foo (demande, * args, ** kwargs):
& Nbsp; passe
Si vous préférez, vous pouvez rediriger la requête dans un flux de contrôle de votre propre en utilisant la fonction de redirect_to_facebook_authorization:
de fandjango.utils importation redirect_to_facebook_authorization
def foo (demande, * args, ** kwargs):
& Nbsp; sinon request.facebook.user:
& Nbsp; retour redirect_to_facebook_authorization (redirect_uri = 'http: //www.example.org/')
Pages
Si l'application est accessible depuis un onglet sur une page Facebook, vous trouverez une instance de page Facebook en request.facebook.page.
Les instances du modèle de page Facebook ont ​​les propriétés suivantes:
- Id - Un entier décrivant l'id de la page.
- Is_admin - Un booléen indiquant si ou non l'utilisateur actuel est un administrateur de la page.
- Is_liked - Un booléen indiquant si ou non l'utilisateur actuel aime la page.
& Nbsp; url - Une chaîne décrivant l'URL de la page.
Si l'application ne est pas accessible à partir d'un onglet sur une page Facebook, request.facebook.page est None

Ce qui est nouveau dans cette version:.

• Fandjango va maintenant définir request.facebook False pour les demandes signées invalides plutôt que lever une exception.
• Fandjango utilise désormais les dernières versions de demandes et facepy.

Ce qui est nouveau dans la version 4.0.6:

• Fandjango va maintenant seulement étendre jetons OAuth qui ne ont pas déjà été étendu.

Ce qui est nouveau dans la version 4.0.5:

• Fandjango va maintenant ignorer les erreurs internes sur Facebook tenter de étendre un jeton d'accès.

Ce qui est nouveau dans la version 4.0.4:

• Correction d'un bug qui faisait que les «arguments» redirect_uri à «facebook_authorization_required 'pour être ignoré.

Quoi de neuf dans la version 4.0.3:.

• Vous pouvez maintenant définir des autorisations spécifiques de vue
• Ajout d'utilisateur # autorisations.
• paramètre Ajouté FACEBOOK_APPLICATION_CANVAS_URL.
• jetons OAuth sont maintenant étendues (voir Obsolescence des accès hors connexion Permission)
• Correction d'un problème qui empêchait les utilisateurs d'autoriser les applications sous Internet Explorer.

Ce qui est nouveau dans la version 4.0.2:

• Correction d'un bug qui a causé une AttributeError lors de la délivrance d'un requête HTTP GET à la vue de deauthorization.
• Correction d'un bug qui faisait que l'application deauthorization à l'échec.
• Correction d'un bug qui empêchait la localisation norvégien d'être appliquée.

Exigences :

• Python