Visualiser une révision

Tuto Piwik - Ajouter un robot

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)