KB-PLUGIN-013: gotcha do bump de versão (plugin desativado até rodar plugin:install)

Verificado no butterfly/GLPI 11.0.8: CheckPluginsStates desativa o plugin
quando a version do setup.php muda; sintoma engana como falha de licença.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Gemini 2026-07-03 20:17:28 -03:00
parent 45e1cd8ad8
commit f3bf69c510

View file

@ -399,6 +399,15 @@ Mensagem padrão para o cliente:
4. **Não** atualiza `plugins.json` — o Mindplace pega automaticamente a release mais recente 4. **Não** atualiza `plugins.json` — o Mindplace pega automaticamente a release mais recente
5. Clientes verão o botão **Atualizar** no Mindplace dentro de 1 hora (cache TTL) 5. Clientes verão o botão **Atualizar** no Mindplace dentro de 1 hora (cache TTL)
> **Gotcha (verificado no butterfly, GLPI 11.0.8, 2026-07-03):** ao mudar a
> `version` do setup.php, o `CheckPluginsStates` do boot **desativa o plugin
> na hora** ("version changed... has to be launched") — status vira
> "Para atualizar", o setup.php deixa de ser carregado e os hooks somem
> (funções do plugin ficam indefinidas). No ambiente de dev, rodar
> `bin/console glpi:plugin:install <key> -u glpi && bin/console glpi:plugin:activate <key>`
> logo após o bump. Sintoma enganoso: parece que o kill switch/licença
> derrubou o plugin, mas é só o fluxo de update pendente.
### Revogar licença de um cliente ### Revogar licença de um cliente
1. No GLPI de produção: **Ativos → Licenças de Software** → encontrar o serial 1. No GLPI de produção: **Ativos → Licenças de Software** → encontrar o serial