Plugin Hierarchical pie visualization for browser statistics Piwik

De EjnTricks
Révision de 20 septembre 2014 à 02:11 par Etienne (discussion | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Piwik permet de fournir une statistique sur les navigateurs utilisés. La représentation sous forme de camembert présente les statistiques par type de navigateur et selon leur version. Cette extension permet de représenter sous forme hiérarchique, avec une première information relative au type, puis une section en fonction de la version.

Attention ce plugin ne fonctionne plus en l'état avec la version 2X de Piwik. Malgré sa représentation séduisante, il ne sera plus utilisé.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


System-Install-icon.png Installation

Command-icon.png Mise en place

Le plugin est téléchargé à l'emplacement /var/datas/piwik/extensions/UserSettingsExt.zip avec l'outil wget depuis le site de Piwik.

#sudo wget -O /var/datas/piwik/extensions/UserSettingsExt.zip
http://dev.piwik.org/trac/raw-attachment/ticket/1558/UserSettingsExt.zip

--2012-03-29 00:41:18--  http://dev.piwik.org/trac/raw-attachment/ticket/1558/UserSettingsExt.zip
Résolution de dev.piwik.org... 91.121.92.93
Connexion vers dev.piwik.org|91.121.92.93|:80... connecté.
requête HTTP transmise, en attente de la réponse... 200 OK
Longueur: 26701 (26K) [application/zip]
Sauvegarde en : «/var/datas/piwik/extensions/UserSettingsExt.zip»

100%[=============================================================================================>] 26 701      --.-K/s   ds 0,1s

2012-03-29 00:41:19 (225 KB/s) - «/var/datas/piwik/extensions/UserSettingsExt.zip» sauvegardé [26701/26701]


Une fois téléchargé, il faut le décompresser, toujours dans le répertoire /var/datas/piwik/extensions.

#sudo unzip /var/datas/piwik/extensions/UserSettingsExt.zip -d /var/datas/piwik/extensions/
Archive:  /var/datas/piwik/extensions/UserSettingsExt.zip
 extracting: /var/datas/piwik/extensions/UserSettingsExt/Donut.swf
  inflating: /var/datas/piwik/extensions/UserSettingsExt/templates/browser.tpl
  inflating: /var/datas/piwik/extensions/UserSettingsExt/UserSettingsExt.php

Le fichier téléchargé n'est plus nécessaire et est supprimé.

#sudo rm /var/datas/piwik/extensions/UserSettingsExt.zip

Comme pour l'installation, il est recommandé de mettre en place les sécurités sur les fichiers, pour n'autoriser que le compte d'exécution du serveur Web, soit www-data.

#sudo chown -R www-data:www-data /var/datas/piwik/extensions/UserSettingsExt


Mise à disposition

La dernière étape de l'installation consiste à la mise à disposition du plugin dans l'instance de Piwik. Le plugin étant installé dans un répertoire externe, l'utilisation des liens permet de l'exposer.

#sudo ln -s /var/datas/piwik/extensions/UserSettingsExt /var/opt/piwik/plugins/UserSettingsExt
#sudo chown -h www-data:www-data /var/opt/piwik/plugins/UserSettingsExt

Puis, il faut activer le plugin depuis l'onglet Plugins dans les paramètres de l'application.


Update icon.png Update

Suite à l'installation de la version 1.8 ou 1.8.2 de Piwik, le plugin n'était plus fonctionnel. Seul le nom du navigateur était affiché et les données n'étaient plus organisées en fonction du numéro de version des navigateurs.

Lors de la mise à jour de Piwik, l'API getBrowser a été renommée en getBrowserVersion, comme indiqué sur la page du plugin http://dev.piwik.org/trac/ticket/1558. Il faut donc modifier le fichier UserSettingsExt.php du plugin. L'installation ayant été faite dans /var/datas/piwik/extensions/UserSettingsExt, le fichier se trouve à l'emplacement /var/datas/piwik/extensions/UserSettingsExt/UserSettingsExt.php. La modification porte sur l'argument HTTP apiAction pour la récupération des données.

<?php
/**
 * Piwik - Open source web analytics
 *
 * @link http://piwik.org
 * @license http://www.gnu.org/licenses/gpl-3.0.html Gpl v3 or later
 * @version $Id: UserCountryMap.php 1665 2010-07-25 21:25:57Z gka $
 *
 * @category Piwik_Plugins
 * @package Piwik_UserCountryMap
 */

/**
 *
 * @package Piwik_UserSettingsExt
 */
class Piwik_UserSettingsExt extends Piwik_Plugin
{
        const VERSION = '0.3';

        public function getInformation()
        {
                return array(
                        'name' => 'User Settings (extended)',
                        'description' => 'This plugin adds nicer visualization for visitors settings to your dashboard.',
                        'author' => 'Gregor Aisch',
                        'author_homepage' => 'http://vis4.net/',
                        'version' => self::VERSION
                );
        }

        function postLoad()
        {
                Piwik_AddWidget(Piwik_Translate('UserSettings_VisitorSettings').' (ext)', 'UserSettings_WidgetBrowsers', 'UserSettingsExt', 'browser');
        }
}

/**
 *
 * @package Piwik_UserSettingsExt
 */
class Piwik_UserSettingsExt_Controller extends Piwik_Controller
{
        function browser()
        {
                $view = Piwik_View::factory('browser');

                $request = new Piwik_API_Request(
                        'method=API.getProcessedReport&format=JSON'
                        /* . '&apiModule=UserSettings&apiAction=getBrowser' */
                        . '&apiModule=UserSettings&apiAction=getBrowserVersion'
                        . '&idSite=' . Piwik_Common::getRequestVar('idSite', 1, 'int')
                        . '&period=' . Piwik_Common::getRequestVar('period')
                        . '&date=' . Piwik_Common::getRequestVar('date')
                        . '&token_auth=' . Piwik::getCurrentUserTokenAuth()
                        . '&filter_limit=-1'
                );

                $view->jsonData = $request->process();
                $view->version = Piwik_UserSettingsExt::VERSION;
                echo $view->render();
        }

}

Fichier complet: media:UserSettingsExt patch.tar.gz

Fichier diff: media:UserSettingsExt diff.tar.gz

Viewer icon.png Rendu

L'utilisation de cette extension permet d'ajouter un nouveau widget sur le tableau de bord. Cette extension est disponibles à partir de Widgets & Dashboard, puis menu Paramètres visiteur (ext) → Navigateurs du visiteur.


Une fois ajouté au tableau de bord, le widget peut être positionné comme tous les autres. Si la vue par camembert est préféré pour visualiser les navigateurs utilisés, il peut même remplacer celui fourni en standard.


Viewer icon.png Voir aussi

Documentation officielle: http://dev.piwik.org/trac/ticket/1558