Gadget de partage - nschonni/wet-boew GitHub Wiki

English

Ce composant aide à partager le contenu Web dans divers résaux sociaux.

Table of Contents

Vue d'ensemble

Chef de projet : Paul Jackson (@pjackson28)

Description

Rationale

Needs translation Having a share widget on your site enables users to quickly share content with their networks, hence increasing the reach of your website. This increase in reach comes at very minimal cost as all it requires is the inclusion of a share widget somewhere on your page.

Use when

Needs translation Use on specific content that you want users to share or that users would find useful to share with others via their social media outlets. Use the filtered version if you want to target certain platforms, for example, if your research indicates that your target audience tends to use one or a few platforms over others.

Rather than automatically including the share button on every page of your site, think about users and when and where they may want to take a call to action to digg, share, tweet or follow. A well designed site will facilitate a 'frictionless' experience for the user where they would otherwise have to copy and paste. (Source).

Do not use when

Needs translation

  • The page does not contain useful content (e.g., splash pages)
  • The page does not have a unique URL. Sharing the page would send people to a different page if users clicked on the shared link.
  • Automatically on every page.

Mise en oeuvre

  1. Ajouter
    à une page Web.
  2. Specifier la largeur du gadget (p. ex., class="span-5 margin-bottom-none")
  3. Configurer les options globales ou uniques à chaque page. Configurer les options globales en ajoutant var wet_boew_share = { ... options ...}; à settings.js. Configurer les options uniques à chaque page en ajoutant à l'élément du gadget les classes de configuration ou data_wet_boew_share="{... options ...}".
Exemple d'une configuration globale :
var wet_boew_share = {
   sites : ['del.icio.us', 'digg', 'facebook', 'google', 'linkedin', 'reddit', 'stumbleupon', 'twitter', 'yahoobuzz']
};
Exemple d'une configuration globale

Exemple d'une configuration unique à une page :

<div class="wet-boew-share" data-wet-boew="{sites:['digg','facebook','twitter']}"></div>

Options de configuration

Paramètre (options globale et data-wet-boew) Valeur Par défault Classe de configuration Description
addEmail Booléen False email (même que addEmail:true) Contrôole l'affichage du lien de courriel. C'est relié aux paramètres emailSubject et emailBody.
addFavorite Booléen False favourite (même que addFavorite:true) Contrôle l'affichage du lien préféré.
description Chaîne s/o Description de la page ou du site. Il remplace {d} dans le texte généré.
emailBody Chaîne "I thought you might find this page interesting:\n{t} ({u})" / "J'espère que cette page vous intéresse :\n{t} ({u})" s/o Le contenu du courriel généré par le lien de courriel. {t}est remplacé par let titre de la page, {u} est remplacé par le URL de la page et {d} est remplacé par la description de la page (où elle existe). Utiliser \n pour les nouvelles lignes. C'est relié aux paramètres addEmail et emailSubject.
emailSubject Chaîne "Interesting page" / "Page qui est intéressante" s/o Sujet du courriel généré par le lien de courriel. C'est relié aux paramètres addEmail et emailBody.
sites Tableau [] s/o Liste des sites Web de médias sociaux à inclure dans le gadget (p. ex., sites:['digg','facebook','twitter']). Laisser vide pour inclure tous les sites Web de médias sociaux qui sont soutenus par ce gadget.
sourceTag Chaîne s/o Balise supplémentaire a ajouté a l'URL pour indiquer le source du lien partagé.
title Chaîne s/o Titre à partager. Laisser vide pour utiliser le titre de la page actuelle.
url Chaîne s/o URL à partager. Laisser vide pour utiliser l'URL de la page actuelle.

Exemples

Développement

Le gadget de partage est dépendentsur jQuery Bookmark (licence MIT, licence GPL).

Le code pour le gadget de partage se trouve à plusieurs endroits dans le répertoire source de la BOEW :

Problèmes connus

Il n’existe actuellement aucun problème connu.

Historique des versions

Références

⚠️ **GitHub.com Fallback** ⚠️