O que são plugins
Explicação simples, com exemplos, do que um plugin faz e como usar.
Pense no Altibooth como um celular. Ele já vem com o essencial: tira a foto, monta o layout, imprime e entrega pelo QR code. Um plugin é como um aplicativo que você instala nesse celular para ele fazer uma coisa a mais, que não vem de fábrica.
Na prática, um plugin é uma pasta com dois arquivos pequenos. Um descreve o plugin (nome, o que ele pede para acessar e quais campos de configuração ele tem). O outro é um texto em JavaScript com o que ele faz.
O que um plugin consegue fazer#
O Altibooth avisa o plugin nos momentos importantes: quando alguém toca para começar, quando a sessão termina, quando uma foto é tirada, quando vai imprimir. Em cada aviso o plugin pode agir. Alguns exemplos do que dá para criar:
- Uma tela de boas-vindas antes da sessão, com o nome da festa e um botão Começar. E uma tela de agradecimento no final.
- Cobrar de outro jeito. O plugin segura o início da sessão, mostra um QR code de pagamento na tela, pergunta ao seu sistema se o pagamento caiu e só então libera a sessão.
- Avisar outro sistema quando uma sessão termina, por exemplo mandar uma mensagem ou gravar numa planilha.
- Contar sessões e mostrar "você é o convidado número 50".
- Recusar sessões em horários que você definir.
Como usar um plugin#
- Na tela inicial do Altibooth, abra Plugins.
- A lista mostra os plugins instalados. Clique no cartão de um plugin para ver a descrição, o que ele pede para acessar e os campos de configuração.
- Preencha os campos e clique em Guardar. A configuração vale na hora.
- Ligue o interruptor do plugin. O programa avisa que a escolha passa a valer na próxima abertura e oferece Reiniciar agora.
Para instalar um plugin novo, clique em Escolher plugin e selecione o arquivo .zip do plugin (ou o plugin.json dele). O Altibooth copia tudo para a pasta de plugins e o plugin aparece na lista, desligado.
É seguro?#
Um plugin só alcança o que ele pediu e você pôde ver antes de ligar. Cada plugin declara permissões, e a tela de Plugins mostra cada uma em português:
- Acompanhar e segurar o início da sessão.
- Desenhar por cima da tela da cabine.
- Falar com a internet.
- Ler e gravar na pasta do próprio plugin.
- Acompanhar e cancelar impressão.
- Ler a lista de eventos e as fotos da sessão.
O plugin que não pediu internet não consegue usar a internet. Um plugin também não alcança a licença do programa nem a cobrança Stripe do Altibooth. E se um plugin der erro no meio de uma sessão, ele é desligado na hora, para não estragar a festa.
Onde ficam#
Os plugins do dono da cabine ficam em %APPDATA%\Altibooth2\plugins. Quem sabe programar pode criar o seu: veja Criar um plugin e a Referência de plugins.