=== Afiliado ML Pro ===
Contributors: Ricardo Osório
Stable tag: 2.3.30
Requires at least: 6.2
Requires PHP: 7.4

Plataforma editorial WordPress para catálogo de produtos do Mercado Livre, links de afiliado, reviews, SEO, oportunidades de conteúdo, IA e auditoria de cliques.

== Versão 2.3.24 ==
- Refina o Novo produto: enquanto o cadastro ainda é novo, mostra somente a escolha Automático pela API / Manual e oculta métricas, histórico e gerenciamento até o primeiro salvamento.
- Importação automática passa a distinguir completa, parcial recuperável e insegura; ausência isolada de fotos permite continuar e complementar a mídia manualmente sem perder a sincronização da API.
- Cadastro manual exige somente nome, URL oficial, link de afiliado, categoria e ao menos uma foto; descrição objetiva, marca, modelo e especificações são complementares.
- Ajuda explica claramente API x manual e oferece atalho oficial para criar/revisar a aplicação no Mercado Livre Developers.

== Versão 2.3.21 ==
- Refina o wizard sem alterar os motores de importação/API estabilizados na 2.3.20.
- Corrige o hover/contraste dos seletores do admin (Mais vendidos, Buscar produto e URL exata).
- Corrige Revisar categoria no wizard: a lista real de categorias volta a aparecer com a categoria sugerida marcada.
- O fluxo editorial agora diferencia claramente Automático com IA, Etapa por etapa com IA e Manual por prompt.
- Sem chave OpenAI, o fluxo entra diretamente em Manual por prompt; falha de crédito/quota preserva etapas concluídas e oferece fallback manual.
- No modo Automático com IA, SEO → Review → Capa continuam sequenciais; no modo Etapa por etapa com IA, os botões individuais ficam visíveis.

== Versão 2.3.2 ==
- Auditoria comercial por produto: exibições do card, abertura de perguntas, cliques, pessoas e CTR.
- Rastreamento separado por CTA: card, texto, perguntas, comparativo e botão flutuante.
- Botão flutuante responsivo no celular, com fechamento por × e controle global/por produto.
- Selo de oferta verificada somente quando a sincronização é recente.
- Alternativa automática segura por categoria antes do fallback genérico.
- CTA comercial após a terceira pergunta respondida.
- Resumo comercial usando somente dados confirmados pela API.
- Comparativos com destaques objetivos (melhor avaliado, mais avaliações e curadoria).
- Configurações globais habilitadas por padrão e exceções por produto.
- Ajuda ampliada com compatibilidade de temas e plugins recomendados.

== Versão 2.3.1 ==

* Adiciona faixa escura dinâmica sobre a imagem destacada dos artigos ligados a um produto principal.
* Mostra “Produto analisado”, estrelas, nota e avaliações da oferta consultada, sem gravar texto na fotografia.
* Adiciona selo compacto nas miniaturas da página inicial e categorias, compatível com o destaque visual do tema Magazine.
* Inclui controles globais para ativar/desativar o selo no artigo e nas listagens.
* Cada produto pode seguir o padrão global, forçar a exibição ou ocultar individualmente o selo.
* O selo acompanha nota e avaliações atualizadas pela sincronização, sem OpenAI e sem regenerar o artigo.
* Produtos sem nota ou avaliações confirmadas permanecem sem selo e sem espaço vazio.
* Preserva as últimas perguntas confirmadas quando o endpoint fica temporariamente indisponível; um retorno oficial válido continua podendo atualizar ou zerar a lista.

== Versão 2.3.0 ==

* Exibe no card público um destaque de perguntas reais quando a API retornar perguntas respondidas para o anúncio.
* O botão abre um modal acessível com perguntas e respostas reais, sem alterar ou regenerar o artigo e sem consumir OpenAI.
* O modal inclui nova chamada para a oferta em outra aba, usando o link afiliado e a auditoria de cliques existentes.
* Produtos sem perguntas respondidas não exibem mensagem, contador, espaço vazio ou botão.
* O conteúdo das perguntas já permanece no HTML do artigo e acompanha as atualizações periódicas do produto.
* Perguntas repetidas, sem texto ou sem resposta não são exibidas publicamente.
* A sincronização passa a armazenar até 20 perguntas retornadas, permitindo exibir integralmente anúncios como o teste com 14 perguntas.

== Versão 2.2.9 ==

* Remove o cache local de uma hora da oferta comercial.
* Preço, promoção, textos, botão e URL passam a refletir diretamente a configuração atual da Central sempre que a tela bloqueada é aberta ou recarregada.
* Envia cabeçalhos contra cache intermediário na consulta comercial.

== Versão 2.2.8 ==

* Radar SEO, Oportunidades de Conteúdo e novo produto exibem uma tela comercial completa quando o limite gratuito é alcançado, sem deixar controles aparentemente ativos.
* Os produtos gratuitos existentes continuam liberados para Pesquisa SEO, Review, Capa, edição e monitoramento.
* Preço normal, preço promocional, período, textos e URL comercial passam a ser fornecidos pela Central TraderDicas por produto.
* Sem URL de compra configurada, o botão abre o WhatsApp com domínio, limite e preço atual já preenchidos.
* Pasta oficial de distribuição padronizada como afiliado-ml-pro.

