Pour commencer, la « bible » Facebook des Social Plugins : developers.facebook.com/docs/plugins/. Vous y trouverez toutes les infos (actualisées) concernant les plugins utilisés ici.
Valeurs par défaut
En règle générale, si le modèle nécessite une URL et qu’aucun argument ne lui est passé, l’URL courante sera utilisée. Pour définir cette URL, vous pouvez passer l’argument href=... au modèle ou tout simplement suivre la règle des modèles SPIP en transmettant l’ID de l’objet courant [1]. Par exemple :
- #MODELE{...}{id_article}
Certaines options communes, notamment de mise en forme, ont des valeurs par défaut, à savoir :
- une couleur de bordure « #dddddd »
- des largeurs de 226px en colonne et 490px en contenu
- la police « Lucida grande »
Note - Les attributs « ref » ne sont pas traités par le plugin (c’est à étudier, et fait partie des choses à faire ...).
"Send" plugin : un simple bouton de commentaire
Doc officielle : developers.facebook.com/docs/reference/plugins/send/.
Références (options) :
- href : URL qui sera « aimée » (par défaut l’URL courante)
- font : la police utilisée (’arial’ ’lucida grande’ ’segoe ui’ ’tahoma’ ’trebuchet ms’ ’verdana’ - par défaut ’lucida grande’ - cf. doc)
- colorscheme : couleur générale du bouton (light/dark - par défaut ’light’)
- width : largeur totale de l’outil (par défaut 80px)
- height : hauteur totale de l’outil (utilisée en iframe - par défaut 20px)
"Like" plugin : le fameux bouton « J’aime »
Doc officielle : developers.facebook.com/docs/reference/plugins/like/.
Références (options) :
- href : URL qui sera « aimée » (par défaut l’URL courante)
- send : montrer le bouton ’send’ (oui/non - par défaut ’oui’)
- layout : standard/button_count/box_count (par défaut ’standard’ - cf. doc)
- show_faces : montrer les visages de ceux qui ont aimé (oui/non - par défaut ’oui’)
- width : largeur totale de l’outil (par défaut 490px)
- height : hauteur totale de l’outil (utilisée en iframe - par défaut 80px)
- action : texte du bouton (like/recommend - par défaut ’like’)
- font : la police utilisée (’arial’ ’lucida grande’ ’segoe ui’ ’tahoma’ ’trebuchet ms’ ’verdana’ - par défaut ’lucida grande’ - cf. doc)
- colorscheme : couleur générale du bouton (light/dark - par défaut ’light’)
"Like Box" plugin : boîte Facebook
Doc officielle : developers.facebook.com/docs/reference/plugins/likebox//
Références (options) :
- href : URL qui sera « aimée » (par défaut l’URL courante)
- header : montrer l’en-tête du bloc (oui/non - par défaut ’oui’)
- stream : montrer la liste de news (oui/non - par défaut ’oui’)
- border_color : couleur de la bordure (hexadecimale AVEC le dièse initial - par défaut ’#dddddd’)
- show_faces : montrer les visages de ceux qui ont aimé (oui/non - par défaut ’oui’)
- width : largeur totale de l’outil (par défaut 490px)
- height : hauteur totale de l’outil (utilisée en iframe - par défaut 80px)
- font : la police utilisée (’arial’ ’lucida grande’ ’segoe ui’ ’tahoma’ ’trebuchet ms’ ’verdana’ - par défaut ’lucida grande’ - cf. doc)
- colorscheme : couleur générale du bouton (light/dark - par défaut ’light’)
"Comments" plugin : bloc de commentaires
Doc officielle : developers.facebook.com/docs/reference/plugins/comments/.
Références (options) :
- href : URL qui sera commentée (par défaut l’URL courante)
- num_posts : nombre de posts montrés (par défaut 2)
- width : largeur totale de l’outil (par défaut 490px)
- height : hauteur totale de l’outil (utilisée en iframe - par défaut 450px)
- font : la police utilisée (’arial’ ’lucida grande’ ’segoe ui’ ’tahoma’ ’trebuchet ms’ ’verdana’ - par défaut ’lucida grande’ - cf. doc)
- colorscheme : couleur générale du bouton (light/dark - par défaut ’light’)
"Activity" plugin : bloc d’activités à la mode RSS
Doc officielle : developers.facebook.com/docs/reference/plugins/activity/.
Références (options) :
- site : URL du site concerné (par défaut URL_SITE_SPIP)
- header : montrer l’en-tête du bloc (oui/non - par défaut ’oui’)
- border_color : couleur de la bordure (hexadecimale AVEC le dièse initial - par défaut ’#dddddd’)
- recommendations : montrer les recommandations (oui/non - par défaut ’oui’)
- filter : un filtre que devront matcher les URLs montrées (vide par défaut - cf. doc)
- width : largeur totale de l’outil (par défaut 226px)
- height : hauteur totale de l’outil (utilisée en iframe - par défaut 300px)
- font : la police utilisée (’arial’ ’lucida grande’ ’segoe ui’ ’tahoma’ ’trebuchet ms’ ’verdana’ - par défaut ’lucida grande’ - cf. doc)
- colorscheme : couleur générale du bouton (light/dark - par défaut ’light’)
"Live-stream" plugin : un chat Facebook (une discussion)
Le plugin proposé par Facebook n’est pas fonctionnel et présente quelques bugs. Il requière d’utiliser une application spécifique à votre site (cf. page de config).
Doc officielle : developers.facebook.com/docs/reference/plugins/live-stream/.
Références (options) :
- event_app_id : l’ID de l’application concernée (par défaut celle de config)
- via_url : URL de redirection (par défaut l’URL courante)
- xid : un ID unique pour la discussion (utile si plusieurs discussions dans une même page)
- always_post_to_friends : poster les messages aux amis (oui/non - par défaut ’non’)
- width : largeur totale de l’outil (par défaut 490px)
- height : hauteur totale de l’outil (utilisée en iframe - par défaut 400px)
- font : la police utilisée (’arial’ ’lucida grande’ ’segoe ui’ ’tahoma’ ’trebuchet ms’ ’verdana’ - defaut ’lucida grande’ - cf. doc)
- colorscheme : couleur générale du bouton (light/dark - par défaut ’light’)
Répondre à cet article