Wiki Tuto Piwik - Ajouter un robot

Introduction

Il existe actuellement des centaines voir des milliers de robots (crawler, dataminer, etc) et Piwik ne les détecte pas tous.
Piwik a la capacité de détecter les robots qui utilisent une chaîne de caractères spécifique dans leur User-Agent.
La liste contenant les informations pour chaque bot détecté par Piwik se situe à l'adresse suivante.
Il est conseillé de savoir se qu'est une regex pour ajouter un robot.
Voici un exemple d'ajout d'un bot au code source de piwik : commit 860a3f44435cb20874ce6043dd7260506cae6ccc

Ajouter un ou plusieurs bots à la liste de Piwik

Note : svp, respectez l'ordre alphabétique ! Attention, certains bot ayant des UserAgent similaire ou contenu dans un autre bot, il faut veiller à éviter les conflits (par exemple si vous voulez ajouter un bot "Slu", vous devrez le mettre après "Slurp").

1. Vérifiez que le robot n'est pas déjà présent dans la liste bots.yml

2. Vous inscrire/connecter sur GitHub

3. Vous rendre dans Piwik > device-detector > regexes > bots.yml

4. Cliquez sur Édit et ajoutez les informations du robot en suivant la structure suivante

- regex: 'Googlebot(-Mobile|-Image|-Video|-News)?|Feedfetcher-Google|Google-Test|Google-Site-Verification|Google Web Preview|AdsBot-Google(-Mobile)?|Mediapartners-Google|Google.*/\+/web/snippet|GoogleProducer|Google[ -]Publisher[ -]Plugin'
  name: 'Googlebot'
  category: 'Search bot'
  url: 'http://www.google.com/bot.html'
  producer:
    name: 'Google Inc.'
    url: 'http://www.google.com'

• regex: 'variable' > l'expression régulière à chercher dans l'User-Agent pour détecter le robot
• name:'variable' > son petit nom
• category: 'variable' > la catégorie dans laquelle classée le robot
• url: 'variable' > l'URL pointant vers le fichier d'information officielle du bot

• producer:

  • name: 'variable' > Le nom de l'entreprise/personne qui se cache derrière le bot
  • url: 'variable' > L'URL du site de l'entreprise/personne qui gère le bot

1. Sauvegardez votre commit (n'oubliez pas de décrire vos changements) et créez le Pull Request
2. Checkez dans les heures/jours qui suivent si un mainteneur ne vous demande pas l'une ou l'autre correction. Le code sera accepté lorsque Github vous signalera un "Merge".
3. C'est terminé ! Le bot sera disponible dés la prochaine mise a jours mineur de piwik :)

Farm Link

• [Tuto/HowTo] Piwik ajouter des bots (tuto d'origine)
• [Tuto/HowTo] [phpBB3] Ajouter des robots