Tutoriel : installer Piwik sous dotclear 2

Piwik se veut être le remplaçant de google analytics ou phpMyVisits, outils de statistiques pour les fréquentations de sites et blogs, et tout cela en Open-source. En voilà une bonne idée sachant que tout ce qui est lié au service internet est clairement dominé par tous les outils de google. Piwik est donc une bonne alternative pour se passer en douceur des services "gratuits" de google, il est tout jeune (cette version est bêta) mais cet outil est déjà plein de promesses.

Les développeurs étant pour l'instant axés sur le développement et les corrections de bugs, le logiciel est déjà suffisamment stable pour être exploiter comme outil statistique.
Malgré tous, il souffre quelque peu d'un manque de documentation pour son installation, manque qui a déjà commencé à être comblé au travers des billets d'Olivier et de Pinopenguin, et que je vais m'efforcer de compléter, surtout pour l'installation de Piwik lui-même.

1. Récupération et installation de Piwik
Télécharger le Pack de Piwik ici.
Une fois récupéré, dezipper le contenu du fichier et munissez-vous de votre outil de transfert FTP préféré (Filezilla ou FireFTP par exemple). Connectez-vous à votre serveur et copiez le répertoire Dezippé piwik sur votre espace d'hébergement de pages web.
Vérifiez que votre serveur supporte php5 et que vos répertoires et fichiers sont accessibles en lecture/écriture (exécution pour les répertoires).

2. Installation de Piwik
Avec votre navigateur, rendez-vous à l'adresse où vous avez copié votre répertoire /piwik, du style:
"http://votredomaine/piwik".
Vous devriez tomber sur l'interface d'installation de piwik, munisez-vous de toutes les données de configuration de votre base de donnée et c'est partie...

a. systemCheck
Ici, l'installateur teste si vous êtes à niveau pour le php5, les extensions MySQL, les accès aux répertoires et différents tests de configuration. Si l'un ou l'autre de ces points échoue, faite les actions requises et en général indiquées par l'installateur piwik avant de continuer.

b. databaseSetup
Entrez ici les infos de votre base de donnée, ici apparait "localhost" mais cela dépend de votre hébergeur, donc à modifier en fonction.

c. tablesCreation
Si les informations entrées précédemment sont bonnes, les nouvelles tables piwik devraient s'être créées sans problème.

d. generalSetup
Entrez ici les informations de connexion que vous utiliserez à l'avenir pour vous connecter à piwik.

e. firstwebsiteSetup
Le moment est venu de référencer le site dont vous souhaitez avoir les statistiques. Pour l'instant, un seul site vous est demandé mais vous pourrez pas la suite en ajouter de nouveaux.

f. JavaScript Code
Piwik vous a généré le code javascript à insérer sur votre site. Copier ce code et éditez le fichier home.html dans les thèmes de votre site dotclear (via votre logiciel FTP ou directement via l'éditeur de thème de dotclear). Coller le code juste avant la balise </body> située en général en fin de fichier. sauvegardez, voilà, piwik est prêt à fonctionner.

Maintenant, connectez-vous à l'interface d'administration de piwik comme vu ci-dessus "http://votredomaine/piwik" et cliquez sur l'onglet API.:

1. Vous permet de générer automatiquement des visites sur votre site, pratique pour générer du trafic et alimenter les statistiques du blog. Attention toutefois, il faudra patienter quelques heures avant que les informations soient actualisées.
2. Voilà le token à utiliser dans l'extension dotclear que nous allons voir, copiez/collez-le dans un coin et gardez-le secret.

2. Installation de l'extension Piwik pour dotclear 2

Nous allons voir à présent comment interfacer Piwik avec dotclear 2, plugin réalisé par Olivier Meunier (Attention, ce plugin n'est compatible qu'avec les versions de dotclear 2 et supérieures).
Allez télécharger ou installer via l'interface d'administration de dotclear le plugin qui se trouve ici.
Une fois installé vous devriez le voir apparaitre dans le menu des extensions. Il vous reste à entrer toutes les informations nécessaire au plugin.
Votre URL Piwik : c'est l'URL complète où est installé votre répertoire piwik ("http://votredomaine/piwik/index.php"
Votre token Piwik : c'est là que l'on colle le token vu plus haut (sans le champ "token_auth =").
Site Piwik à suivre : ça c'est cool, vous ne devriez en avoir qu'un seul pour l'instant mais rien ne vous empêche de créer d'autres comptes piwik sur d'autres sites. Aprés, il ne vous restera juste qu'à choisir le site dont vous voulez extraire les stats. Libre à vous d'en créer un nouveau directement via l'interface avec "Créer un nouveau site Piwik pour ce blog".
Utiliser des noms de page améliorés : ?
Ne pas activer le suivi sur les adresses IP suivantes : si vous voulez mettre en liste noire certaines adresses.
Voir les statistiques : c'est l'accès direct à vos stats.

J'espère qu'avec tout ça, ce sera "un peu" plus clair et répondra aux questions que certains se posent...

Merci aux créateurs de Piwik ainsi qu'à Olivier pour ce super plugin. Ce n'est pour l'instant pas encore aussi complet qu'un google analytics mais c'est libre et déjà très fonctionnel ! pour ma part, j'utilise actuellement les 2 car ils se complètent très bien, et si un jour je peux me passer de google analytics pour n'utiliser que piwik ou d'autres solutions libres, ce sera tant mieux !

liens:
http://www.dotclear.net/blog/...

http://www.pianopenguin.net/index.php