Visualiser une révision

Tuto Piwik - Ajouter un robot

EauFroide : ajout des liens wikipedia etc (15 février 2017 19:07:16)

## Introduction ##
Il existe actuellement des centaines voir des milliers de robots ([crawler](https://fr.wikipedia.org/wiki/Robot_d'indexation), [dataminer](https://fr.wikiversity.org/wiki/Datamining), etc) et [Piwik](https://piwik.org/) ne les détecte pas tous. 
Piwik à la capacité de détecter les robots qui utilise une chaîne de caractères spécifiques dans leur [User-Agent](https://fr.wikipedia.org/wiki/User-Agent).
La liste contenant les informations pour chaque bot détecté par piwik se situe à l'adresse suivante : https://github.com/piwik/device-detector/blob/master/regexes/bots.yml
Il vous faut savoir se qu'est une [regex](https://fr.wikipedia.org/wiki/Expression_rationnelle) pour ajouter un robot.
Voici un exemple, par mes soins, d'ajout d'un bot au code de piwik : [commit 860a3f44435cb20874ce6043dd7260506cae6ccc](https://github.com/piwik/device-detector/pull/5588/commits/860a3f44435cb20874ce6043dd7260506cae6ccc)

## Ajouter un ou plusieurs bots à la liste de Piwik ##
 **Note :** svp, respectez l'ordre alphabétique ! 

1. Vérifié que le robot n'est pas déjà présent dans la liste [bots.yml](https://github.com/piwik/device-detector/blob/master/regexes/bots.yml)

1. Vous inscrire/connecter sur [GitHub](https://github.com/)

1. Vous rendre dans [Piwik](https://github.com/piwik) > [device-detector](https://github.com/piwik/device-detector) > [regexes](https://github.com/piwik/device-detector/tree/master/regexes) > [bots.yml](https://github.com/piwik/device-detector/blob/master/regexes/bots.yml)

1. 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'UserAgent pour détecter le robot
* **name:'variable'** > son petit nom
* **category: 'variable'** > la categorie 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](https://www.grafikart.fr/formations/git/fork-pull-request)


## Farm Link ##
* [[Tuto/HowTo] Piwik ajouter des bots](https://www.0rion.netlib.re/forum4/viewtopic.php?f=63&t=537&p=1152#p1152)
* [[Tuto/HowTo] [phpBB3] Ajouter des robots](https://www.0rion.netlib.re/forum4/viewtopic.php?f=63&t=359)