Die Begrüßungsfunktion heißt Leute in einem Kanal willkommen. Eine Begrüßung hat zwei Hälften mit unterschiedlichem Publikum: eine kurze Zeile, die der ganze Chatraum liest, und die privaten Zeilen, die den Neuling einführen, ohne dass jemand anderes sie sieht.
Die zwei Hälften
| Einstellung | Wer es liest | Wann |
|---|---|---|
public_greeting |
Alle im Kanal | Nur beim ersten Mal, wenn dieser Bot diesen Nick hier trifft |
greeting |
Nur der Neuling | Bei jedem Beitritt, den das Wiederholungsfenster zulässt |
onboarding_1 … onboarding_4
|
Nur der Neuling | Bei jedem Beitritt, den das Wiederholungsfenster zulässt |
visitor_greeting |
Nur der Besucher | Jedes Mal, wenn der Besucher den Kanal öffnet |
farewell |
Hängt von farewell_delivery ab | Beim Verlassen |
So werden sie gesetzt
/bot set <name> public_greeting <text> /bot set <name> greeting <text> /bot set <name> onboarding_1 <text> /bot set <name> onboarding_2 <text> /bot set <name> greeting_delivery private_notice /bot set <name> onboarding_delivery private_notice /bot set <name> greeter_repeat_window 43200 /bot set <name> farewell none
Bei jeder davon löscht none die Zeile. Eine gelöschte Zeile wird übersprungen, ein Bot mit nur einer Begrüßung verhält sich also genau wie immer. Die Einstiegszeilen sind nummeriert statt angehängt: Wenn du onboarding_2 zweimal setzt, wird die Zeile ersetzt, und genau deshalb kann ein Provisionierungsskript mehrmals eingefügt werden.
Wie ein Bot Besucher begrüßt
Ein Besucher ohne Konto kann einen Kanal lesen. Er kann ihm weder beitreten noch darin schreiben. Ein Besucher erhält weder greeting noch onboarding_1 … onboarding_4. Im Kanal wird nichts gesagt, wenn ein Besucher ankommt. Setze visitor_greeting, um sie zu begrüßen. Nur der Besucher sieht sie. Sie wird jedes Mal gesendet, wenn er den Kanal öffnet. Kein Bot begrüßt Besucher, solange es nicht eingestellt ist.
/bot set <name> visitor_greeting <text>
Zustellung
| Modus | Wirkung |
|---|---|
public |
Eine Nachricht im Kanal. Sie bleibt im Verlauf. |
channel_notice |
Ein Notice im Kanal. Sie bleibt im Verlauf. |
private_notice |
Ein Hinweis, den nur der Neuling sieht, in der Ansicht dieses Kanals. Er wird nicht im Verlauf gespeichert. |
silent |
Es wird nichts gesendet. |
greeting_delivery gilt für die Begrüßung; onboarding_delivery gilt für die nummerierten Zeilen und fällt auf greeting_delivery zurück, wenn es nicht gesetzt ist. public_greeting ist immer öffentlich – dafür ist es da.
Wer als neu gilt
Der Bot merkt sich, wen er in jedem Kanal begrüßt hat, und das bleibt auch nach einem Neustart erhalten. Wer ihm noch nie begegnet ist, bekommt die öffentliche Zeile und die privaten. Wer ihm vor mehr als greeter_repeat_window Sekunden begegnet ist, bekommt die privaten erneut, aber der Chatraum erfährt es nicht ein zweites Mal. Wer gerade erst hier war, bekommt nichts.
Ein Wiederholungsfenster von 0 bedeutet, dass es kein Fenster gibt: Die privaten Zeilen werden bei jedem Beitritt gesendet. Die öffentliche Zeile wird weiterhin nur ein einziges Mal pro Person gesendet.
Platzhalter
Jede Zeile akzeptiert {nickname} für die Person, die kam, {channel} für den Raum, {botname} für den Bot und {prefix} für sein Befehlspräfix. Zeilen akzeptieren auch die IRC-Formatierungs-Escapes: \c04 rot, \b fett, \o Reset.
Den Chatraum lesbar halten
Nur ein Bot pro Kanal sollte begrüßen. Zwei Begrüßer heißen jeden Neuling doppelt willkommen, weshalb ein Bot, der in jedem Kanal präsent ist, auf greeting none gesetzt wird. Halte die öffentliche Zeile auf einen Satz beschränkt: Sie ist der einzige Teil einer Begrüßung, den der ganze Chatraum liest, und der einzige, der bestehen bleibt. Alles, was ein Neuling wissen muss, gehört in die private Hälfte.