PlayBot

Description

PlayBot est un bot IRC permettant de manipuler des liens audio :

• enregistrement des liens dans une base de données ;
• récupération et publication sur le chan des informations (titre, posteur) ;
• normalisation du lien ;
• sauvegarde de liens en favoris ;
• rappel du lien en query.

Installation

Dépendances

PlayBot est codé en Perl. Il dépend des modules suivant :

• DBI ;
• DBD::mysql ;
• JSON ;
• LWP::UserAgent ;
• HTML::Parser ;
• HTML::Entities ;
• POE ;
• POE::Component::IRC ;
• Tie::File.

Configuration

Pour l'instant, seule la configuration de la base de donnée est externalisée. Vous devez créer un fichier playbot.json dans le même dossier que le fichier PlayBot.pl contenant les attributs suivant (les noms devraient être assez explicites) :

• bdd ;
• host ;
• user ;
• passwd.

Le reste de la configuration s'effectue encore directement dans le fichier PlayBot.pl. Les variables suivantes sont modifiables :

• $serveur ;
• $port ;
• $nick ;
• $ircname ;
• $username ;
• @channels ;
• $admin ;
• $baseurl.

Les noms des variables sont plutôt explicites.

baseurl contient l'url racine du site permettant de consulter le contenu de la base de données.

Utilisation

Dès qu'un lien est posté, le bot récupère le nom du contenu et de la personne l'ayant posté, et l'insère dans la base de données (grâce à l'unicité du lien et à sa normalisation, un même contenu ne peut être enregistré deux fois). Il poste ensuite sur le channel les informations récupérées avec l'id du contenu.

Les différentes commandes utilisables sont les suivantes sur le channel où se trouve le PlayBot :

• !fav [id] : enregistre en favoris le contenu possédant l'identifiant id. Si l'identifiant n'est pas préciser, le dernier contenu posté (et non inséré) est utilisé.
• !later [id [in [Xs|Xm|Xs]]] : demande au PlayBot de rappeler en query un contenu. La durée par défaut est de 6h. Si l'identifant n'est pas précisé, le dernier contenu posté est utilisé.