Envole

h1. Mise en place d'une sonde dans une application

h2. Insertion de la sonde

L'appel à la sonde Piwik est à présent normalisé.

En premier lieu votre application doit être CASsifié pour récupérer le profil de l'utilisateur.

En second lieu vous devez localiser dans votre application, un emplacement qui sera toujours exécuter : comme un header ou un footer.

Et insérer le code PHP suivant

<pre>

include("/var/www/html/piwik/envoleProfil.php");

echo "<script src='/piwik/envoleTrackeur.js.php?appli=monappli&profil=$profil'></script>";

</pre>

*include("/var/www/html/piwik/envoleProfil.php");*

Permet de récupérer le profil de l'utilisateur dans la variable $profil

En fonction de l'application, l'emplacement que vous utiliserez pourrait ne plus avoir l'objet phpCAS nécessaire au calcul de profil.

Dans ce cas, il vous suffira de le réinitialiser via les commandes suivantes

<pre>

require_once('CAS-1.3.1/eoleCAS.php');

require_once('configCAS/cas.inc.php');

// Chargement client CAS

eolephpCAS::client(__CAS_VERSION, __CAS_SERVER, __CAS_PORT, __CAS_URL, false);

if (__CAS_VALIDER_CA) {

    eolephpCAS::setCasServerCACert(__CAS_CA_LOCATION); 

} else {

    if (method_exists("eolephpCAS", "setNoCasServerValidation")){

        eolephpCAS::setNoCasServerValidation();

    }

}

</pre>

*echo "<script src='/piwik/envoleTrackeur.js.php?appli=monappli&profil=$profil'></script>";*

Permet d’exécuter la sonde en elle-même.

En remplaçant monappli par le véritable nom de votre application.

Ce script exécutera la sonde sur les serveurs Piwik potentiellement paramétrés sur votre serveur.

* Dans tout les cas le serveur Piwik présent sur votre serveur.

* Un serveur centralisé soit au niveau académique, régionale, groupe d'école comme vous le souhaitez.

* Un serveur national qui regroupe l'ensemble des Envole

h2. Paramétrer un serveur centralisé

Pour cela il vous suffira d'installer un Envole qui devra évidemment être visible sur le net et posséder un certificat valide.

Il vous suffira pas la suite dans l'ensemble des Envole sondé de paramétrer l'adresse du Piwik centralisé.

Ceci en deux zones :

Nom du domaine du serveur Piwik académique = l'url de base de votre serveur sans de / à la fin

Dans notre exemple = https://scribe23-tablette.ac-envole.fr

Base de l'URL de l'application piwik académique = l'alias du service Piwik sur ce serveur avec un / en début

Dans notre exemple = /piwik

Identifiant du site à utiliser pour l'envoi des statistiques Piwik académique = sur votre serveur centralisé vous aurez la possibilité de créer un site par serveur sondé.

Ce numéro correspond au numéro paramétrer pour ce serveur.

Vous pourrez laisser la valeur 1. Les statistiques arriveront toutes dans un même conteneur. Un peu moins pratique pour un suivi des données mais qui reste malgré tout lisible via l'utilisation des variables piwik qui correspondent aux données "Infos statistiques" que vous pouvez voir dans notre exemple.

Exemple de configuration d'un piwik centralisé 

!http://dev-eole.ac-dijon.fr/attachments/download/874/gen_config%20statistique.png!

h2. Les variables envoyées aux différents Piwik

La sonde envoi des informations complémentaire aux différents serveurs piwik. La plupart issu de données présentes dans le gen_config. En voici la liste

* RNE

* Nom

* Profil Utilisateur

* Provenance : interne ou externe

* Adresse

* CP

* Pays

* Type de serveur : école / collège / lycée / supérieur / autre_etab / rectorat / dsden / entreprise / autre

* Nature de serveur : développement / recette / production

* Fonction du serveur : ENT / PIA

* Application visitée