Topic Warden v1.11 par Anonyme
Catégorie : Topics
71 téléchargements
Description :
Description
Topic Warden est un script de gestion avancée de topic. Grâce à lui, il vous est possible de définir / maintenir / protéger le topic de vos chans, de définir des masques de topic contenant des variables que vous définissez librement, d'afficher des évènements dans le topic en fonction de la date et bien plus encore.

Ce script peut par exemple vous permettre de gérer le topic d'un chan associé à un serveur de jeu online, une variable permettrait d'afficher le statut du serveur, une autre le nombre de connectés, etc...
Mais ce n'est qu'un exemple, je l'utilise personnellement sur tous types de chans et il sait s'adapter à toutes les situations.

Une fois Topic Warden activé sur un chan, il devient impossible de modifier le topic sans passer par lui. De nombreuses commandes sont prévues à cet effet ainsi qu'un protocole de communication permettant à d'autres scripts d'interagir avec le topic via Topic Warden (voir la syntaxe plus bas).

Dans la section configuration du script, 4 paramètres ont un fonctionnement un peu particulier : admin_flags custom_flags variable_flags et display_flags.
Ces paramètres sont utilisés uniquement lors de la 1ère activation de Topic Warden sur chaque chan afin d'avoir une valeur par défaut à définir pour les autorisations. ILS NE SONT ENSUITE PLUS PRIS EN COMPTE et si vous souhaitez les modifier, vous devrez utiliser les commandes !topic adminflags, !topic customflags, ...
Il est toutefois possible de forcer le script à relire sa configuration par défaut et à se réinitialiser complètement comme si vous veniez juste de l'installer en tapant !topic reinstall.


Syntaxe des commandes publiques
!topic
Affiche le topic actuel sur le chan en cours.
!topic on
Active la gestion du topic par Topic Warden sur le chan en cours.
!topic off
Désactive la gestion du topic par Topic Warden sur le chan en cours.
!topic mask
Affiche le masque de topic actuel sur le chan en cours.
!topic mask <nouveau masque>
Modifie le masque de topic actuel sur le chan en cours.
!topic reset
Réinitialise le topic sur le chan en cours; la partie variable temporaire est remise à 0.
!topic reset all
Réinitialise le topic sur tous les chans sur lesquels Topic Warden est activé; la partie variable temporaire des topics est remise à 0.
!topic adminflags
Affiche le niveau accès minimum pour pouvoir utiliser les commandes administrateur du script (changer les masques, les paramètres) sur le chan en cours.
!topic adminflags <nouveaux flags>
Modifie le niveau accès minimum pour pouvoir utiliser les commandes administrateur du script (changer les masques, les paramètres) sur le chan en cours.
!topic variableflags
Affiche le niveau d'accès minimum pour pouvoir changer la partie variable temporaire du topic sur le chan en cours (%variable%).
!topic variableflags <nouveaux flags>
Modifie le niveau d'accès minimum pour pouvoir changer la partie variable temporaire du topic sur le chan en cours (%variable%).
!topic customflags
Affiche le niveau d'accès minimum pour pouvoir changer les variables "faites maison" du topic sur le chan en cours.
!topic customflags <nouveaux flags>
Modifie le niveau d'accès minimum pour pouvoir changer les variables "faites maison" du topic sur le chan en cours.
!topic displayflags
Affiche le niveau d'accès minimum pour pouvoir simplement demander l'affichage du topic sur le chan en cours au moyen de la commande !topic sans arguments.
!topic displayflags <nouveaux flags>
Modifie le niveau d'accès minimum pour pouvoir simplement demander l'affichage du topic sur le chan en cours au moyen de la commande !topic sans arguments.
!topic override <nouveau topic>
Modifie librement le topic sur le chan en cours sans tenir compte du masque enregistré.
!topic <texte>
Modifie la partie variable temporaire du topic sur le chan en cours (%variable%).
!topic variable
Affiche la partie variable temporaire du topic sur le chan en cours (représentée par %variable% dans le masque du topic).
!topic event
Affiche l'évènement du jour pour le chan en cours.
!topic event add <jour/mois> <évènement>
Ajoute un évènement sur le chan en cours. "jour" et "mois" doivent être précédés d'un 0 s'ils sont inférieurs à 10. La variable %event% sera remplacée par l'évènement du jour dans le masque du topic, chaque année à la même date.
!topic event del <n° d'évènement>
Supprime un évènement sur le chan en cours. Afin de connaître le numéro de l'évènement que vous voulez supprimer, vous pouvez utiliser la commande !topic event list (voir ci-dessous).
!topic event list
Affiche tous les évènements programmés pour le chan en cours.
!topic event list <argument de recherche>
Effectue une recherche d'évènements sur tous les chans. La recherche se fait aussi bien dans les dates que dans l'énoncé des évènements.
Les Jokers sont acceptés dans l'argument de recherche.
!topic set <nom_de_variable_perso> [nouveau contenu]
Affiche/définit le contenu d'une variable "faite-maison" (représentée par %nom_de_variable_perso% dans le masque du topic)
!topic unset <nom_de_variable_perso>
Supprime une variable "faite-maison" (représentée par %nom_de_variable_perso% dans le masque du topic)
!topic lastchange
Affiche des informations concernant la dernière modification de topic ayant eu lieu sur le chan en cours.
!topic reinstall
Réinitialise Topic Warden en ré-appliquant les réglages par défaut définis dans la section "paramètres" de ce script (voir plus bas).
Les fichiers contenant les évènements (topicwarden.events) et les variables personnalisées (topicwarden.customvars) sont renommés en y adjoignant l'extension .bak.
Soyez conscient que l'utilisation de cette commande effacera également les masques de topic enregistrés.
Après une réinitialisation, Topic Warden sera désactivé sur tous les chans, vous devrez donc le réactiver au moyen de !topic on.
!topic <aide/help>
Affiche la liste des commandes de Topic Warden auxquelles vous avez droit selon votre accès.


