Need Help? par MenzAgitat
Catégorie : News - RSS - Informations
388 téléchargements
Description :
 
Description

Need Help? vous permet de donner à vos utilisateurs un accès simplifié aux rubriques d'aide que vous créerez.

Vous pourrez par exemple documenter les commandes de votre chan, vous créer une aide pour l'utilisation des commandes tcl, des aide-mémoire pour vos cours, des résultats sportifs, ou que sais-je encore ?
Les usages possibles sont infinis.

Reportez-vous à la liste des fonctionnalités et à la syntaxe ci-dessous pour des informations plus détaillées.


Fonctionnalités
  • Support multilingue (packs de langue français et anglais fournis).
  • Fonctionnement intuitif, aide contextuelle sur les commandes du script.
  • Messages d'aide multi-lignes / paragraphes.
  • Possibilité de définir un message d'aide générique qui s'affichera en tapant la commande d'aide sans arguments.
  • Vous pouvez associer un déclencheur à un sujet d'aide (par exemple !admin peut être associé au sujet "liste des administrateurs" pour en afficher le contenu.
  • Possibilité de créer des alias (sujets d'aide renvoyant vers le contenu d'un autre).
  • Possibilité d'effectuer une recherche ou d'en filtrer les résultats en utilisant des jokers (fonctionnalité disponible en mode consultation et avec les sous-commandes -list -triggerlist et -triggerinfo).
  • Lorsqu'un sujet d'aide n'est pas trouvé, suggère des sujets proches (phonétiquement, orthographiquement, mots communs, mots/lettres dans un ordre différent).
  • Commande d'aide disponible en public, message privé et partyline (hors déclencheurs).
  • Possibilité de définir des sujets globaux (disponibles sur tous les chans) ou locaux (disponibles sur un seul).
  • Les sujets d'aide peuvent comporter des espaces ou des caractères spéciaux.
  • Fonctionne aussi lorsque la commande est tapée en couleur, gras, etc...
  • Filtrage automatique (ou optionnel) des codes de style si le mode +c est détecté sur un chan ou sur le flag +h est défini sur un handle.
  • antiflood (ne concerne pas les administrateurs)
  • Création quotidienne d'une copie de sauvegarde de la base de données.
  • Nombreuses commandes d'administration pour une gestion simplifiée.


Syntaxe et documentation des sous-commandes

Pour activer Need Help? sur un chan, vous devez taper ceci en partyline de l'Eggdrop :
tcl
.chanset #NomDuChan +NeedHelp


et ceci pour le désactiver :
tcl
.chanset #NomDuChan -NeedHelp


Attention aux majuscules !

