====== Piwik sur Simple Hosting ======
"Piwik est un outil opensource de mesure de statistiques web utilisés pas des particuliers, sociétés et gouvernements à travers le monde. Avec Piwik, vos données seront toujours à vous" - [[http://piwik.org/what-is-piwik/ | Source]]

===== Pré-requis =====
  * une instance PHP - MySQL Simple Hosting 
  * [[http://cli.gandi.net | Gandi CLI tool]] (optionnel)

===== Instructions =====

==== Configuration de l'instance ====
Créez une instance si ce n'est pas déjà fait :
<code>
$ gandi paas create --type phpmysql --name paas_name
</code>

Créez un Site/Vhost (exemple: //piwik.domain.tld//):
<code>
$ gandi vhost create --paas paas_name piwik.domain.tld 
</code>

==== Configuration PHP  ====
Piwik nécessite une modification du fichier php-custom.ini afin de finaliser l'installation.

Connexion à la console SSH :
<code>
$ gandi paas console paas_name
</code>

Editez le fichier /srv/data/etc/php/custom-php.ini pour ajouter la ligne suivante :
<code>
always_populate_raw_post_data=-1
</code>

Sauvegardez le fichier, quittez la console puis redémarrez l'instance pour que les changements soient effectifs.
<code>
$ gandi paas reboot paas_name
</code>

==== Configuration de la base de données =====
Vous créez ici une base de données nommée //piwik//, un utilisateur pour la base de données nommé //piwik// avec un mot de passe //CHANGE_ME//, puis vous assignez les privilèges pour cet utilisateur à cette base de données.

Connexion à la console SSH :
<code>
$ gandi paas console paas_name
</code>

Connectez-vous à MySQL via la ligne de commande et exécutez les commandes suivantes : 
<code>
$ mysql -u root -p

mysql> CREATE DATABASE piwik;
Query OK, 1 row affected (0.01 sec)

mysql> CREATE USER piwik;
Query OK, 0 rows affected (0.00 sec)

mysql> GRANT ALL ON piwik.* TO 'piwik'@'localhost' IDENTIFIED BY 'CHANGE_ME';
Query OK, 0 rows affected (0.00 sec)

mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)

mysql> QUIT;
</code>

==== Deploiement du code ====
Sur votre ordinateur local, clonez le dépôt git vide associé au vhost :
<code>
$ gandi paas clone --vhost piwik.domain.tld paas_name
</code>

Téléchargez les fichiers d'installation de piwik dans le dossier htdocs :
<code>
$ cd piwik.domain.tld
$ wget http://builds.piwik.org/piwik.zip
$ unzip piwik.zip
$ mv piwik htdocs
</code>

Commit des changements et déploiement du code :
<code>
$ git add .
$ git commit -am 'First commit of piwik installation'
$ git push gandi master
$ gandi deploy
</code>

==== Installation de Piwik ====

  * Naviguez jusqu'à l'adresse du vhost dans un navigateur web par exemple : %%http://piwik.domain.tld%%
  * Cliquez sur //Next//
  * Vérifiez que tout les pré-requis sont présents puis cliquez sur //Next//
  * Renseignez les informations de la base de données :
    * **Server Address**: localhost
    * **Login**: piwik
    * **Password**: CHANGE_ME
    * **Database Name**: piwik
  * Cliquez sur //Next//
  * Créez un compte Super User pour Piwik, puis cliquez sur //Next//
  * Vous pourrez renseignez un premier site dont vous souhaitez connaître les mesures de statistiques. Renseignez les informations nécessaires puis cliquer sur //Next//
  * Vous obtiendrez ainsi un code JavaScript à ajouter à votre site pour les mesure.

A ce point vous avez installé et configuré Piwik pour les mesures de statistiques. Vous aurez besoin d'ajouter le code JavaScript proposé dans les pages que vous souhaitez mesurez. Lorsque ces pages sont consultées, le code JavaScript envoie les statistiques à votre installation Piwik.

Pour plus d'informations sur la configuration et l'optimisation de Piwik, veuillez vous référer à la [[http://piwik.org/docs/ | documentation officielle]].

===== Lectures complémentaire =====

  * http://piwik.org/docs/
  * http://piwik.org/docs/installation/
  * http://piwik.org/docs/installation-optimization/