EauFroide : révision n°15 (28 février 2017 17:23:51)
## Introduction ##
Il existe actuellement des centaines voir des milliers de [robots](https://fr.wikipedia.org/wiki/Bot_informatique) ([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 a la capacité de détecter les robots qui utilisent une chaîne de caractères spécifique dans leur [User-Agent](https://fr.wikipedia.org/wiki/User-Agent).
La liste contenant les informations pour chaque [bot](https://fr.wikipedia.org/wiki/Bot_informatique) détecté par Piwik se situe à l'[adresse suivante](https://github.com/piwik/device-detector/blob/master/regexes/bots.yml).
Il est conseillé de savoir se qu'est une [regex](https://fr.wikipedia.org/wiki/Expression_rationnelle) pour ajouter un robot.
Voici un exemple d'ajout d'un bot au code source 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 ! (追記) 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](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
```yaml
- 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](https://fr.wikipedia.org/wiki/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](https://www.grafikart.fr/formations/git/fork-pull-request)
1. 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".
1. 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](https://www.0rion.netlib.re/forum4/viewtopic.php?f=63&t=537&p=1152#p1152) (tuto d'origine)
* [[Tuto/HowTo] [phpBB3] Ajouter des robots](https://www.0rion.netlib.re/forum4/viewtopic.php?f=63&t=359)