== Versão 2.2.7 ==

* Mantém a inteligência e o fluxo consolidado da 2.2.6.
* Corrige o feedback do botão “Atualizar dados extras do Mercado Livre”, com processamento visível e retorno na área de Inteligência de Mercado.
* Corrige o CSS dos checkboxes “Produto ativo neste projeto” e “Produto destacado”.
* Adiciona acesso ao portal oficial Developer do Mercado Livre na configuração de API/OAuth.
* Adiciona guia visual “Como escolher e importar um produto?” junto ao fluxo de Mais Vendidos, com exemplo, orientação não obrigatória e atalho para Oportunidades de Conteúdo.

== Versão 2.2.6 ==

* Hotfix visual da própria 2.2.6: corrige a herança de flex dos spans internos do status, evitando texto espremido, barra deformada e linhas diagonais durante importação/atualização.
* UX unificada de processamento: botões exibem spinner, consultas mostram barra animada, aviso “não feche esta tela” e retorno visual de sucesso/erro.
* Importação e atualização passam a exibir um resumo compacto dos dados confirmados (fotos, atributos, avaliações, categoria, tendências, perguntas/visitas quando disponíveis) e destacam a seção atualizada com âncora suave.
* O atalho de dados extras acompanha visualmente a mesma atualização oficial do produto e retorna à seção Inteligência de Mercado ao terminar.
* Layout responsivo revisado para os novos estados de processamento e resumo em desktop e mobile.
* Consolida a inteligência de mercado sem alterar o fluxo automático já existente: Importar → Pesquisa SEO → Review → Capa → Revisar/Publicar.
* Estados de Vendidos, Visitas e Perguntas agora explicam quando o Mercado Livre não disponibiliza o dado, sem sugerir falha do plugin e sem transformar ausência em zero oficial.
* Perguntas reais, quando retornadas pela API, entram nos prompts de Pesquisa SEO/Review/FAQ; perguntas públicas não acessíveis à aplicação não são inventadas.
* Categoria, caminho, atributos da categoria, tendências e sinais de reviews enriquecem pesquisa e conteúdo. Atributos de categoria são tratados como mapa do nicho, não como especificações confirmadas do produto.
* Prompt de capa usa somente contexto visual útil e confirmado; não leva para a imagem preço, vendas, visitas, perguntas, tendências, estrelas ou fotos de compradores.
* Produtos existentes continuam usando o enriquecimento automático já introduzido na 2.2.5, sem reimportação e sem reescrever artigos publicados automaticamente.
* Correção de enriquecimento: category_id agora usa fallback do item, oferta, catálogo, User Product e preditor oficial antes de ser considerado indisponível.
* Visitas aceitam os formatos oficiais de resposta mais comuns sem confundir ausência com zero.
* Reviews enriquecidos passam a ler reviews_with_comment, quali_attributes e URLs dentro de media.variations; poucas páginas adicionais são consultadas para captar até 5 comentários/mídias sem pesar a API.
* Botão de importação passa automaticamente para “Atualizar dados do Mercado Livre” após a primeira importação e há atalho “Atualizar dados extras do Mercado Livre” junto aos novos dados.
* Estados separados explicam quando categoria, visitas, perguntas e detalhes de opiniões foram confirmados ou ficaram indisponíveis para o grant.
* Nova camada de inteligência oficial do Mercado Livre integrada ao cadastro e à atualização automática.
* Tendências oficiais por categoria entram no Radar e no contexto editorial quando a API disponibiliza o recurso.
* Categoria oficial, caminho da categoria e atributos possíveis passam a enriquecer mapa do nicho, SEO e prompts sem serem confundidos com especificações confirmadas do item.
* Reviews preservam distribuição de notas e passam a captar sinais adicionais de atributos avaliados e presença de mídia, sem republicar fotos/vídeos de compradores automaticamente.
* Visitas totais e dos últimos 30 dias são tratadas como sinal de interesse no anúncio, nunca como conversão; números só aparecem quando confirmados pela API.
* Perguntas reais, quando o grant permite acesso, alimentam pesquisa SEO, FAQ, objeções e oportunidades; indisponibilidade nunca é apresentada como zero oficial.
* Produtos automáticos já cadastrados são marcados para enriquecimento em segundo plano e não precisam ser reimportados.
* Radar recebe suporte a tendências oficiais, categoria do resultado e paginação para grandes volumes.
* Catálogo de produtos, histórico de alterações, histórico de ofertas e oportunidades de conteúdo recebem paginação/limites de tela para manter o painel leve no crescimento.
* Retenção configurada também limpa históricos antigos de Radar e mudanças informativas/revisadas, preservando alertas pendentes.
* Prompts automático e manual foram ampliados para usar tendências, categoria, atributos, reviews, visitas e perguntas sem inventar dados e sem transformar preço em destaque público.
* Estratégia comercial preservada: o preço continua interno/monitorado e o visitante é orientado a conferir preço, descontos e condições diretamente no Mercado Livre.
* Mantidos links, artigos, imagens, configurações, licença, atualização privada, auditoria, fallback de oferta e compatibilidade da 2.2.2.

