Avertissement
Le passage en SPIP v.3 est en cours merci de me signaler les bugs que vous trouverez.
Installation
Le plugin s’installe comme tout autre plugin, téléchargez le fichier ZIP et placer son contenu dans votre répertoire « plugins/ ».
Il va installer un nouveau menu « Téléchargements » pour permettre de suivre les statistique de téléchargement dans le menu statistique, si celles-ci sont activées, ou dans le menu édition dans le cas contraire.
En SPIP 3, le plugin ajoute un onglet sur la page de suivi des statistique (il est donc nécessaire d’activer les statistiques du site).
Pour configurer le plugin, vous devez vous rendre sur la page des téléchargements et cliquer sur l’icône de configuration dans le bloc de raccourcis.
- Vous pouvez configurer le délai entre deux clics (en seconde). Cela évite qu’un même utilisateur cliquant sur le lien pendant ce délai ne soit compté plusieurs fois. Une valeur négative correspond à un temps infini et ne va compter qu’un seul téléchargement par adresse IP.
- Vous pouvez sécuriser les URLs des liens de téléchargement. Comme ceux-ci sont de la forme :
MON_SITE/spip.php?action=telecharger&arg=35&type=image.jpeg
, il est possible à un utilisateur peu délicat de chercher à charger des document en modifiant l’identifiant du document passé dans l’URL. La sécurisation ajout une clé dépendant du document et de l’utilisateur pour éviter cela.
Principe
Le principe du plugin est de permettre de suivre les téléchargements de certains documents (une notice, un programme ou un document particulier...). Il faut pour cela utiliser le raccourci ou l’url fourni par le plugin.
Utilisation
Le plugin déclare :
- un raccourcis <docxx|compteur>
qui s’utilise dans les articles comme le raccourci <docxx>
et qui va compter les téléchargements.
- une balise #URL_DOC_COMPTEUR
que vous pouvez utiliser dans vos squelettes qui renvoie un lien vers le document et qui comptera les clics faits sur ce lien.
- une balise #COMPTEUR_TELECHARGEMENT
qui permet de connaitre le nombre de téléchargements dans une boucle document.
<BOUCLE_doc(DOCUMENTS)>
Le document #ID_DOCUMENT a été téléchargé #COMPTEUR_TELECHARGEMENT fois<br/>
</BOUCLE_doc>
Dans l’espace privé
Le plugin utilise le module de statistique de SPIP pour afficher les statistiques de téléchargement. Vous y accédez depuis le menu Statistique, si celles-ci sont actives ou le menu Édition dans le cas contraire.
En SPIP 3, les statistiques sont accessibles dans le menu Statistiques, onglet Téléchargements.
Calcul de statistique
Le plugin installe une table DOC_COMPTEURS
qui stocke les téléchargements journaliers de document.
id_document | date | telechargement |
On peut l’utiliser afin de calculer des statistiques sur les téléchargements, en effet, la balise #TELECHARGEMENT
va faire la somme sur la période donnée.
Ainsi, la boucle suivante donne le nombre de téléchargements par document pour 2011.
<BOUCLE_stat(DOC_COMPTEURS){date >= 2011-01-01}{date < 2012-01-01}>
#ID_DOCUMENT : #TELECHARGEMENT<br />
</BOUCLE_stat>
et pour le top10 des téléchargements de la semaine en cours (cela peut être utile) :
[(#SET{date,[(#EVAL{ date("Y-m-d",strtotime("now")-7*24*3600); })]})]
<BOUCLE_stat(DOC_COMPTEURS){date>#GET{date}}{!par telechargement}{0,10}>
<BOUCLE_doc(DOCUMENTS){id_document}>
[(#TITRE|sinon{#ID_DOCUMENT})]
</BOUCLE_doc>
: #TELECHARGEMENT<br/>
</BOUCLE_stat>
Le critère {plat}
supprime ce comportement et permet d’accéder aux téléchargements au jour le jour.
Bonus
En bonus, le plugin propose un gros bouton de téléchargement au travers du modèle doc_bouton
.
Il prend les paramètres compteur
si on veut compter les téléchargements et un paramètre d’alignement (left, center, right). Le paramètre couleur
permet de changer la couleur du bouton (par défaut, en orange). Il peut prendre les valeurs orange, mauve ou bleu.
<docXX|bouton|center|couleur=orange|compteur=1>
En fait, le paramètre couleur
déclare le bouton dans une classe .doc_bouton_couleur
. Vous pouvez donc ajouter des boutons en déclarant la classe correspondante dans votre css (voir les exemples dans le css du plugin et le dossier /img).
Discussions par date d’activité
53 discussions
Le raccourci
est à utiliser dans un article, mais si le document se trouve dans le portfolio, comment faire ?
Merci d’avance
Bonjour,
Deux solutions :
- solution un peu technique mais générique pour tous les documents : surcharger la balise #URL_DOCUMENT dans votre fichier d’option.
- solution plus facile et modulable : surcharger le fichier inc-documents.html dans votre squelette en changeant la balise #URL_DOCUMENT par #URL_DOC_COMPTEUR. Du coup, on peut distinguer entre les documents images (portfolio) et les autres (pdf, doc, etc...).
@+
Merci pour tes explications, ça marche très bien et félicitation pour ce plugin que j’attendais depuis longtemps ;-)
Répondre à ce message
j’ai mis à jour spip juste avant d’installer le plugin, donc a priori, la toute dernière 2.1.8. je pense que nous sommes en url absolue, en effet.
Concernant le critère de couleur, je m’étais doutée de quelque chose comme ça, mais j’avais juste tenté |bleu| au lieu de |couleur=bleu|. Merci donc pour la précision.
Répondre à ce message
Je viens d’installer ce plugin pour le tester (ça fait longtemps que j’attendais quelque chose comme ça ). aucun souci avec l’installation. Par contre, dans action/telecharger.php, il m’a fallu retoucher un peu le code pour que les liens se forment correctement.
Je ne sais pas comment m’expliquer le mieux techniquement (je suis juste bidouilleuse), mais par exemple sur cette page : http://www.collegedevinci.com/-Manuel-en-ligne-de-grec-ancien-?var_mode=recalcul avant la retouche, quand on cliquait sur le bouton,cela ne se transformait pas en lien de téléchargement du fichier, mais on accédait à une page d’erreur, puisque l’adresse de la page sans celle du fichier était redoublée (un truc genre http://www.adressedusite/IMG/http://www.adressedusite/IMG/adressedufichier.pdf). Du coup, ligne 58 à 60, j’ai changé les
en
A présent, tout va bien.
Et je vais sembler un peu idiote, mais je n’ai pas compris où (pas dans CFG... si dans un fichier, lequel ?) spécifier la variante de couleur (pour ruser j’ai écrasé les images...)
Bonjour,
Je vais regarder cela (url_absolue ?). Quelle est votre version de SPIP ?
Pour la couleur des bouton, on le spécifie dans le raccourcis (je reprends le texte pour être plus clair) :
@+
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |