La capacité d'accueil accueille les gens dans un salon. Un accueil a deux moitiés avec des publics différents : une courte ligne que toute la salle lit, et les lignes privées qui orientent le nouveau venu sans que personne d'autre les voie.
Les deux moitiés
| Réglage | Qui le lit | Quand |
|---|---|---|
public_greeting |
Tout le monde dans le salon | Seulement la première fois que ce bot rencontre ce pseudo ici |
greeting |
Le nouveau venu seul | À chaque arrivée que la fenêtre de répétition autorise |
onboarding_1 … onboarding_4
|
Le nouveau venu seul | À chaque arrivée que la fenêtre de répétition autorise |
visitor_greeting |
Le visiteur seul | Chaque fois que le visiteur ouvre le canal |
farewell |
Dépend de farewell_delivery | Au départ |
Comment les définir
/bot set <name> public_greeting <text>\n/bot set <name> greeting <text>\n/bot set <name> onboarding_1 <text>\n/bot set <name> onboarding_2 <text>\n/bot set <name> greeting_delivery private_notice\n/bot set <name> onboarding_delivery private_notice\n/bot set <name> greeter_repeat_window 43200\n/bot set <name> farewell none
Chacune accepte none pour l'effacer. Une ligne effacée est ignorée, donc un bot avec seulement un accueil se comporte exactement comme avant. Les lignes d'accueil sont numérotées plutôt qu'ajoutées : définir onboarding_2 deux fois la remplace, et c'est ce qui permet de coller un script de provisionnement plus d'une fois.
Comment un bot accueille les visiteurs
Un visiteur sans compte peut lire un canal. Ils ne peuvent pas le joindre ou le taper. Un visiteur ne reçoit ni greeting ni onboarding_1 … onboarding_4. Rien n'est dit dans le canal quand un visiteur arrive. Réglez visitor_greeting pour les accueillir. Seul le visiteur le voit. Il est envoyé chaque fois qu'ils ouvrent le canal. Aucun bot n'accueille les visiteurs jusqu'à ce qu'il soit réglé.
/bot set <name> visitor_greeting <text>
Envoi
| Mode | Effet |
|---|---|
public |
Un message dans le salon. Il est conservé dans l'historique. |
channel_notice |
Un avis dans le salon. Il est conservé dans l'historique. |
private_notice |
Un avis que seul le nouveau venu voit, dans la vue de ce salon. Il n'est pas conservé dans l'historique. |
silent |
Rien n'est envoyé. |
greeting_delivery couvre l'accueil ; onboarding_delivery couvre les lignes numérotées et retombe sur greeting_delivery quand il n'est pas défini. public_greeting est toujours public — c'est à cela qu'il sert.
Qui compte comme nouveau
Le bot note qui il a accueilli dans chaque salon, et cette note survit à un redémarrage. Quelqu'un qu'il n'a jamais rencontré reçoit la ligne publique et les privées. Quelqu'un rencontré il y a plus de greeter_repeat_window secondes reçoit à nouveau les privées, mais la salle n'est pas prévenue deux fois. Quelqu'un qui vient de partir ne reçoit rien.
Une fenêtre de répétition de 0 signifie qu'il n'y a pas de fenêtre : les lignes privées partent à chaque arrivée. La ligne publique part toujours une seule fois par personne, à jamais.
Espaces réservés
Chaque ligne accepte {nickname} pour la personne arrivée, {channel} pour la salle, {botname} pour le bot et {prefix} pour son préfixe de commande. Les lignes acceptent aussi les échappements de formatage IRC : \c04 rouge, \b gras, \o reset.
Garder la salle lisible
Un seul bot par salon devrait accueillir. Deux accueillants souhaitent la bienvenue deux fois à chaque nouveau venu, et c'est pourquoi un bot présent dans toutes les salles a greeting none. Gardez la ligne publique à une phrase : c'est la seule partie d'un accueil que toute la salle lit et la seule qui persiste. Tout ce qu'un nouveau venu doit apprendre appartient à la moitié privée.