Licenças

Uma Licença é uma licença de software vinculada a um entitlement PLG (Plugin). Ela rastreia quais sites estão autorizados a usar o software, gerencia ativação e desativação por domínio, controla o acesso a downloads e cuida da renovação. Se o entitlement pai for suspenso ou cancelado, a licença segue.

Como as licenças são criadas

Licenças são criadas automaticamente quando um entitlement PLG é provisionado. Quando um cliente compra um produto de plugin e o pagamento é confirmado, o sistema:

1. Cria um entitlement PLG com um código único (ex.: PLG-2026050042).
2. Gera uma chave de licença para o entitlement.
3. Habilita o acesso a download para os arquivos de plugin associados.

Nenhum passo manual é necessário. O cliente vê sua chave de licença e link de download no portal imediatamente após a compra.

Chave de licença

Toda licença possui uma chave única gerada na criação. A chave é:

• Única — nenhuma duas licenças compartilham a mesma chave
• Persistente — a chave não muda na renovação ou reativação
• Parcialmente mascarada em visualizações de lista — a chave completa é visível apenas na página de detalhes da licença

Clientes referenciam essa chave ao ativar o plugin em seus sites.

Ativação por site

Licenças funcionam com base em domínio. Um cliente ativa sua licença em um domínio específico (ex.: lms.empresa.com), e o sistema registra essa ativação. Cada licença possui um número máximo de ativações permitidas, configurável por produto.

Ação	O que acontece
Ativar	Cliente registra um domínio na licença. Um slot de ativação é consumido.
Desativar	Cliente remove um domínio. O slot de ativação é liberado para reutilização.

Ambas as operações são instantâneas. O cliente gerencia ativações pelo portal ou pela verificação de licença integrada ao plugin (chamada API a partir do site ativado).

Limites de ativação

Tipo de licença	Comportamento do limite
Standard	Número fixo de ativações (ex.: 5 sites). Configurável por produto.
Agency	Ativações ilimitadas. Sem restrição de domínio.
Bundle	Múltiplos plugins sob uma licença. A ativação é rastreada por plugin.

Quando o limite de ativação é atingido, o cliente deve desativar um domínio existente antes de ativar um novo, ou fazer upgrade para um nível superior.

Válidação de domínio

O sistema válida o formato do domínio (TLD válido, sem prefixo de protocolo, sem caminho). Ativações duplicadas no mesmo domínio são rejeitadas. Se um domínio já estiver ativado em uma licença diferente, o sistema sinaliza o conflito.

Estados da licença

Status	O que significa
Active	Licença é válida. Ativações e downloads estão habilitados.
Expired	Data de expiração passou. Novas ativações são bloqueadas. Desativação ainda é permitida. Downloads são bloqueados.
Revoked	Permanentemente desabilitada pelo admin. Todo acesso removido.

O status da licença acompanha o entitlement pai: quando o entitlement PLG é suspenso, a licença se torna inativa; quando reativado, a licença volta.

Acesso a downloads

Clientes com uma licença ativa podem baixar os arquivos de plugin associados. Downloads são distribuídos pelo Cloudflare (Workers + R2) para desempenho e disponibilidade global:

1. Cliente solicita um download no portal.
2. O sistema válida: licença está ativa, produto corresponde, domínio está autorizado.
3. Uma URL assinada é gerada com expiração curta (5 minutos).
4. O cliente é redirecionado para o download no R2.

O acesso a download é bloqueado quando a licença está expirada ou revogada.

Renovação

Licenças são renovadas junto com seu entitlement pai. Dois caminhos de renovação existem:

Caminho	Como funciona
Automático	Se o produto é vendido como uma Assinatura WooCommerce, a renovação é tratada automaticamente. A assinatura renova, o entitlement permanece ativo e a licença continua funcionando.
Manual	Se não existe assinatura, o sistema envia lembretes de renovação (30, 15 e 7 dias antes da expiração, configurável pela Notification Policy) com um link para renovar.

Quando a renovação automática está ativa, os e-mails de lembrete são informativos. Quando a renovação é manual, os e-mails incluem um link direto de renovação.

O que os admins veem

No admin do WordPress, a lista de licenças mostra:

• Chave de licença (parcialmente mascarada)
• Nome do produto
• Organização
• Código do entitlement (PLG-xxx)
• Status (active, expired, revoked)
• Domínios ativados vs. máximo permitido
• Data de expiração

Clicar em uma licença abre sua visualização de detalhes com a chave completa, histórico de ativações e log de downloads.

Páginas relacionadas

• Entitlements — o registro pai que detém a licença
• Entitlement Classes — detalhes da classe PLG
• Documentos — arquivos disponíveis para download vinculados a licenças
• Policies — políticas de renovação e notificação que governam o comportamento da licença