== Versão 2.2.2 ==
* Novo plano gratuito permanente com até 5 produtos; não existe expiração por dias.
* Os cinco produtos podem usar o fluxo editorial completo e permanecem monitorados.
* Pesquisa SEO, review, capa e oportunidades agora exigem um produto válido, completo e salvo; a proteção também é aplicada no servidor.
* Cadastro automático exige importação confirmada, categoria, link afiliado e foto; cadastro manual exige ainda ficha factual e foto própria.
* O Radar SEO permanece disponível sem produtos para ajudar a encontrar o primeiro item.
* Ao atingir o limite, ficam bloqueadas novas pesquisas de produtos, Radar, descobertas e gerações em Oportunidades de Conteúdo.
* Produtos, artigos, imagens, categorias, links, histórico e configurações existentes nunca são apagados ou escondidos.
* Mensagens amistosas explicam que o projeto está crescendo e oferecem solicitação do plano anual pelo WhatsApp.
* Licenças Anual e Vitalícia válidas continuam removendo as limitações do plano gratuito.
* Categorias sugeridas pelo Perfil Editorial agora aparecem como escolhas visuais agrupadas em categoria principal e subcategorias.
* Itens selecionados recebem destaque verde; itens não selecionados permanecem neutros e não são criados.
* Criação continua não destrutiva: reutiliza categorias equivalentes, adiciona somente as novas e não apaga categorias, posts ou conteúdos existentes.
* Wizard recebe exemplos mais claros para nome do projeto, nicho e descrição editorial.
* Aviso de afiliado, CTA padrão, link alternativo, marca do site e marca guarda-chuva recebem explicações e exemplos contextuais.
* Link de ativação durante a configuração inicial leva diretamente à etapa de licença do Wizard.
* Mantém integralmente importação, API, IA, produtos, artigos, atualizador privado, licença, Radar, auditoria e proteções da 2.2.1.

== Versão 2.2.1 ==
* Corrige a oferta repetida da mesma versão após uma atualização concluída.
* Remove imediatamente do cache qualquer atualização igual ou inferior à versão instalada.
* Limpa o cache nativo de atualizações quando o WordPress termina de atualizar o plugin.

== Versão 2.2.0 ==
* Nova Central de Saúde com diagnóstico de licença, API, IA, WP-Cron e atualização automática.
* Indicadores de produtos sem link, sem foto, atrasados, indisponíveis ou aguardando revisão.
* Assistente do primeiro produto e progresso editorial Produto → SEO → Review → Capa → Publicação.
* Revisão periódica identificada para produtos cadastrados manualmente.
* Proteção pré-atualização com registro de versão e configurações não sigilosas.
* Histórico local das atualizações concluídas pelo WordPress.
* Exportação e importação seguras do Perfil Editorial, preferências e categorias, sem credenciais.
* Novo guia comercial “Comece aqui” voltado a sites WordPress de nicho.
* Mantidos o atualizador privado, importação Mercado Livre, IA, Radar, auditoria e fluxo manual da 2.1.22.

== Versão 2.1.22 ==
* Novo produto começa sem modo selecionado, deixando a tela mais limpa.
* Automático exibe somente os campos da API; Manual exibe somente a ficha manual.
* A escolha do modo abre e posiciona a tela diretamente no fluxo correspondente.
* Campos editoriais e recursos de IA permanecem disponíveis nos dois modos.

== Versão 2.1.21 ==
* Cadastro manual completo com URL oficial, ficha factual e galeria de até 10 fotos.
* Validação guiada exige nome, link afiliado, categoria e ao menos uma foto.
* Ajuda contextual e navegação automática entre importação, organização e fluxo editorial.
* Perfil Editorial passa a sugerir categorias revisáveis, espelhadas nas categorias dos posts somente após confirmação.

== Versão 1.0.0 ==
Primeira versão comercial consolidada a partir da base técnica 1.2.8.13.4.

* Mantém o motor já existente de importação, atualização, ofertas, avaliações e comentários do Mercado Livre.
* Mantém Radar SEO, Oportunidades de Conteúdo, modo automático OpenAI e modo manual com IA externa.
* Mantém auditoria, métricas próprias e painel de janela potencial de atribuição de 24 horas.
* Adiciona assistente de configuração inicial (wizard) para novas instalações.
* Cada instalação usa suas próprias credenciais do Mercado Livre e, opcionalmente, sua própria chave OpenAI.
* O modo manual de IA é compatível com serviços externos capazes de seguir o prompt e devolver JSON válido.
* As Ferramentas de Cultivo do projeto Cultive Já foram separadas do núcleo comercial e passam a ser um plugin complementar independente.

== Instalação ==
1. Instale e ative o plugin.
2. Siga o assistente inicial.
3. Para Mercado Livre API, crie sua própria aplicação no DevCenter, cadastre a Redirect URI exibida pelo plugin e informe Client ID/Client Secret.
4. Conclua o OAuth em Configurações.
5. Para IA automática, informe uma chave OpenAI com acesso/créditos. Sem ela, use o fluxo manual com IA externa.
6. Importe um produto, adicione seu link de afiliado, salve e então produza/revise o conteúdo.

== Observações ==
Mercado Livre e OpenAI são serviços independentes. O plugin não inclui credenciais de terceiros nem garante disponibilidade, comissão, indexação, vendas ou acesso às APIs. Revise conteúdos e dados antes de publicar.

