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é
8 discussions
Un tout grand merci pour tous les contributeurs de ce CMS toujours à la page !!
Je viens juste vous faire une petite demande... une supplique même !... Est-ce qu’une personne bien intentionnée pourrait se pencher sur ce superbe plugin qui bien que simple dans le retour des informations (juste connaître le nombre de fois qu’un document a été téléchargé) n’est pas si simple dans son codage !... Le but étant de rendre accessible ce plugin aux versions ultérieurs de spip... la 3.3, la 4.0 et la 4.1.x...
Je pense que plusieurs utilisent ce plugin et hésitent à passer à une version supérieure de spip peur de perdre les infos sur les téléchargements des documents par les visiteurs. :-/
N’hésitez pas à me contacter si vous êtes preneur de la tâche... Merci d’avance !
Répondre à ce message
Bonjour,
le plugin compte les clics sur un document à télécharger. Parfait. Est-ce qu’il serait possible d’envisager une variante/option qui permettrait de compter également les clics effectués sur un texte (ou une image) servant de lien redirigeant vers un site externe ?
Répondre à ce message
Bonjour Viglino Jean-Marc,
Pensez-vous que ce plugin sera compatible avec la version spip 3.3 ?
Spip m’indique que le plugin est bien téléchargé mais je ne le retrouve nulle-part ni dans l’administration des plugins, ni dans le menu configuration.
Merci pour ta contribution à la communauté Spip.
Eric
Bonjour,
J’utilise également ce plugin pour mon association Edition999 et il ne fonctionne pas sur la version 3.3 dev. Pensez-vous que la mise à jour sera possible.
Merci de votre aide.
Jean-Michel
Désolé, pas de mise à jour prévue...
Mince. Et vous pensez que les modifications à réaliser demanderaient de grosses connaissances ? en php ? ou bien est-ce tout le mécanisme qui est obsolète avec le passage en 3.3 ? Merci. Jean-Michel
Aucune idée, voir si cela peut marcher pour la v3.3 comme pour la 3.2 :
https://contrib.spip.net/Plugin-Analyclick-un-compteur-de-telechargements#comment494667-494067
@Jean-Michel Edition999
Avez-vous essayé le plugin en changeant les bornes comme suggéré par l’auteur Viglino Jean-Marc dans son dernier fil ?
Bonjour @Kingrise
Oui j’ai essayé et cela n’a pas fonctionné.
Le plugin n’apparaissait pas dans la liste des plugin à activer.
Comme j’avais monté une version de recette 3,3 pour tester un peu l’avenir, je suis revenu à la version actuelle en me disant que comme la 3,3 n’arrivera qu’en fin d’année, je verrai cet été si j’ai un peu de temps pour essayer de bidouiller quelque chose.
Et autrement je suis mal, car ce compteur comptabilise depuis des années le nombre de téléchargements effectués par les lecteurs des livres gratuits proposés par les auteurs gracieusement.
Bonne journée.
Répondre à ce message
Bonjour
Merci pour ce plugin
Je l’utilise mais au bout d’un certain temps un étrange bug apparaît :
Les usagers non enregistré dans l’admin ont le message suivant « Accès interdit » avec un bouton leur demandant de se connecter : ce message n’apparait pas lorsque l’on ai connectée en admin...
Dans mes articles j’utilise le code suivant :
Normal ou pas ???
J’ai aussi constaté ce problème de mon côté.
Ça ne se produit que lorsqu’on active la sécurisation des URLs, si on n’a pas de documents sensibles sur le site, on peut contourner le problème en désactivant cette option.
Le problème est que les URL sécurisées de SPIP ne sont valables que pour un auteur donné, les autres auteurs mangent des « accès interdit ». Et comme ces URLs sont parfois mises en cache, le site affiche des liens qui ne fonctionnent que pour l’auteur qui a déclenché la création du cache.
Je peux reproduire le problème avec les étapes suivantes :
Bonjour,
Désolé de reprendre ce vieux message, mais j’ai également ce problème, avez-vous réussi à le corriger ou à trouver un contournement ?
Merci de votre retour
Jean-Michel
Répondre à ce message
Bonjour,
J’arrive pas à faire un top de l’article ayant cumulé le plus de documents téléchargés sur les 7 derniers jours ( chaque article a un Pdf - un Epub - et un Mobi) voir page par exemple :
https://www.edition999.info/L-homme-mort.html de l’article.
Et la page du Top : https://www.edition999.info/Les-meilleurs-telechargements-ebooks-gratuits qui ne contient actuellement que les PDF.
Merci d’avance de votre aide :
Voici mes boucles :
Répondre à ce message
Bonjour, je découvre ce plugin bien utile.
Après relecture des échanges passés, peut on résumer ainsi ? :
- l’appel du compteur sur un pdf se fait dans le champs texte avec <docXXX|compteur> et on obtient des stats globales (pour tous les pdf).
- Si on veut des stats précises pour un pdf donné on rajoute le numéro du compteur <docYYY|compteur=XX> (c’est pas forcément le même numéro de compteur que celui du document).
- Si on veut des stats sur un lien avec titre, on fait <docYYY|compteur_lien|titre=nom du lien>
Ma question spécifique est la suivante : sur un site avec plusieurs centaines de pdf, je souhaiterai éviter de remettre le lien « |compteur » à chaque fois. Tous mes pdf sont liés dans le champs « PS » des articles, peut on imaginer un attribut de type « #PS|compteur_lien » pour prendre en compte automatiquement tous les liens doc dans ce champs ?
Sinon comment faire la surcharge dans mes_options pour transformer tous les liens URL_DOCUMENT en URL_DOC_COMPTEUR ?
Merci pour votre aide
Pas vraiment une réponse, mais on sait jamais : selon les formats d’appels de tes modèles, le plugin rechremp pourra t’aider, ou pas, à mettre à jour tous tes appels. Mais dans le cas général il faudrait faire des recherches et remplacements avec expression régulière, ce que rechremp ne fait pas encore actuellement.
Répondre à ce message
Plugin très utile, qui fonctionne très bien.
Cependant, un avertissement lié à ce plugin apparait à présent dans les logs :
« PHP Warning : Use of undefined constant generer_url_document - assumed ’generer_url_document’ (this will throw an Error in a future version of PHP) in /var/www/spip/plugins/auto/anaclic/v0.3.4/action/telecharger.php on line 49 » (avec PHP 7.2)
Répondre à ce message
Bonjour,
je ne parviens pas à voir la page de statistique de téléchargement lorsque je désactive les statistique pour le site.
Dans la doc il est dis que cela devarit apparaitre dans le menu edition ; mais je ne vois rien de tel. (en spip 3.2.3) veriosn du plugin 0.3.4
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 : |