La capacità di benvenuto accoglie le persone in un canale. Un benvenuto ha due metà con pubblici diversi: una riga breve che legge tutta la stanza, e le righe private che orientano il nuovo arrivato senza che nessun altro le veda.
Le due metà
| Impostazione | Chi lo legge | Quando |
|---|---|---|
public_greeting |
Tutti nel canale | Solo la prima volta che questo bot incontra questo soprannome qui |
greeting |
Solo il nuovo arrivato | A ogni ingresso che la finestra di ripetizione consente |
onboarding_1 … onboarding_4
|
Solo il nuovo arrivato | A ogni ingresso che la finestra di ripetizione consente |
farewell |
Dipende da farewell_delivery | All'uscita |
Come impostarle
/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
Ognuna di esse accetta none per cancellarla. Una riga cancellata viene saltata, quindi un bot con solo un benvenuto si comporta esattamente come sempre. Le righe di benvenuto sono numerate anziché accodate: impostare onboarding_2 due volte la sostituisce, ed è questo che permette di incollare uno script di provisioning più di una volta.
Consegna
| Modalità | Effetto |
|---|---|
public |
Un messaggio nel canale. Resta nella cronologia. |
channel_notice |
Un avviso nel canale. Resta nella cronologia. |
private_notice |
Un avviso che vede solo il nuovo arrivato, nella vista di quel canale. Non resta nella cronologia. |
silent |
Non viene inviato nulla. |
greeting_delivery copre il benvenuto; onboarding_delivery copre le righe numerate e ripiega su greeting_delivery quando non è impostato. public_greeting è sempre pubblico — è a questo che serve.
Chi conta come nuovo
Il bot registra chi ha accolto in ogni canale, e quel registro sopravvive a un riavvio. Chi non ha mai incontrato riceve la riga pubblica e quelle private. Chi ha incontrato più di greeter_repeat_window secondi fa riceve di nuovo quelle private, ma alla stanza non viene detto due volte. Chi era qui poco fa non riceve nulla.
Una finestra di ripetizione di 0 significa che non c'è finestra: le righe private escono a ogni ingresso. La riga pubblica continua a uscire una volta per persona, per sempre.
Segnaposto
Ogni riga accetta {nickname} per chi è entrato, {channel} per la stanza, {botname} per il bot e {prefix} per il suo prefisso dei comandi. Le righe accettano anche gli escape di formattazione IRC: \c04 rosso, \b grassetto, \o reset.
Mantenere la stanza leggibile
Solo un bot per canale dovrebbe dare il benvenuto. Due accoglitori danno il benvenuto a ogni nuovo arrivato due volte, ed è per questo che un bot presente in ogni stanza ha greeting none. Tieni la riga pubblica a una frase: è l'unica parte di un benvenuto che legge tutta la stanza e l'unica che resta. Tutto ciò che un nuovo arrivato deve imparare appartiene alla metà privata.
