Atribuição de Licença
Quando um entitlement PLG (Plugin) é criado, uma licença de software é gerada. Esta página explica como as licenças são atribuídas, ativadas em sites, gerenciadas durante o ciclo de vida do entitlement, e o que acontece na renovação, suspensão e cancelamento.
Criação da licença
A chave de licença é gerada pela camada WooCommerce Software License. Cada licença é vinculada a:
- A Organização que a possui
- O Entitlement PLG que a concedeu
- O produto (plugin) que ela cobre
Ativação em site
Cada licença possui um número máximo configurável de ativações em sites. O cliente gerencia as ativações pelo portal:
Para ativar um site:
- O cliente navega até a licença no portal.
- Insere a URL do site (ex.:
meusite.com). - O sistema válida o formato da URL (TLD válido, sem protocolo, sem caminho).
- O sistema verifica se há vagas de ativação disponíveis.
- A ativação é registrada e o site pode receber atualizações e usar o plugin.
Para desativar um site:
- O cliente seleciona um site ativo da lista.
- Clica em desativar.
- A vaga de ativação é liberada imediatamente.
A desativação está sempre disponível, mesmo para licenças expiradas, para que os clientes possam organizar sua lista de sites.
Gestão de chaves de licença
- As chaves de licença são parcialmente mascaradas nas visualizações de lista por segurança (apenas os últimos caracteres são visíveis).
- As chaves completas são exibidas na tela de detalhes dentro do portal.
- O código do entitlement (ex.:
PLG-2026040142) fornece uma referência cruzada entre a licença e todos os registros relacionados (pedidos, faturas).
Aplicação do limite de sites
| Tipo de licença | Limite de sites |
|---|---|
| Padrão | Configurável por produto (ex.: 1, 3, 5 sites) |
| Bundle | Limites por plugin dentro do bundle |
| Agência | Ativações ilimitadas |
Quando o limite de ativações é atingido, o portal desabilita o botão "Ativar" e exibe uma mensagem direcionando o cliente a desativar um site existente ou fazer upgrade da licença.
O que acontece durante o ciclo de vida do entitlement
Na renovação
Quando um entitlement PLG é renovado (renovação automática ou manual):
- A data de expiração da licença é estendida para corresponder ao novo período do entitlement.
- Todas as ativações de site existentes permanecem intactas.
- O acesso a download continua sem interrupção.
Na suspensão
Quando um entitlement PLG é suspenso (tipicamente por falha de pagamento):
- O status da licença transiciona para suspenso.
- Ativações existentes permanecem -- sites que já ativaram a licença continuam funcionando com a versão atual.
- Novas ativações são bloqueadas -- o cliente não pode ativar sites adicionais.
- Atualizações são bloqueadas -- o cliente não pode baixar novas versões do plugin.
- Quando o pagamento é recuperado e o entitlement retorna a
active, todas as capacidades são restauradas.
Na expiração
Quando um entitlement PLG expira:
- A licença é marcada como expirada.
- Novas ativações são bloqueadas.
- Atualizações e downloads são bloqueados.
- A desativação permanece disponível (para que o cliente possa liberar vagas antes de renovar).
- O cliente vê um link de renovação no portal.
- Se o cliente renovar dentro do período de carência, a licença retorna a ativa com todas as ativações intactas.
No cancelamento
Quando um entitlement PLG é cancelado:
- A licença é marcada como inativa.
- Todas as capacidades são bloqueadas (sem ativações, sem atualizações, sem downloads).
- A licença permanece visível no portal pelo período definido pela CancellationPolicy (padrão: 90 dias de visibilidade).
- As ativações de site são mantidas no registro para auditoria, mas não são mais válidas.
Downloads
O acesso a download de arquivos de plugin está vinculado à licença:
- O cliente faz download de produtos pelo portal.
- Os downloads são autorizados na borda via Cloudflare Workers, que validam a chave de licença.
- Apenas licenças ativas e não expiradas concedem acesso a download.
- Licenças bundle mapeiam para múltiplos arquivos de plugin.
Páginas relacionadas
- Ativação de Entitlement -- Como entitlements PLG são criados
- Suspensão e Recuperação -- O que acontece quando pagamentos falham
- Fluxo de Compra e Renovação -- Mecânica de renovação
- Entitlement Classes -- Definições conceituais para PLG e outras classes