Module Idea_mysql v 0.1
But :
Permettre le stockage des idées dans une base de données de type Mysql. L'ajout, la suppression, la consultationse se fait via l'irc par des commandes. Une todo list est ainsi crée en fonction du pseudo de l'utilisateur.
Logiciels nécessaires :
Les programmes suivants doivent être installés et correctement configurer sur votre poste :
- New Syndrome v1.4
- Mysql
Installation :
Après avoir installer et compiler le module au sein de
NewSyndrome, ainsi qu'installer Mysql et tester son fonctionnement. Il ne reste plus qu'à créer la/les table(s) qui va recevoir les données des idées ainsi qu'un acces à cette table. Suivant la configuration de Mysql sur votre serveur, il se peut qu'il faille créer une base de données au sein de votre serveur.
Configuration :
Pour configurer ce module, il y'a six paramètres à configurer via le fichier de configuration du bot :
- "login_idea" : Login de connexion à la base de données Mysql (défaut :
NewSyndrome).
- "pwd_idea" : Password de connexion à la base de données Mysq (défaut :
NewSyndrome).
- "db_idea" : Base de données contenant la table (défaut :
NewSyndrome).
- "table_idea" : Plusieurs cas possibles:
- Une table pour tous les channels, il suffit de mettre le nom de la table => table_quote=table_quotes
- Une table par channels => table_quote=#chanel1:table_quote_1,#chanel1:table_quote_1,etc...
- Une table pour le channel xxxx et tous les autres channels sur la même table => table_quote=#xxxx:table_quote_1,*:table_quote_2
Ne pas mettre d'espace entre les , ou : et toujours mettre le channel * (celui représentant tous les channels restants) en fin de ligne de configuration. Par défaut toutes les quotes de tous les channels vont dans la table quote_bot.
- "ip_idea" : Ip du serveur Mysql (défaut : 127.0.0.1).
- "port_idea" : Port du serveur Mysql (défaut : 3306).
Exemple :
Utilistation :
A chaque idée stockée dans la base de données correspond un identifiant (un nombre que l'on appellera id ou id_idea) et un pseudo.
Ce module répond à 5 commandes irc "publiques", sur le channel où chaque commande est précédée du caractère de commande du bot :
- addidea : Ajout d'un idée dans sa todolist.
=> Utilisation : addidea idée
- infoidea : Affiche des informations sur une idée donnée.
=> Utilisation : infoidea id_idea
- idea : Affiche l'idée correspondant à l'id communiqué par l'utilisateur
=> Utilisation : idea id_idea
- rmidea : Supprime l'idée correspondant à l'id communiqué par l'utilisateur seulement si l'utilisateur qui l'a ajouté est le même que celui qui veut la supprimer. Seul les administrateurs et les opérateurs peuvent supprimer des idées d'une autre personne, attention un opérateur d'un channel x peut supprimer les idées ajoutées par quelqu'un du channel y.
=> Utilisation : rmidea id_idea
- searchidea : Permet d'effectuer une recherche dans la base de données.
=> Utilisation : searchidea mot_rechercher : Affiche les 3 premieres idea ayant le mot recherché.
Exemple de construction des mots : pierre, p%e, pier%.
- todo : Affiche la todolist du pseudo qui l'a demandé en fonction des idées présente dans la base de donées.
=> Utilisation : todo
FAQ :
1) J'ai le messages qui s'affiche sur la console de New Syndrome :
"Erreur : Requête incorrecte : XXXXXXXXXXX"
=> Vérifier que la table sur laquelle la requête essaye de travailler existe.
=> Verifier que la requête et correcte, si ce n'est pas le cas, envoyez-la moi par mail.
2) J'ai le messages qui s'affiche sur la console de New Syndrome :
"Erreur : Impossible de se connecter à la bd mysql, vérifiez vos paramètres :
" * host : localhost"
" * port : 3306"
" * db : bot"
" * table : quotes"
" * login :
NewSyndrome "
" * password : xxxxx "
=> Vérifier que le serveur Mysql est en fonctionnement sur le bon port.
=> Vérifier que le login/password permet bien de se connecter au serveur Mysql.
=> Verifier que la base de données et la table existent.
3) J'ai le messages qui s'affiche sur la console de New Syndrome :
"Erreur : la requête : %s à supprimer plusieurs engregistrements (pseudo : toto)"
=> Un problème s'est produit dans la base de données, plusieurs IDEA avaient le même identifiant et on été supprimés.
Si ce problème se reproduit plusieurs fois, il faut contrôler le contenu de la base de données et chercher des doublons sur les identifiants.
4) J'ai le messages qui s'affiche sur la console de New Syndrome :
"Erreur : Pas de table mysql pour les ideas de #yyyy"
=> Votre configuration n'est pas correcte (le paramètre table_ideas) il manque la configuration pour le channel #yyyy.
5) J'ai trouvé un bug dans ce module, que dois-je faire?
=> Contactez-moi par mail en me donnant le plus d'information possible (version de New Syndrome, du système d'exploitation, de Mysql, du compilateur et de la libmysql).
6) J'ai une idée pour améliorer ce module, qui dois-je contacter?
=> Moi ;-), par mail de préference.