A capacidade de saudação recebe as pessoas num canal. Uma boas-vindas tem duas metades com públicos diferentes: uma linha curta que a sala inteira lê, e as linhas privadas que orientam quem chegou sem mais ninguém ver.
As duas metades
| Definição | Quem lê | Quando |
|---|---|---|
public_greeting |
Toda a gente no canal | Só na primeira vez que este bot encontra esta alcunha aqui |
greeting |
Só quem chegou | A cada entrada que a janela de repetição permitir |
onboarding_1 … onboarding_4
|
Só quem chegou | A cada entrada que a janela de repetição permitir |
farewell |
Depende de farewell_delivery | Ao sair |
Como definir
/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
Qualquer uma delas aceita none para apagar. Uma linha apagada é saltada, portanto um bot só com saudação comporta-se exatamente como sempre. As linhas de boas-vindas são numeradas em vez de acumuladas: definir onboarding_2 duas vezes substitui, e é isso que permite colar um script de aprovisionamento mais de uma vez.
Entrega
| Modo | Efeito |
|---|---|
public |
Uma mensagem no canal. Fica no histórico. |
channel_notice |
Um aviso no canal. Fica no histórico. |
private_notice |
Um aviso que só quem chegou vê, na vista daquele canal. Não fica no histórico. |
silent |
Nada é enviado. |
greeting_delivery cobre a saudação; onboarding_delivery cobre as linhas numeradas e recai em greeting_delivery quando não está definido. public_greeting é sempre pública — é para isso que existe.
Quem conta como novo
O bot regista quem já recebeu em cada canal, e esse registo sobrevive a um reinício. Quem ele nunca encontrou recebe a linha pública e as privadas. Quem ele encontrou há mais de greeter_repeat_window segundos recebe as privadas de novo, mas a sala não é avisada duas vezes. Quem acabou de estar aqui não recebe nada.
Uma janela de repetição de 0 significa que não há janela: as linhas privadas saem a cada entrada. A linha pública continua a sair uma vez por pessoa, para sempre.
Marcadores
Toda a linha aceita {nickname} para quem entrou, {channel} para a sala, {botname} para o bot e {prefix} para o prefixo de comando dele. As linhas também aceitam os escapes de formatação IRC: \c04 vermelho, \b negrito, \o reset.
Manter a sala legível
Só um bot por canal deve saudar. Dois saudadores recebem cada novato duas vezes, e é por isso que um bot que fica em todas as salas tem greeting none. Mantenha a linha pública numa frase: é a única parte das boas-vindas que a sala inteira lê e a única que persiste. Tudo o que quem chega precisa de aprender pertence à metade privada.
