Compter les “clics” sur les liens

Présentation et configuration

Nous souhaitons compter le nombre de fois que les liens que nous proposons sur un site spip sont chargés par les internautes. Notez que cette contrib concerne les liens référencé (les «objets-liens» proposés par spip) et non les liens créé à l’intérieur des pages (pour lesquels aucune solution de gestion globale n’a encore émergé).

Nous allons utiliser un petit script php qui sera chargé d’incrémenter un compteur puis de renvoyer l’utilisateur vers l’URL demandé.

Nous commençons par ajouter trois colonnes dans la table des liens, à l’aide de la commande suivante :

ALTER TABLE spip_syndic ADD compteur INTEGER;

ALTER TABLE spip_syndic ADD compteur_derniere_ip VARCHAR(15);

ALTER TABLE spip_syndic ADD compteur_temps INTEGER;

Nous créons ensuite, à la racine du site spip, un petit fichier que nous nommons compteur_liens.php3 et dont voici le source :

<?php
// On se connecte à la base de données (en chargeant au passage les fonctions nécessaires à la suite)
include('ecrire/inc_version.php3');
include_ecrire('inc_connect.php3');

// On voit si on a un identifiant passé en variable
if ($id_syndic) {
	$r = spip_query("SELECT url_site FROM spip_syndic WHERE id_syndic='$id_syndic' LIMIT 1");
	$o = spip_fetch_array($r);
}

// Sinon on renvoie un message d'erreur
else {
	print("Erreur : aucun site ne correspond à la requête");
	exit;
}

// On incrémente le compteur
spip_query("UPDATE LOW_PRIORITY spip_syndic SET compteur = compteur + 1 WHERE id_syndic='$id_syndic' LIMIT 1");

// Et on redirige (enfin) l'utilisateur vers l'URL du site (qu'on a passé en variable)
header("Location:$o['url_site']");

?>

Nous utiliserons le filtre suivant (à placer dans le fichier mes_fonctions.php3) pour réécrire les URL vers le fichier intermédiaire compteur_liens.php3 :

//
// Génération du lien allant vers le compteur de liens
//
function utiliser_compteur($id_syndic) {
	// Config
	$activer = 0; // Mettre à 0 pour désactiver le compteur (et renvoyer
directement vers l'URL)

	if ($activer) {
		return "./compteur_liens.php3?id_syndic=".$id_syndic;
	}
	else {
		$r = spip_query_db("SELECT url_site FROM spip_syndic WHERE
id_syndic='$id_syndic' LIMIT 1");
		$o = spip_fetch_array($r);
		return $o['url_site'];
	}
}

Notez que, si pour une raison ou une autre, vous décidez de ne plus utiliser ce filtre, il peut-être désactivé très simplement en changeant un paramètre (et donc sans devoir toucher aux squelettes). Dans ce cas, le filtre renverra simplement à l’URL visée.

Pour utiliser le filtre, il suffira donc d’écrire systématiquement (dans les squelettes) les liens de la façon suivante :

<a href="[(#ID_SYNDIC|utiliser_compteur)]" ...

Affichage

Enfin, nous pouvons utiliser ce compteur sur le site public, par exemple pour fournir la liste des 10 sites les plus visités.

Deux possibilités.

La première consiste à ne pas toucher au moteur de spip (et donc à utiliser du php pour afficher les données qui nous intéressent), ce qui donnera par exemple :

<?php

// Ce fichier doit être placé dans la racine de SPIP
include('ecrire/inc_version.php3');
include_ecrire('inc_connect.php3');

$r = spip_query("SELECT * FROM spip_syndic WHERE statut='publie' ORDER
BY compteur DESC LIMIT 10");
while($o = spip_fetch_array($r))
{
	print("<p><a href=\"".$o['url_site']."\">".$o['nom_site']."</a>
(".$o['compteur']." visites)</p>");
}

?>

La deuxième possibilité va consister à créer une nouvelle balise spip que nous allons appeler #COMPTEUR et dont nous pourrons faire usage dans la boucle SYNDIC des squelettes.

Nous commençons par modifier le fichier inc-champ-squel.php3. Nous ajoutons 'COMPTEUR' dans les valeurs du tableau $c aux lignes 70 à 95. Nous ajoutons ensuite au tableau $rows_syndication (lignes 292 et suivantes) la ligne suivante : 'COMPTEUR' => 'compteur' (en n’oubliant pas la virgule avant).

Ceci étant fait, nous disposons d’une nouvelle balise que nous pouvons très simplement utiliser dans une boucle de la façon suivante :

<BOUCLE_compteur(SYNDIC){par compteur}{inverse}{0,10}>
<a href="[(#ID_SYNDIC|utiliser_compteur)]">#NOM_SITE</a> (#COMPTEUR visites)
</BOUCLE_compteur>

L’usage est bien sûr un peu lourdaud mais on vous fais confiance pour exploiter ceci de manière plus fine.

Ceci peut bien sûr être fortement amélioré.