Le module Liens sociaux permet aux utilisateurs de choisir des liens de profils pour l’intégration dans les médias sociaux de leur thème depuis les services sélectionnés connectés à Promotion. Pour l’utiliser, vous devrez :
- Ajoutez le support de thème via la fonction
add_theme_support()dans votre thème. - Utilisez les Modifications de thème API pour extraire les données dans votre modèle de thème.
Ajout du support
Activer les Liens sociaux est très similaire à ajouter du support pour les vignettes ou les styles d’éditeur car il faut utiliser add_theme_support(). En fournissant un tableau de lignes-blocs des services pris en charge comme deuxième argument lors de l’appel de add_theme_support(), les Liens sociaux transmettront uniquement les informations dont votre thème a besoin. Les Liens sociaux prennent actuellement en charge cinq services : Facebook, Twitter, LinkedIn, Google+ et Tumblr. Étant donné que chaque thème est différent et que certains d’entre eux ne prennent pas en charge tous les services, les thèmes doivent spécifier les services :
add_theme_support( 'social-links', array( 'facebook', 'twitter', 'linkedin', 'google_plus', 'tumblr', ) );
Utiliser les informations
Les Liens sociaux rendent les informations disponibles via les Modifications de thème API. De cette façon, les thèmes peuvent extraire ces informations avec un appel de get_theme_mod() et travailler avec. En tant que développeur de thème, vous voulez toujours vérifier si l’utilisateur a configuré un lien pour un service avant de l’utiliser. Vous pouvez compter sur la valeur par défaut false, ou transférer une chaîne vide comme deuxième argument lorsque vous voulez travailler avec des types de données consistants. Nous avons préfixé le nom de modification de thème avec 'jetpack', pour ne pas entrer en conflit avec d’autres plug-ins ou fonctionnalités de thème qui pourraient utiliser uniquement le nom de service. Voici à quoi peut ressembler une implémentation dans un fichier de modèle, après avoir vérifié su l’URL a été configurée :
<a href="<?php echo esc_url( get_theme_mod( 'jetpack-facebook' ) ); ?>">
<?php _e( 'Facebook', 'textdomain' ); ?>
</a>
Veuillez remarquer que bien que les données soient disponibles via get_theme_mod(), elles sont en fait stockées comme valeur sérialisée dans les options de Jetpack — pas comme mod de thème. Nous utilisons simplement quelques filtres en arrière-plan pour que ce soit plus accessible pour les développeurs avec get_theme_mod(), afin que vous ne deviez pas utiliser de fonctions personnalisées qui pourraient briser si vos utilisateurs n’ont pas installé Jetpack !
Jetpack par WordPress.com 