Desenvolvido por Ricardo Osório.
© 2026 Ricardo Osório. Todos os direitos reservados.


== Changelog ==

= 2.3.30 =
* Auditoria: gráfico de evolução passa a usar escala diária contínua a partir do primeiro dia com dados, incluindo dias sem movimento como zero e evitando espaçamento enganoso entre datas consecutivas.
* Auditoria: períodos longos continuam compactos, mas agora os agrupamentos identificam claramente o intervalo de datas representado.
* Auditoria: janela potencial de 24 horas passa a mostrar até cinco produtos que receberam cliques, sem confundir clique com venda.
* Auditoria: histórico de alterações usa nomes e valores amigáveis já previstos pelo plugin, em vez de campos técnicos crus.
* Produtos: contador de registros incompletos passa a considerar o mesmo conjunto global de até 500 registros usado pela limpeza segura, e não apenas a página atual do catálogo.
* Refinos de estados vazios e consistência visual, preservando importação Mercado Livre, OAuth, links de afiliado, IA, artigos, capas, categorias, sincronização, licença, atualização, banco existente e front-end público.


= 2.3.26 =
* Estratégia editorial orientada por produto principal: Pesquisa SEO define conteúdo central e cluster satélite.
* Oportunidades de Conteúdo recebe automaticamente pautas derivadas do produto principal e marca a origem.
* Pesquisa SEO cruza conteúdos existentes para reduzir duplicação e canibalização, nos modos API e manual.
* Textos administrativos explicam o papel de Oportunidades de Produtos, Produto Principal e Oportunidades de Conteúdo.
* Fluxos de importação, Mercado Livre, afiliado, auditoria, licenciamento e ML Shop preservados.


= 2.3.20 =
* Novo cadastro automático com UX progressiva: escolha do modo, método de descoberta, importação e conclusão sem poluição visual.
* Após importar, o assistente destaca o link de afiliado como obrigatório antes de concluir o cadastro e mantém a revisão de categoria como opção clara.
* Botão “Salvar produto e continuar” conclui o wizard e leva ao fluxo editorial.
* Fluxo editorial ganhou modo Automático (Pesquisa SEO → Review → Capa) e Passo a passo, preservando publicação manual.
* Falhas em uma etapa preservam o que já foi concluído; falta de créditos libera o fluxo manual existente.
* Ajustes responsivos no flutuante público: hover verde consistente e leitura mais forte/completa de nota e avaliações.

= 2.3.15 =
* Corrige exclusão individual e em lote das palavras do Radar, mantendo o histórico de oportunidades.
* Mantém a ação de palavras sob a mesma proteção de licença do Radar.
* Sem publicidade, especificações e CTA passam a ocupar a largura total do card no desktop.
* Com publicidade ativa, o anúncio continua na coluna da galeria e o layout original é preservado.

= 2.3.14 =
* Microcorreção do card no desktop sem publicidade: o resumo de avaliações ocupa a coluna da galeria e os comentários seguem em largura total, evitando o espaço vazio.
* Microcorreção visual: sem publicidade responsiva, avaliações ocupam a área abaixo da galeria no desktop, eliminando o grande vazio quando há conteúdo disponível.
* Alinhamento das caixas de seleção e ações das palavras do Radar corrigido, inclusive ações em lote.
* Nenhuma alteração no motor de importação, API do Mercado Livre, score, licença ou proteção.

= 2.3.12 =
* Fecha a UX de Oportunidades de Produtos e Conteúdo com filtros, contadores e gerenciamento em lote das buscas do Radar.
* Adiciona publicidade responsiva opcional nos cards, desativada por padrão e independente do tema.
* Melhora a galeria com gesto lateral na imagem principal e ajusta o vazio visual do desktop sem reservar espaço quando anúncios estão desligados.

= 2.3.11 =
* Renomeia a experiência visível do Radar SEO para Oportunidades de Produtos, preservando slugs e motores internos para compatibilidade.
* Corrige a paginação do Radar para usar o slug real amlp-seo-radar.
* Explica com clareza de onde vêm as palavras-chave e separa sugestão por IA da validação objetiva pelos sinais do Mercado Livre.
* Adiciona fluxo manual universal para copiar um prompt de aprimoramento de palavras-chave, colar JSON e adicionar novas buscas sem apagar as existentes.
* Mostra "Por que esta nota?" com os principais fatores do score de oportunidade.
* Atualiza mensagens de Trial/licença e atalhos para Oportunidades de Produtos sem alterar importação, normalização de URL ou motores do Mercado Livre.

= 2.3.9 =
* Corrige o fluxo Radar SEO → cadastro/importação → Pesquisa SEO sem alterar os motores já estáveis.
* URLs intermediárias /registration?confirmation_url=... são normalizadas para a PDP oficial antes de salvar/importar.
* Acesso vindo do Radar inicia em modo Automático e mostra orientação do próximo passo.
* Pesquisa SEO não é mais bloqueada pela ausência do link de afiliado; o link continua obrigatório antes do Review.
* Após importar, o assistente destaca e rola para o próximo passo de forma mais clara.

= 2.3.8 =
* Compra anual passa a abrir o WooCommerce com ID da instalação e e-mail do Trial.
* URL comercial continua controlada pela Central, com fallback para o produto oficial.
* Pagamento aprovado e vinculado pela Central é reconhecido automaticamente pela instalação, sem exigir copiar a chave.
* Ativação manual por chave continua disponível como alternativa e segurança.
* WhatsApp deixa de ser fallback de compra e fica reservado ao suporte.


= 2.3.4 =
* Corrige o fechamento do CTA flutuante: ao tocar no × ele não reaparece durante o restante daquela página, mesmo após novos movimentos de scroll.
* O fechamento é isolado por artigo: ao navegar para outro conteúdo, o CTA pode aparecer normalmente.
* O CTA flutuante mantém celular + desktop e passa a usar preferencialmente o produto principal do artigo; quando não houver principal disponível, usa o primeiro produto elegível.
* Produtos com perguntas reais ganham um atalho compacto no CTA flutuante (ex.: “22 perguntas”), com rolagem suave até o bloco correto.
* A área de perguntas recebeu mais contraste, contador destacado, hover legível e realce temporário ao chegar pela âncora.
* A Auditoria passa a medir separadamente quantas pessoas foram até as perguntas pelo CTA flutuante e quantas abriram o modal de perguntas.
* Mantidos os controles globais e por produto, inclusive a exceção “Sempre ativar” mesmo quando o conjunto comercial global estiver desligado.

= 2.3.3 =
* CTA flutuante também no desktop, com layout compacto próprio e ativo por padrão.
* Celular e desktop identificados separadamente na Auditoria para cliques do CTA flutuante.
* Distância de segurança para controles comuns de “voltar ao topo”.
* Chave geral de recursos comerciais e exceções por produto.

= 2.2.6 =
* Consolidação dos dados extras do Mercado Livre nos prompts editoriais e melhoria das mensagens de disponibilidade de API.
* Renomeia o atalho para “Atualizar dados extras do Mercado Livre”.
* Mantém paginação, monitoramento, licença, preço público oculto e compatibilidade com produtos/artigos existentes.

= 2.2.4 =
* Inteligência de mercado: tendências oficiais, categoria e atributos, visitas e perguntas quando a API/grant permitir.
* Reviews enriquecidos com sinais adicionais para síntese editorial.
* Produtos existentes são marcados para enriquecimento automático sem reimportação.
* Pesquisa SEO e Review recebem os novos sinais oficiais nos modos automático e manual.
* Paginação server-side no catálogo e históricos do produto.
* UX responsiva para os novos painéis de inteligência de mercado.


= 2.1.20 =
* Corrige a consulta de novas versões na Central TraderDicas em instalações nas quais o filtro dinâmico de Update URI não era acionado.
* Integra diretamente com o verificador nativo de plugins do WordPress.
* O botão Verificar novamente passa a consultar a Central imediatamente, sem cache paralelo de seis horas.
* Preenche os metadados mesmo quando não há versão nova, liberando a opção Ativar atualizações automáticas na lista de plugins.
* Mantém integralmente a correção de cliques reais e todas as funções da 2.1.19.

= 2.1.19 =
* Adiciona atualizações privadas pela interface nativa do WordPress.
* Exibe aviso de nova versão, detalhes, botão Atualizar agora e suporte à opção de atualizações automáticas do WordPress.
* Consulta e download são autorizados pela licença ativa e pelo domínio cadastrado na Central TraderDicas.
* Preserva integralmente produtos, artigos, APIs, configurações, licença, Radar, auditoria e a correção de cliques reais da 2.1.18.

= 2.1.18 =
* Corrige a auditoria de cliques do Mercado Livre sem alterar o redirecionamento dos botões.
* Cliques só entram nas métricas quando carregam o identificador de visitante gerado no navegador pelo public.js.
* Crawlers, previews, scanners de links, bots conhecidos e acessos diretos ao endpoint deixam de inflar a contagem.
* Adiciona deduplicação de 30 segundos por visitante/produto para evitar duplo clique ou abertura duplicada.
* Mantém intactos produtos, artigos, links de afiliado, API, SEO, IA, licença e demais funções da 2.1.17.


= 2.1.16 =
* Corrige a seleção de produtos em Oportunidades: não completa mais automaticamente uma pauta até três produtos.
* Relevância passa a privilegiar termos distintivos da intenção e reduzir o peso de coincidências genéricas de marca/categoria.
* Pautas específicas podem recomendar somente um produto; comparativos e guias amplos continuam aceitando múltiplos produtos quando realmente pertinentes.
* Reanalisar recomendações mostra em vermelho produtos atuais fora do foco e permite inclusive remover todos os cards comerciais sem alterar texto, URL, SEO ou imagem.
* Pesquisa de novas Oportunidades reforça no prompt que 1 produto é suficiente quando a pauta é específica e que marca/categoria em comum não bastam para recomendar outro item.
* Radar automático passa a respeitar licença/tolerância também no cron, evitando varredura premium em segundo plano quando bloqueado.
* Licenciamento offline foi endurecido: timeout, HTTP 408/429 e 5xx preservam a última validação válida por até 15 dias; resposta explícita inválida continua sendo respeitada.
* Varredura técnica completa com validação de PHP, JavaScript, versões e integridade do pacote, preservando dados e comportamento existentes.

= 2.1.15 =
* Aprimoramento seguro do Perfil Editorial existente com prompt manual para IA, comparação antes de aplicar e confirmação antes de salvar.
* Novas buscas-semente podem ser acrescentadas sem apagar as já existentes no Radar.
* Licenciamento deixa claros os 7 dias iniciais de configuração e a proteção offline de até 15 dias após uma validação válida.
* Falha de comunicação com a Central registra a tentativa sem destruir a última validação válida; resposta explícita inválida continua bloqueando normalmente.
* Nenhum artigo, produto, categoria, histórico ou configuração existente é apagado pelo aprimoramento do perfil.

= 2.1.14 =
* Instalações realmente novas iniciam o Perfil Editorial vazio, sem herdar dados, sementes ou contexto do Cultive Já.
* Impede que configurações legadas cjp_settings preencham o Wizard em um novo projeto.
* Atualizações de instalações existentes preservam integralmente perfil, produtos, artigos, APIs, licença, Radar e demais configurações.
* Mantém o Wizard em português e o fluxo Projeto/Nicho → Mercado Livre → IA → Licença.

= 2.1.12 =
* Corrige o disparo do Wizard em instalações novas/resetadas.
* Novo onboarding conversacional em português, começando pelo projeto e nicho.
* Fluxo guiado: Perfil Editorial, Mercado Livre, IA, Licença e conclusão.
* Instalações existentes, como Cultive Já, preservam perfil e dados sem reabrir o Wizard.

== 2.1.11 ==
* Wizard guiado para novas instalações: o usuário descreve o nicho em linguagem natural, gera um prompt padronizado, abre o ChatGPT, cola a resposta JSON e revisa o Perfil Editorial antes de continuar.
* Exemplos dinâmicos para nichos especializados e amplos, como churrasqueiras e eletrodomésticos.
* Perfil gerado alimenta os mesmos campos já usados pela API e pelos prompts manuais, sem alterar instalações existentes como o Cultive Já.
* Mantém licenciamento, catálogo, Radar, auditoria e fluxo editorial da 2.1.0.


= 2.1.0 =
* Perfil Editorial universal por instalação: nicho, temas, público, estilo, limites e sementes do Radar.
* Migração segura do Cultive Já mantendo o contexto editorial atual.
* Wizard passa a orientar uma instalação nova sem conteúdo ou nicho pré-definido.
* Contexto de nicho aplicado aos fluxos automáticos e manuais de pesquisa SEO, review e Oportunidades.
* Radar deixa de criar sementes fixas de cultivo em instalações novas.
* Licenciamento integrado com a Central TraderDicas, suporte a plano Vitalício ou Anual, ativação, validação e desativação.
* Tela visual de licença com domínio, plano, validade e última validação.


= 2.0.3 =
* Mantém os motores de Mais Vendidos, busca por palavra-chave, URL exata, importação oficial, Radar, Pesquisa SEO, Review, Capa e publicação da 2.0.1.
* O botão “Abrir produto no Mercado Livre” usa somente o permalink oficial confirmado pela API; nunca usa o link de afiliado e fica desativado antes da confirmação.
* A tela do produto ganhou atalhos para Ver artigo no site e Editar artigo no WordPress; o catálogo também mostra os dois caminhos quando disponíveis.
* “Importar / atualizar dados oficiais” foi renomeado de forma contextual para Importar dados do Mercado Livre ou Atualizar dados do Mercado Livre.
* A URL exata continua como contingência separada e “Usar esta URL” aciona a importação/atualização.
* Observações do editor foram removidas da interface e deixaram de ser enviadas para a IA; metadados antigos são preservados apenas por compatibilidade.
* Categorias receberam CSS reforçado para checkbox compacto, eliminando o campo/barra horizontal.
* Administradores podem excluir definitivamente produto + artigo pela Zona de risco, com confirmação digitando EXCLUIR e validação do vínculo antes da remoção.


= 2.0.1 =
* Mantém integralmente os motores de importação, Mais Vendidos, busca, URL exata, IA e fluxo editorial da 2.0.0.
* Datas administrativas passam a ser exibidas em português do Brasil (dd/mm/aaaa às hh:mm), sem alterar o formato salvo no banco.
* Lista de categorias fica compacta e legível, com checkboxes no tamanho correto e melhor hierarquia visual.
* Histórico de alterações ganha legenda visual para separar atualização automática de revisão editorial recomendada.
* Campos técnicos recebem nomes mais claros e mudanças de ficha técnica passam a mostrar somente os atributos realmente alterados quando possível.
* Reanálise editorial recomendada passa a ser explicada como aviso, não erro: o artigo continua preservado até decisão manual.
* Catálogo exibe a recomendação com texto mais claro e link para o fluxo, mantendo a decisão editorial sempre manual.

= 2.0.0 =
* Mantém o motor de Mais Vendidos e a importação oficial já estáveis na 1.0.9.
* Resultados de descoberta sem foto ou sem título real continuam visíveis para conferência no Mercado Livre, mas não oferecem mais o botão de importação.
* Fluxo editorial passa a ter estados claros: falta Pesquisa SEO, falta Review, falta Capa, pronto para revisar, agendado e publicado.
* A foto oficial do produto usada provisoriamente no rascunho não conta como capa editorial concluída.
* Capas geradas pelo plugin e imagens destacadas diferentes das fotos oficiais do produto são reconhecidas como capa editorial concluída.
* O botão de revisão/publicação ganha destaque somente depois da capa; antes disso o editor é orientado a concluir a etapa 3.
* Catálogo de produtos mostra o próximo passo editorial de cada item e evita confundir rascunho criado com produto finalizado.
* Meta box do artigo no WordPress mostra o estado do fluxo e oferece retorno direto ao produto para concluir etapas pendentes.
* Mensagens de interface foram revisadas para explicar o motivo de bloqueios e manter a decisão final de importação/publicação sempre manual.

= 1.0.9 =
* Novo fluxo de descoberta: Mais Vendidos como caminho recomendado, busca por palavra-chave orientada ao ranking oficial e URL exata como alternativa.
* Busca por palavra-chave agora tenta primeiro localizar a categoria e retornar o ranking oficial /highlights.
* Resultados genéricos sem oferta ativa confirmada deixam de ser tratados como candidatos principais.
* Mensagens e interface revisadas para deixar claro o fluxo: localizar, verificar no Mercado Livre e só então importar.
* Radar SEO passa a levar a palavra-chave para o cadastro, facilitando a conferência e a busca do ranking correspondente.
* URL exata ganha contingência por dados públicos oficiais quando a API não estiver conectada, sem inventar campos ausentes.
* Fluxo existente de página de Mais Vendidos preservado.

= 1.0.8 =
* Reanalisa recomendações comerciais de artigos de oportunidade já criados.
* Exibe prévia com produtos atuais e novos candidatos antes de qualquer alteração.
* Sugere normalmente até três produtos e permite selecionar no máximo quatro.
* Distribui os cards entre as seções semanticamente relacionadas, evitando vários reviews completos consecutivos.
* Preserva título, URL, texto editorial, SEO, imagem e layout público durante a reavaliação.
* Seleção exige confirmação manual, diferencia produtos atuais e novos candidatos por cor e bloqueia produtos específicos fora do tema.

= 1.0.7 =
* Status real de cada conteúdo: novo, produto pendente, pronto, rascunho, revisão, agendado e publicado.
* Filtros por situação e palavra-chave, paginação e seleção em lote.
* Arquivamento e restauração sem apagar artigos do WordPress.
* Limpeza segura remove somente oportunidades sem artigo vinculado.
* Reanálise local distribui produtos novos por aderência, sem modificar artigos já criados.
* Botão do conteúdo diferencia rascunho, artigo publicado e demais estados.

= 1.0.6 =
* Novo modo Explorar palavra-chave para criar clusters editoriais completos.
* Cruzamento com produtos, artigos publicados e rascunhos existentes.
* Cobertura editorial identifica pauta nova, já coberta, semelhante ou complementar.
* Distribuição inteligente evita repetir sempre os mesmos produtos equivalentes.
* Volume mensal pode ser informado pelo editor sem ser confundido com Google Trends.
* Oportunidades passam a aceitar várias intenções para a mesma palavra central.


= 1.0.5 =
* Mantém integralmente o fallback e a Saúde das ofertas da 1.0.3.
* Remove preço e desconto dos cards e comparativos públicos; preço continua sincronizado no admin/API para auditoria e monitoramento.
* Padroniza CTA ativo como “Ver preço no Mercado Livre” e mantém “Ver outras opções no Mercado Livre” no fallback.
* Ajusta o JSON-LD para perfil editorial/Product: mantém Product + aggregateRating quando confirmado e visível, sem Offer/preço/estoque do comerciante.
* Adiciona Ano editorial automático (ano corrente) ou manual. O ano orienta novas oportunidades/conteúdos somente quando fizer sentido para intenção de atualidade/ranking, sem reescrever artigos publicados na virada do ano.
* Comparativos passam a priorizar avaliação, indicação editorial e CTA, sem preço volátil.


= 1.0.3 =
* Adiciona Link alternativo do Mercado Livre (fallback) configurável por instalação.
* Quando uma oferta individual é confirmada como pausada, encerrada, inativa ou excluída, o artigo e as imagens permanecem e os CTAs passam automaticamente para o link alternativo.
* O site público não expõe termos internos como “lista de afiliados” ou “fallback”; usa a mensagem “Esta oferta não está disponível no momento” e o CTA “Ver outras opções no Mercado Livre”.
* Adiciona Saúde das ofertas no painel, com contadores de fallback ativo, sem destino e lista de produtos que precisam de atenção.
* O catálogo passa a exibir o destino público de cada produto: link individual, fallback ativo, atualizar link individual ou sem destino.
* Adiciona vínculo de segurança entre o link individual e o ITEM_ID. Se um anúncio for substituído, o plugin não reutiliza silenciosamente o link antigo no novo ITEM_ID; o fallback permanece até o editor salvar um novo link individual.
* Preserva imagens já existentes quando uma oferta encerrada não devolver novas imagens na consulta oficial.
* Mantém o motor existente de importação, preços, reviews, comentários, Radar SEO, Oportunidades e IA, sem reestruturar esses módulos.
* Em atualização de uma instalação já configurada, não força novamente o assistente inicial; novas instalações continuam recebendo o wizard.