Syntaxe du protocole de communication permettant à d'autres scripts d'interagir avec Topic Warden afin de contrôler le topic
topic_control <nom du script appelant> <chan> mask <nouveau masque>
exemple : topic_control {mon script} #monchan mask {bienvenue sur #monchan}
topic_control <nom du script appelant> <chan> variable <nouveau contenu de %variable%>
exemple : topic_control {mon script} #monchan variable {coucou les gens}
topic_control <nom du script appelant> <chan> reset
exemple : topic_control {mon script} #monchan reset
Retourne 1 si le topic a été corrigé par le reset ou 0 s'il était déjà correct.
topic_control <nom du script appelant> <chan> override <nouveau topic>
exemple : topic_control {mon script} #monchan override {joli topic}
topic_control <nom du script appelant> <chan> set <nom_de_variable_perso_1> <nouveau contenu_1> [<nom_de_variable_perso_2> <nouveau contenu_2> [ ... ]]
exemple : topic_control {mon script} #monchan set ma_variable_perso {contenu de ma variable perso}
Retourne 1 si l'opération a réussi, ou 0 la liste variables/contenus ne comporte pas un nombre pair d'éléments.
topic_control <nom du script appelant> <chan> unset <nom_de_variable_perso1> [<nom_de_variable_perso2> [ ... ]]
exemple : topic_control {mon script} #monchan unset ma_variable_perso
topic_control <nom du script appelant> <chan> event add <évènement à ajouter>
exemple : topic_control {mon script} #monchan event add {25/12 Joyeux Noël}
Retourne 1 si l'évènement a été ajouté correctement et 0 s'il a été impossible de l'ajouter (s'il existe déjà un évènement pour cette date).
topic_control <nom du script appelant> <chan> lastchange
exemple : topic_control {mon script} #monchan lastchange
Retourne une liste contenant un timestamp au format unixtime, l'auteur et le type de la dernière modification de topic ayant eu lieu sur $chan.
topic_control <nom du script appelant> <chan> get <mask/variable/event/nom_de_variable_perso>
exemple : topic_control {mon script} #monchan get ma_variable_perso
Retourne la valeur du masque de topic, de %variable%, de l'évènement pour la journée en cours ou d'une variable personnalisée.


Variables acceptées dans un masque de topic et explication de leur fonction
%variable%
Partie variable temporaire du topic. c'est la partie qu'on modifie sur un coup de tête pour citer un truc marrant, pour afficher la pensée du moment, etc..
Cette partie est modifiable en tapant simplement !topic <texte à substituer>
%event%
Cette partie sera automatiquement substituée par l'évènement du jour à minuit pile (s'il existe).
%date%
sera remplacé par la date du jour au format JJ/MM/YYYY
%weekday%
sera remplacé par le jour de la semaine en toutes lettres
%day%
sera remplacé par le jour du mois
%month%
sera remplacé par le mois en toutes lettres
%year%
sera remplacé par l'année
%blabla%
Remplacez "blabla" par ce que vous voulez, vous pourrez ensuite modifier cette partie du topic au moyen de la commande : !topic set blabla <texte à substituer>
Par exemple, vous pouvez envisager d'utiliser %news% dans votre masque de topic : "Voici mon bo topic. News : %news% et hop"
Ainsi, lorsque vous taperez !topic set news on a gagné \o/ votre topic deviendra : "Voici mon bo topic. News : on a gagné \o/ et hop"
Vous pouvez utiliser autant de variables "faites maison" différentes que vous le souhaitez.
Notez que les variables réservées %variable% et %event% sont pré-définies vides, ce qui fait qu'elles n'apparaissent pas dans le topic tant qu'elles ne sont pas définies autrement. Par contre, les variables personnelles n'existent pas en tant que variables tant que vous ne les avez pas définies au moyen de la commande !topic set nom_de_variable_perso blabla.


Post support
http://www.eggdrop.fr/board/showthread.php?tid=675

 

Changelog

Version 1 par (12/06/2010)
71 téléchargements
Description
Topic Warden est un script de gestion avancée de topic. Grâce à lui, il vous est possible de définir / maintenir / protéger le topic de vos chans, de définir des masques de topic contenant des variables que vous définissez librement, d'afficher des évènements dans le topic en fonction de la date et bien plus encore.

Ce script peut par exemple vous permettre de gérer le topic d'un chan associé à un serveur de jeu online, une variable permettrait d'afficher le statut du serveur, une autre le nombre de connectés, etc...
Mais ce n'est qu'un exemple, je l'utilise personnellement sur tous types de chans et il sait s'adapter à toutes les situations.

Une fois Topic Warden activé sur un chan, il devient impossible de modifier le topic sans passer par lui. De nombreuses commandes sont prévues à cet effet ainsi qu'un protocole de communication permettant à d'autres scripts d'interagir avec le topic via Topic Warden (voir la syntaxe plus bas).

Dans la section configuration du script, 4 paramètres ont un fonctionnement un peu particulier : admin_flags custom_flags variable_flags et display_flags.
Ces paramètres sont utilisés uniquement lors de la 1ère activation de Topic Warden sur chaque chan afin d'avoir une valeur par défaut à définir pour les autorisations. ILS NE SONT ENSUITE PLUS PRIS EN COMPTE et si vous souhaitez les modifier, vous devrez utiliser les commandes !topic adminflags, !topic customflags, ...
Il est toutefois possible de forcer le script à relire sa configuration par défaut et à se réinitialiser complètement comme si vous veniez juste de l'installer en tapant !topic reinstall.


Syntaxe des commandes publiques
!topic
Affiche le topic actuel sur le chan en cours.
!topic on
Active la gestion du topic par Topic Warden sur le chan en cours.
!topic off
Désactive la gestion du topic par Topic Warden sur le chan en cours.
!topic mask
Affiche le masque de topic actuel sur le chan en cours.
!topic mask <nouveau masque>
Modifie le masque de topic actuel sur le chan en cours.
!topic reset
Réinitialise le topic sur le chan en cours; la partie variable temporaire est remise à 0.
!topic reset all
Réinitialise le topic sur tous les chans sur lesquels Topic Warden est activé; la partie variable temporaire des topics est remise à 0.
!topic adminflags
Affiche le niveau accès minimum pour pouvoir utiliser les commandes administrateur du script (changer les masques, les paramètres) sur le chan en cours.
!topic adminflags <nouveaux flags>
Modifie le niveau accès minimum pour pouvoir utiliser les commandes administrateur du script (changer les masques, les paramètres) sur le chan en cours.
!topic variableflags
Affiche le niveau d'accès minimum pour pouvoir changer la partie variable temporaire du topic sur le chan en cours (%variable%).
!topic variableflags <nouveaux flags>
Modifie le niveau d'accès minimum pour pouvoir changer la partie variable temporaire du topic sur le chan en cours (%variable%).
!topic customflags
Affiche le niveau d'accès minimum pour pouvoir changer les variables "faites maison" du topic sur le chan en cours.
!topic customflags <nouveaux flags>
Modifie le niveau d'accès minimum pour pouvoir changer les variables "faites maison" du topic sur le chan en cours.
!topic displayflags
Affiche le niveau d'accès minimum pour pouvoir simplement demander l'affichage du topic sur le chan en cours au moyen de la commande !topic sans arguments.
!topic displayflags <nouveaux flags>
Modifie le niveau d'accès minimum pour pouvoir simplement demander l'affichage du topic sur le chan en cours au moyen de la commande !topic sans arguments.
!topic override <nouveau topic>
Modifie librement le topic sur le chan en cours sans tenir compte du masque enregistré.
!topic <texte>
Modifie la partie variable temporaire du topic sur le chan en cours (%variable%).
!topic variable
Affiche la partie variable temporaire du topic sur le chan en cours (représentée par %variable% dans le masque du topic).
!topic event
Affiche l'évènement du jour pour le chan en cours.
!topic event add <jour/mois> <évènement>
Ajoute un évènement sur le chan en cours. "jour" et "mois" doivent être précédés d'un 0 s'ils sont inférieurs à 10. La variable %event% sera remplacée par l'évènement du jour dans le masque du topic, chaque année à la même date.
!topic event del <n° d'évènement>
Supprime un évènement sur le chan en cours. Afin de connaître le numéro de l'évènement que vous voulez supprimer, vous pouvez utiliser la commande !topic event list (voir ci-dessous).
!topic event list
Affiche tous les évènements programmés pour le chan en cours.
!topic event list <argument de recherche>
Effectue une recherche d'évènements sur tous les chans. La recherche se fait aussi bien dans les dates que dans l'énoncé des évènements.
Les Jokers sont acceptés dans l'argument de recherche.
!topic set <nom_de_variable_perso> [nouveau contenu]
Affiche/définit le contenu d'une variable "faite-maison" (représentée par %nom_de_variable_perso% dans le masque du topic)
!topic unset <nom_de_variable_perso>
Supprime une variable "faite-maison" (représentée par %nom_de_variable_perso% dans le masque du topic)
!topic lastchange
Affiche des informations concernant la dernière modification de topic ayant eu lieu sur le chan en cours.
!topic reinstall
Réinitialise Topic Warden en ré-appliquant les réglages par défaut définis dans la section "paramètres" de ce script (voir plus bas).
Les fichiers contenant les évènements (topicwarden.events) et les variables personnalisées (topicwarden.customvars) sont renommés en y adjoignant l'extension .bak.
Soyez conscient que l'utilisation de cette commande effacera également les masques de topic enregistrés.
Après une réinitialisation, Topic Warden sera désactivé sur tous les chans, vous devrez donc le réactiver au moyen de !topic on.
!topic <aide/help>
Affiche la liste des commandes de Topic Warden auxquelles vous avez droit selon votre accès.


Syntaxe du protocole de communication permettant à d'autres scripts d'interagir avec Topic Warden afin de contrôler le topic
topic_control <nom du script appelant> <chan> mask <nouveau masque>
exemple : topic_control {mon script} #monchan mask {bienvenue sur #monchan}
topic_control <nom du script appelant> <chan> variable <nouveau contenu de %variable%>
exemple : topic_control {mon script} #monchan variable {coucou les gens}
topic_control <nom du script appelant> <chan> reset
exemple : topic_control {mon script} #monchan reset
Retourne 1 si le topic a été corrigé par le reset ou 0 s'il était déjà correct.
topic_control <nom du script appelant> <chan> override <nouveau topic>
exemple : topic_control {mon script} #monchan override {joli topic}
topic_control <nom du script appelant> <chan> set <nom_de_variable_perso_1> <nouveau contenu_1> [<nom_de_variable_perso_2> <nouveau contenu_2> [ ... ]]
exemple : topic_control {mon script} #monchan set ma_variable_perso {contenu de ma variable perso}
Retourne 1 si l'opération a réussi, ou 0 la liste variables/contenus ne comporte pas un nombre pair d'éléments.
topic_control <nom du script appelant> <chan> unset <nom_de_variable_perso1> [<nom_de_variable_perso2> [ ... ]]
exemple : topic_control {mon script} #monchan unset ma_variable_perso
topic_control <nom du script appelant> <chan> event add <évènement à ajouter>
exemple : topic_control {mon script} #monchan event add {25/12 Joyeux Noël}
Retourne 1 si l'évènement a été ajouté correctement et 0 s'il a été impossible de l'ajouter (s'il existe déjà un évènement pour cette date).
topic_control <nom du script appelant> <chan> lastchange
exemple : topic_control {mon script} #monchan lastchange
Retourne une liste contenant un timestamp au format unixtime, l'auteur et le type de la dernière modification de topic ayant eu lieu sur $chan.
topic_control <nom du script appelant> <chan> get <mask/variable/event/nom_de_variable_perso>
exemple : topic_control {mon script} #monchan get ma_variable_perso
Retourne la valeur du masque de topic, de %variable%, de l'évènement pour la journée en cours ou d'une variable personnalisée.


Variables acceptées dans un masque de topic et explication de leur fonction
%variable%
Partie variable temporaire du topic. c'est la partie qu'on modifie sur un coup de tête pour citer un truc marrant, pour afficher la pensée du moment, etc..
Cette partie est modifiable en tapant simplement !topic <texte à substituer>
%event%
Cette partie sera automatiquement substituée par l'évènement du jour à minuit pile (s'il existe).
%date%
sera remplacé par la date du jour au format JJ/MM/YYYY
%weekday%
sera remplacé par le jour de la semaine en toutes lettres
%day%
sera remplacé par le jour du mois
%month%
sera remplacé par le mois en toutes lettres
%year%
sera remplacé par l'année
%blabla%
Remplacez "blabla" par ce que vous voulez, vous pourrez ensuite modifier cette partie du topic au moyen de la commande : !topic set blabla <texte à substituer>
Par exemple, vous pouvez envisager d'utiliser %news% dans votre masque de topic : "Voici mon bo topic. News : %news% et hop"
Ainsi, lorsque vous taperez !topic set news on a gagné \o/ votre topic deviendra : "Voici mon bo topic. News : on a gagné \o/ et hop"
Vous pouvez utiliser autant de variables "faites maison" différentes que vous le souhaitez.
Notez que les variables réservées %variable% et %event% sont pré-définies vides, ce qui fait qu'elles n'apparaissent pas dans le topic tant qu'elles ne sont pas définies autrement. Par contre, les variables personnelles n'existent pas en tant que variables tant que vous ne les avez pas définies au moyen de la commande !topic set nom_de_variable_perso blabla.


Post support
http://www.eggdrop.fr/board/showthread.php?tid=675