!aide -add [-noLF] [-global/#chan] <sujet> <contenu>
Crée un nouveau sujet d'aide ou ajoute du contenu à un sujet existant.
Si le sujet contient des espaces, utilisez des guillemets.
Le paramètre -noLF permet d'ajouter du texte supplémentaire à la suite d'une aide existante sans marquer de saut de ligne.
Utilisez [_SPACE_] si vous avez besoin d'espaces insécables dans le contenu.
Pour définir un message d'aide générique qui s'affichera en tapant !aide sans arguments, utilisez helpmsg comme nom de sujet.
Si le paramètre -global est spécifié, le sujet sera disponible depuis n'importe quel chan.

!aide -del(ete) [-global/#chan] <sujet>
Supprime un sujet d'aide.

!aide -ren(ame) [-global/#chan] <ancien sujet> <nouveau sujet>
Renomme un sujet d'aide.
Si un sujet contient des espaces, utilisez des guillemets.

!aide -repl(ace) [-global/#chan] <sujet> <nouveau contenu>
Remplace le contenu d'un sujet d'aide par un nouveau contenu.
Si le sujet contient des espaces, utilisez des guillemets.
Utilisez [_SPACE_] si vous avez besoin d'espaces insécables dans le contenu.

!aide -copy [-global/#chan] <sujet source> <sujet destination>
Copie le contenu d'un sujet d'aide vers un autre.
Si un sujet contient des espaces, utilisez des guillemets.

!aide -alias [-global/#chan] <sujet source> <sujet lié>
Crée un alias qui renverra au sujet d'aide source.
Si un sujet contient des espaces, utilisez des guillemets.

!aide -list [-global/#chan] [filtre]
Affiche une liste de tous les sujets d'aide.
Vous pouvez spécifier un filtre de recherche en utilisant des jokers (*).
Si aucun emplacement n'est spécifié, la liste les inclura tous.
Les alias sont suivis par le symbole "»" pour faciliter leur identification.

!aide -trig(ger) [-global/#chan] <sujet d'aide> [déclencheur]
Crée un déclencheur personnalisé qui affichera le sujet d'aide spécifié.
Cette sous-commande ne peut être utilisée que depuis un chan.
Ce déclencheur ne fonctionnera que sur le chan sur lequel il a été défini.
Si le paramètre déclencheur est omis, affiche le déclencheur actuel.
Si le sujet contient des espaces, utilisez des guillemets.

!aide -deltrig(ger) [-global/#chan] <sujet d'aide> <déclencheur>
Supprime un déclencheur associé à un sujet d'aide.
Cette sous-commande ne peut être utilisée que depuis un chan.

!aide -trig(ger)info <déclencheur ou filtre>
Affiche des informations concernant le déclencheur spécifié.
Vous pouvez effectuer une recherche en utilisant des jokers (*).
Veuillez noter que si la commande est utilisée depuis un chan, la recherche ne s'effectuera que sur celui-ci, tandis que la commande privée ou en partyline effectuera une recherche dans tous les emplacements.

!aide -trig(ger)list [-global/#chan] [filtre]
Affiche une liste de tous les déclencheurs.
Vous pouvez spécifier un filtre de recherche en utilisant des jokers (*).
Si aucun emplacement n'est spécifié, la liste les inclura tous.

!aide -addtag [-global/#chan] <tag> <sujet> [sujet2] [...]
Ajoute un tag à un ou plusieurs sujets d'aide.
Un sujet d'aide peut avoir plusieurs tags.
Si un sujet d'aide contient des espaces, mettez des guillemets autour.
Le tag ne peut contenir que des caractères alphanumériques, des tirets et des underscores.

!aide -deltag [-global/#chan] <tag> <sujet> [sujet2] [...]
Enlève un tag d'un ou plusieurs sujets d'aide.
Si un sujet d'aide contient des espaces, mettez des guillemets autour.

!aide -taglist
Affiche une liste de tous les tags existants.

!aide -taginfo <tag>
Affiche une liste des sujets d'aide associés au tag spécifié.

!aide -tags [-global/#chan] <sujet>
Affiche une liste des tags associés au sujet d'aide spécifié.

!aide -help <sous-commande>
Affiche de l'aide sur l'utilisation d'une sous-commande.
Les sous-commandes disponibles sont -add, -del(ete), -ren(ame), -repl(ace), -copy, -alias, -list, -trig(ger), -deltrig(ger), -trig(ger)info, -trig(ger)list, -addtag, -deltag, -taglist, -taginfo, -tags ou -help.

!aide <sujet>
Affiche de l'aide sur le sujet spécifié.

!aide <filtre>
Effectue une recherche dans les sujets d'aide disponibles en utilisant un ou plusieurs jokers. Exemple : !aide *quote*
Si vous effectuez une recherche depuis un chan sans préciser d'emplacement, elle se fera dans les sujets qui lui sont liés et dans les sujets globaux.
Si vous effectuez une recherche par message privé sans préciser d'emplacement, elle se fera dans les sujets globaux uniquement.
Si vous effectuez une recherche en partyline sans préciser d'emplacement, elle se fera dans tous les emplacements.

!aide
Affiche un message d'aide générique s'il a été défini, sinon affiche la syntaxe de la commande !aide
La syntaxe affichée est adaptée selon l'accès de celui qui tape la commande, ce qui fait qu'un administrateur verra la syntaxe spécifique aux administrateurs et un simple utilisateur verra la syntaxe destinée aux utilisateurs.

La commande !aide possède également son équivalent en partyline (.aide) et par message privé avec l'Eggdrop (aide)

Lorsque vous utilisez les sous-commandes d'administration, l'emplacement sur lequel l'opération s'est effectuée est indiqué au début de chaque message du script afin d'éviter les méprises.


Quelques exemples pour vous lancer...

Citation :<MenzAgitat> !aide -add "test 1" ceci est un test
<Eggdrop> [#testchan] Ajout d'aide pour le sujet test 1. Total : 1 ligne.

<MenzAgitat> !aide -add -noLF "test 1" [_SPACE_]et on écrit à la suite
<Eggdrop> [#testchan] Ajout d'aide pour le sujet test 1. Total : 1 ligne.

<MenzAgitat> !aide -add "test 1" et maintenant sur une nouvelle ligne
<Eggdrop> [#testchan] Ajout d'aide pour le sujet test 1. Total : 2 lignes.

<MenzAgitat> !aide test 1
<Eggdrop> ceci est un test et on écrit à la suite
<Eggdrop> et maintenant sur une nouvelle ligne


<MenzAgitat> !aide -trigger "test 1" !test
<Eggdrop> [#testchan] Le déclencheur !test a été associé au sujet test 1.

<MenzAgitat> !test
<Eggdrop> ceci est un test et on écrit à la suite
<Eggdrop> et maintenant sur une nouvelle ligne


<MenzAgitat> !aide -add helpmsg Vous êtes perdu ? C'est par là --> http://www.ma-page-d-aide.com
<Eggdrop> [#testchan] Ajout d'informations dans l'aide générique. Total : 1 ligne.

<MenzAgitat> !aide -add helpmsg Pour avoir de l'aide sur une commande précise, tapez !aide [commande]
<Eggdrop> [#testchan] Ajout d'informations dans l'aide générique. Total : 2 lignes.

<MenzAgitat> !aide
<Eggdrop> Vous êtes perdu ? C'est par là --> http://www.ma-page-d-aide.com
<Eggdrop> Pour avoir de l'aide sur une commande précise, tapez !aide [commande]


<MenzAgitat> !aide -add !quote Syntaxe : !quote <n° de quote> [#chan] | Affiche la citation dont vous avez spécifié le numéro.
<Eggdrop> [#testchan] Ajout d'aide pour le sujet "!quote". Total : 1 ligne.

<MenzAgitat> !aide -addtag citations !addquote !citations !delquote !findquote !lastquote !quote !quoteinfo !randquote !votequote
<Eggdrop> [#testchan] Le tag "citations" a été ajouté aux sujets d'aide suivants : !addquote / !citations / !delquote / !findquote / !lastquote / !quote / !quoteinfo / !randquote / !votequote

<MenzAgitat> !aide !quote
<Eggdrop> Syntaxe : !quote <n° de quote> [#chan] | Affiche la citation dont tu as spécifié le numéro.
<Eggdrop> Voir aussi : !addquote | !citations | !delquote | !findquote | !lastquote | !quoteinfo | !randquote | !votequote


Post support :

http://forum.eggdrop.fr/showthread.php?tid=1520

Laissez vos commentaires / suggestions / rapports de bugs.


Vous pouvez trouver une liste de mes autres releases ici

Changelog

Version 2.01 par MenzAgitat (09/03/2016)
124 téléchargements
   

Version 2.0 par MenzAgitat (08/03/2016)
2 téléchargements
   

Version 1.1 par MenzAgitat (17/06/2015)
102 téléchargements
   
Version 1.01 par MenzAgitat (29/07/2014)
121 téléchargements
   

Version 1.0 par MenzAgitat (16/04/2014)
39 téléchargements