= 1.0.2 =
* Assistente: botão direto para o DevCenter/Minhas aplicações do Mercado Livre.
* OpenAI: mantém gpt-5.5 como modelo de texto padrão, igual ao núcleo atual do Cultive Já.
* Corrige o texto visual da versão no assistente para 1.0.2.
* Corrige a criação/atualização das tabelas no WordPress dbDelta em ambientes PHP/WordPress que exibiam avisos de índices (index_type, index_name, index_columns e column_name).
* Mantém inalterado o motor de importação, preços, reviews e comentários do Mercado Livre.

= 1.0.1 =
* Corrige o assistente de configuração: POST processado antes da saída do wp-admin para evitar "headers already sent".
* Motor Mercado Livre/reviews mantido sem alterações.



= 2.3.10 =
* Radar passa a agrupar o mesmo produto encontrado por várias palavras-chave, reduzindo duplicação visual.
* Produtos já cadastrados são reconhecidos automaticamente por ITEM_ID ou produto de catálogo e marcados como cadastrados no Radar.
* Status do Radar simplificados para Oportunidade, Em produção, Cadastrado e Descartar, com etapas mais claras.
* Cada oportunidade passa a explicar de forma curta por que foi destacada, usando apenas os sinais já coletados do Mercado Livre.
* KPIs do Radar passam a contar produtos únicos em vez de linhas repetidas por palavra-chave.
* Falta de crédito/quota da OpenAI deixa de aparecer como erro vermelho: o plugin orienta a continuação pelo fluxo manual, preservando os dados já importados.
* Mantém intacta a normalização de URL e o fluxo de importação corrigidos na 2.3.9.

= 2.3.7 =
* Coloca o e-mail obrigatório antes das cinco etapas do Wizard em instalações novas.
* O Trial Pro de 30 dias passa a ser registrado na Central após a confirmação do e-mail, sem chave e sem limite de produtos.
* Mantém as cinco etapas originais do Wizard: Projeto e nicho, Mercado Livre, IA, Licença e Pronto.
* Remove a coleta duplicada de e-mail da etapa Licença; nessa etapa o Trial já aparece ativo e a chave anual permanece opcional.
* Substitui o bloco genérico “ML” do cabeçalho pelo ícone oficial fornecido para o Afiliado ML Pro.
* Melhora o layout responsivo do primeiro passo e preserva os dados existentes em atualizações.

= 2.3.6 =
* Trial de 30 dias passa a aceitar controle administrativo remoto pela Central 1.3.1.
* Renovação excepcional +30 dias, reinício de Trial e simulação de vencimento passam a refletir no plugin.
* Sincronização automática do estado do Trial ao navegar nas telas do Afiliado ML Pro.
* Preserva e-mail e telemetria ao ativar/desativar licença.

= 2.3.19 =
* Corrige a importação por URL exata de produtos de catálogo: o ID /p/MLB... não é mais confundido com ITEM_ID da oferta.
* Preserva wid/item_id quando presente, canonicaliza URLs :8443/negative_traffic e remove parâmetros de rastreamento sem perder a identidade do produto.
* O fluxo editorial automático aceita produto já confirmado pela API (IDs + checked_at), evitando falso bloqueio de 'URL individual inválida'.
* Mantém inalterados ranking, importação oficial, dados do Mercado Livre e fluxo de oportunidades.

= 2.3.18 =
* Oportunidades de Conteúdo: geração automática restaurada sobre a base estável 2.3.16.
* Artigo e capa são gerados em duas requisições independentes: primeiro salva o rascunho, depois gera a imagem destacada.
* Corrige vazamento de links/citações externas da pesquisa web no HTML público.
* Fluxo manual continua sem geração automática de imagem.
* Importação/cadastro de produtos Mercado Livre não foi alterada.

= 2.3.16 =
* Layout definitivo do card: galeria/publicidade e resumo no topo; ficha técnica, resumo comercial e CTA sempre em largura total. Remove o marcador PHP residual do front-end e elimina o espaço estrutural criado pelas colunas.

= 2.3.22 =
* Novo produto: o wizard passa a mostrar, antes do link de afiliado, um resumo simples do que realmente foi recebido do Mercado Livre (título, fotos, identificação, avaliações e nota).
* Importações incompletas ou com título genérico “Mercado Livre” são identificadas no próprio wizard e recomendam escolher outro produto, evitando salvar um cadastro ruim.
* Importações parciais continuam possíveis quando o produto principal foi identificado, deixando claro quais dados não foram disponibilizados pela API.
* Categoria editorial e link de afiliado ficam explícitos antes de salvar.
* Auditoria e Visão geral recebem linguagem mais simples: CTA vira botão/local do clique e CTR vira taxa de clique, mantendo as mesmas métricas e coleta existentes.
* Mantém intactos importação ML, ITEM_ID/catálogo, fluxo editorial, IA, links, auditoria e conteúdo já existente.

= 2.3.23 =
* Auditoria escalável com filtros Conteúdo/Loja, gráfico de evolução, paginação real e gráficos por item.
* Histórico de alterações com paginação, níveis e limpeza segura por idade.
* Integração explícita dos cliques do ML Shop.
