# Diretrizes para Publicação no WordPress.org

## Compatibilidade entre Versões Gratuita e PRO

Ao desenvolver a versão PRO do UTM TRK, é importante manter compatibilidade com a versão gratuita disponível no WordPress.org. Isso facilitará o processo de atualização para os usuários existentes e garantirá uma transição suave.

### Estratégias de Compatibilidade

1. **Plugin Separado vs. Extensão**
   - **Opção Recomendada**: Desenvolver a versão PRO como um plugin separado que detecta e se comunica com a versão gratuita
   - **Alternativa**: Criar um sistema onde a versão PRO é uma extensão/add-on da versão gratuita

2. **Migração de Configurações**
   - Implementar um sistema que detecte configurações da versão gratuita e as migre automaticamente
   - Garantir que não haja perda de dados durante a atualização

## Requisitos do WordPress.org

Se você planeja manter a versão gratuita no repositório do WordPress.org, certifique-se de:

1. **Evitar Funcionalidades Crippled**
   - A versão gratuita deve ser funcional por si só, sem parecer incompleta ou inutilizável
   - Evite mensagens excessivas promovendo a versão PRO dentro da versão gratuita

2. **Separação de Código**
   - Mantenha o código da versão gratuita limpo e separado, sem referências diretas à versão PRO
   - Não inclua código desativado ou oculto da versão PRO

3. **Diretrizes de Promoção**
   - É permitido incluir um link para a versão PRO em:
     - Uma guia separada na página de configurações
     - Um link discreto no rodapé da página de configurações
     - Na descrição do plugin (readme.txt)
   - Não use popups, notificações constantes ou banners invasivos

## Preparação de Ativos Visuais

Para uma presença profissional no WordPress.org, prepare:

### Ícones
- Ícone do plugin (128x128 e 256x256 pixels)
- Formato PNG com transparência
- Design consistente com a identidade visual do plugin

### Banners
- Banner principal (772x250 pixels)
- Banner retina (1544x500 pixels)
- Formato JPG ou PNG
- Visual claro que comunique o propósito do plugin

### Capturas de Tela
- Pelo menos 4 capturas de tela mostrando diferentes funcionalidades
- Resolução recomendada de 1440px de largura
- Descrições claras no readme.txt
- Numeradas sequencialmente (screenshot-1.png, screenshot-2.png, etc.)

## Versionamento e Atualizações

### Sistema de Versionamento Semântico
- Use [Versionamento Semântico](https://semver.org/)
- Formato: X.Y.Z (Maior.Menor.Patch)
  - X: Mudanças incompatíveis com versões anteriores
  - Y: Adições de funcionalidades compatíveis com versões anteriores
  - Z: Correções de bugs

### Estratégia de Lançamento
- Versão gratuita: Atualizações regulares via WordPress.org
- Versão PRO: Sistema próprio de atualizações
  - Implementar verificação de licença
  - Garantir atualizações seguras

## Conformidade com Diretrizes do WordPress.org

Para evitar problemas com a revisão do plugin no repositório, certifique-se de:

1. **Código Seguro**
   - Validar e sanitizar todas as entradas de dados
   - Verificar permissões apropriadas para ações administrativas
   - Usar nonces para todas as ações

2. **Acessibilidade**
   - Seguir as diretrizes WCAG 2.0 nível AA
   - Garantir que o painel de administração seja navegável por teclado
   - Usar contraste adequado e texto alternativo para imagens

3. **Tradutibilidade**
   - Usar as funções de internacionalização
   - Fornecer arquivos POT para tradução
   - Usar o domínio de texto correto

4. **Desempenho**
   - Minimizar o impacto no carregamento do site
   - Carregar scripts e estilos apenas quando necessário
   - Usar práticas eficientes de consulta ao banco de dados

## Estratégia de Lançamento Dual

### Versão Gratuita (WordPress.org)
- Funcionalidade básica completa
- Atualizações regulares com melhorias e correções
- Documentação abrangente
- Repositório GitHub público

### Versão PRO (Site Próprio)
- Todos os recursos avançados
- Sistema de licenciamento e atualizações automáticas
- Suporte premium
- Demonstração ao vivo

## Publicação do Plugin

### Processo de Envio para o WordPress.org
1. Crie uma conta no WordPress.org (se ainda não tiver)
2. Envie seu plugin para revisão
3. Aguarde a aprovação (pode levar dias ou semanas)
4. Após aprovação, atualize o plugin conforme necessário usando SVN

### Dicas para Aprovação Mais Rápida
- Certifique-se de que seu código segue todas as diretrizes
- Documente bem o plugin com um readme.txt completo
- Teste exaustivamente todas as funcionalidades
- Responda prontamente a quaisquer perguntas da equipe de revisão

## Manutenção Contínua

### Versão Gratuita
- Mantenha um ciclo regular de atualizações
- Responda prontamente aos tópicos de suporte no fórum do WordPress.org
- Corrija bugs relatados pelos usuários

### Versão PRO
- Publique atualizações constantes com novos recursos
- Ofereça suporte técnico de alta qualidade
- Documente detalhadamente todas as funcionalidades
- Crie tutoriais e artigos mostrando casos de uso

---

Seguindo essas diretrizes, você garantirá que seu plugin atenda aos padrões do WordPress.org e terá uma estratégia clara para monetização com a versão PRO, mantendo uma versão gratuita útil e funcional que serve como porta de entrada para usuários potenciais.