AutoCEP

Changelog

2.46

• Aba “Integrações de Frete” não pede mais token manual: o teste de conexão do Melhor Envio agora lê automaticamente o token que o plugin oficial dele já tem salvo (wpmelhorenvio_token/wpmelhorenvio_token_sandbox, respeitando o ambiente ativo); o teste da Frenet lê o token e o CEP de origem diretamente da instância do método oficial configurada numa Zona de Entrega. Nenhum dado é duplicado ou digitado de novo no AutoCEP.
• Corrigido falso “Token Inválido” no teste do Melhor Envio: o teste sempre chamava a API de produção (www.melhorenvio.com.br), mesmo quando o token detectado era de ambiente Sandbox — um token de sandbox nunca é aceito no host de produção (e vice-versa), pois são hosts diferentes (api.melhorenvio.com para produção, sandbox.melhorenvio.com.br para sandbox), confirmado no código-fonte oficial do plugin. Agora o host é escolhido conforme o ambiente detectado.
• Removida a imagem de logo da página de Créditos (reduz o tamanho do pacote).
• Seção de créditos do README expandida: papéis, perfis (WordPress.org/LinkedIn) e parceria com a Ritmo Digital.
• Removida a página “Créditos” do painel administrativo (e o respectivo link na listagem de Plugins) — as fotos afonso.png/wanderson.png, que só eram usadas ali, também foram removidas.
• Removidos todos os comentários do código PHP (incluindo PHPDoc e phpcs:ignore), a pedido explícito, para a preparação final de lançamento. Comentários de JavaScript/CSS embutidos em strings PHP (painel administrativo) foram mantidos intocados, por segurança — essa é a mesma região onde um bug de aspas de SVG já havia quebrado o site numa versão anterior.
• Corrigido erro fatal introduzido pela remoção de comentários: em class-autocep-shipping.php, dois comentários de fim de linha terminavam na mesma linha de uma tag ?> de fechamento do PHP (ex.: echo $x; // comentário ?></div>). Como o PHP trata ?> como um encerrador implícito de comentário de linha, e a remoção só considerava quebra de linha como fim de comentário, o ?></div> acabou apagado junto — quebrando a sintaxe e derrubando o site com “Parse error” ao instalar. Corrigido restaurando as tags removidas nos dois pontos afetados; conferida a ausência do mesmo padrão em todo o restante do código.
• Corrigido erro fatal na instalação — cabeçalho do plugin ausente: o bloco de comentário Plugin Name: AutoCEP no topo do autocep.php também tinha sido removido junto com os demais comentários, mas esse bloco é metadado obrigatório que o WordPress lê diretamente do arquivo (sem executar o PHP) para reconhecer que é um plugin válido — sem ele, o instalador reportava “Nenhum plugin válido foi encontrado”. Restaurado (enxuto, só com os campos que o WordPress efetivamente lê).
• Todos os links do README convertidos para hyperlinks reais ([texto](url)) — antes eram URLs soltas, sem link clicável, em vários pontos do documento.
• Adicionadas as 8 capturas de tela reais do painel (screenshot-1.png a screenshot-8.png em wp-org-assets/), com a seção Screenshots do README atualizada para descrever cada uma.

2.45

• Corrigido erro fatal crítico introduzido na v2.12.0: os ícones de mapa+pin (cabeçalho do painel) e de headset (aba Suporte Técnico) usavam URIs de SVG com aspas simples não escapadas dentro de uma string PHP também delimitada por aspas simples (wp_add_inline_style('common', '...')) — a primeira aspa do SVG fechava a string prematuramente, tornando o restante do arquivo um código PHP inválido e derrubando o site inteiro com “erro crítico” assim que o plugin era instalado. Corrigido substituindo as aspas simples do SVG por %27 (URL-encoded), consistente com o restante do data URI já percent-encoded.
• Preparação de lançamento para o repositório oficial do WordPress: número de versão sincronizado em todo o plugin (header, constante AUTOCEP_VERSION, cache-busting de scripts/estilos).
• Corrigida violação real das diretrizes do repositório: a aba Analytics carregava a biblioteca Chart.js dinamicamente de um CDN externo (cdn.jsdelivr.net) no navegador do admin — não permitido pelas diretrizes do WordPress.org. Chart.js 4.4.0 agora é empacotado localmente em assets/js/vendor/ e enfileirado via wp_enqueue_script(), sem nenhuma dependência de servidor de terceiros.
• Revisão de comentários no código: removidos os poucos comentários puramente redundantes encontrados; mantidos todos os comentários phpcs:ignore (exigidos pela conformidade real com o WPCS) e todo o racional de compatibilidade/segurança documentado.
• README reformulado com descrição completa de todos os módulos, FAQ ampliado e link para a documentação oficial.
• Links diretos para a Documentação Oficial e o Vídeo de Demonstração adicionados ao cabeçalho do painel administrativo e à aba Suporte Técnico.

2.12.0

• Nova aba “Integrações de Frete”: testes de conexão em tempo real para as APIs do Melhor Envio (valida o Token de Acesso via endpoint autenticado de perfil) e da Frenet (valida o Token de Integração via cotação de teste), com feedback visual verde/vermelho/âmbar e detalhamento técnico da falha quando aplicável. Não substitui os plugins oficiais dessas transportadoras — é só um diagnóstico.
• Identidade visual do painel administrativo atualizada para uma paleta com mais tons de azul (cabeçalho, badge do menu “+” e destaques), reduzindo o uso de amarelo/branco predominante.
• Ícone do menu lateral substituído por um mapa dobrado com pin de localização em destaque; ícone da aba Suporte Técnico substituído do antigo “SOS” (boia salva-vidas) por um headset de atendimento.
• Segurança reforçada: validação dos anexos do formulário de chamado de suporte agora verifica o conteúdo real do arquivo (wp_check_filetype_and_ext()), não apenas o tipo declarado pelo navegador; corrigida uma falha de XSS armazenado no JSON injetado nos gráficos do Dashboard de Analytics (adicionadas as flags JSON_HEX_TAG/AMP/APOS/QUOT).
• Auditoria completa de segurança e resiliência: revisadas todas as rotas AJAX (nonces e current_user_can), todas as consultas SQL (uso de $wpdb->prepare) e o tratamento de erros de todas as APIs externas (timeouts, HTTP 4xx/5xx, JSON corrompido) — nenhum outro problema encontrado.

2.3.5

• Vídeo demonstrativo adicionado no topo da Descrição do README, no formato que o WordPress.org converte automaticamente em player incorporado.
• Removido o arquivo de vídeo local do pacote (store-assets/), já hospedado no YouTube — reduz bastante o tamanho do .zip do plugin.
• Créditos esclarecidos: versão 2.0 criada pela equipe TESW, com desenvolvimento principal de Wanderson Cesar.

2.3.4

• Corrigido: ao selecionar um frete simulado no checkout, os campos de Cidade e Estado podiam continuar mostrando o endereço antigo mesmo com o CEP já atualizado, quando o autocompletar de Cobrança/Entrega estava desligado nas configurações. Como essa sincronização acontece por uma ação explícita do cliente (clicar em “Selecionar”), agora ela sempre atualiza o endereço completo (rua/bairro/cidade/estado), independente dessa opção.
• A sincronização de endereço ao selecionar um frete agora espera a busca terminar de verdade antes de recalcular o checkout, em vez de um tempo fixo — mais confiável em conexões lentas.
• Adicionados materiais de divulgação do plugin (ícone, banner e capturas de tela do painel) na pasta store-assets/, e seção de Screenshots no README.

2.3.3

• Corrigido: ao selecionar um frete simulado no checkout quando a etapa “Método de Entrega” já estava renderizada com uma opção diferente marcada, o próprio recálculo nativo do WooCommerce reenviava o valor do rádio ainda marcado na tela (o antigo) e sobrescrevia a seleção feita — mostrando “Frete selecionado com sucesso” mas mantendo o método/valor anterior. Agora o rádio nativo correspondente é marcado antes do recálculo, garantindo que a escolha feita na simulação seja a que efetivamente é enviada e aplicada.

2.3.2

• Card de simulação de frete menor e mais compacto (menos padding, fonte e espaçamentos reduzidos), para ocupar menos espaço na página de produto/carrinho/checkout.
• Corrigida (definitivamente) a aparência “torta” do texto dentro do botão “Calcular”: duas causas — o letter-spacing adicionava espaço também depois da última letra, descentralizando visualmente o texto; e a quebra de linha/indentação dentro da tag <button> no HTML podia deixar espaços em branco nas bordas do texto em alguns navegadores. Ambas foram removidas.
• Link “Não sei meu CEP” com visual mais intencional (centralizado, cor da marca, sem parecer um elemento solto/quebrado).

2.3.1

• Mensagem mais precisa quando nenhuma taxa de frete é retornada: se a causa real for o CEP não existir em nenhuma das APIs consultadas, o cliente agora vê “CEP não encontrado” em vez da mensagem genérica “nenhuma opção de frete disponível”, que escondia a causa real.
• Documentadas no README as duas situações mais comuns de “frete não aparece”: produto sem peso cadastrado (rejeitado silenciosamente por transportadoras como Jadlog/Azul Ecommerce) e CEP inexistente.

2.3.0

• Novo diagnóstico: quando a Zona de Entrega tem métodos de frete habilitados que não retornam taxa (sem erro, apenas sem preço — comum com Melhor Envio/Frenet quando uma transportadora específica não atende ao destino ou o produto não tem peso cadastrado), o log agora registra exatamente quais métodos ficaram “silenciosos” e, quando aplicável, aponta o(s) produto(s) sem peso cadastrado como possível causa.

2.2.2

• Estendida a correção de compatibilidade com o Melhor Envio (2.2.1) para os simuladores de Carrinho e Checkout: o mesmo problema de fundo (o Melhor Envio não conseguir ler os produtos corretamente em determinados cenários) também podia acontecer ali, mas de forma silenciosa — retornando “Nenhuma opção de frete disponível” em vez de um erro. Agora cada item do pacote também recebe os dados formatados como rede de segurança, sem alterar o comportamento para quem já funcionava normalmente.

2.2.1

• Corrigida a causa raiz real do erro “Uma das transportadoras configuradas não respondeu corretamente” no simulador de frete da página de produto com o plugin oficial do Melhor Envio: o pacote simulado (fora do carrinho real) não incluía a flag product_page_calculation nem os dados do produto no formato interno que o Melhor Envio espera nesse cenário. Isso fazia o cálculo do Melhor Envio tentar ler do carrinho real — que funcionava “por acidente” quando havia algo no carrinho da sessão (ex.: durante testes logado), mas falhava para qualquer visitante com o carrinho vazio. Agora o pacote é montado no formato que o próprio Melhor Envio usa em sua calculadora oficial de página de produto.
• O ajuste é aplicado de forma defensiva (só age se o plugin do Melhor Envio estiver de fato instalado) e não afeta os simuladores de carrinho e checkout, que já usavam o carrinho real e não eram afetados por este bug.

2.2.0

• Corrigido bug crítico: a simulação de frete (produto, carrinho e checkout) falhava com mensagem de erro apenas para visitantes não logados, enquanto funcionava normalmente para administradores/usuários logados — em lojas usando Melhor Envio, Frenet ou outras transportadoras de terceiros. Causa: nossas rotas AJAX passam por admin-ajax.php, que não garante o carrinho/sessão/cliente do WooCommerce (WC()->cart, WC()->session, WC()->customer) totalmente inicializados para um visitante anônimo sem sessão prévia — o que fazia integrações de frete de terceiros lançarem exceção. Agora o plugin chama wc_load_cart() (função oficial do WooCommerce para esse cenário) no início de cada rota AJAX de frete, garantindo esses objetos disponíveis para qualquer visitante, logado ou não.
• Corrigido: ao selecionar um frete simulado no checkout usando um CEP diferente do que já estava preenchido no formulário de endereço, o WooCommerce recalculava o pedido usando o CEP antigo do formulário (não o CEP selecionado), fazendo o valor do frete divergir do que foi escolhido. Agora, ao selecionar, o CEP da simulação é sincronizado com os campos reais de cobrança/entrega antes do recálculo.

2.1.0

• Nova funcionalidade: cada opção de frete simulada no Carrinho e no Checkout agora tem um botão “Selecionar” — clicar nele aplica de verdade aquele método de frete ao pedido (usando o mesmo mecanismo nativo de sessão do WooCommerce que os botões de rádio de frete usam), em vez de a simulação ser apenas informativa. O CEP e o método são sempre revalidados no servidor no momento da seleção.
• No checkout, selecionar um frete simulado atualiza automaticamente a etapa “Método de Entrega” nativa (via evento update_checkout); no carrinho, a página é atualizada para refletir a nova escolha nos totais.
• A caixa da página de produto permanece apenas informativa, já que o item ainda não está no carrinho nesse momento.
• Novas mensagens configuráveis: texto do botão “Selecionar”, “Aplicando frete…” e “Frete selecionado com sucesso!”.

2.0.1

• Atualizada a compatibilidade declarada para WordPress até a versão 7.0.3.
• Corrigido: em temas com estilos globais fortes para campos e botões, o visual do campo de CEP e do botão “Calcular” das caixas de frete era sobrescrito pelo tema (borda, placeholder e cor do botão inconsistentes). O CSS do plugin agora tem prioridade garantida sobre os estilos do tema.
• Corrigido o alinhamento vertical do texto do botão “Calcular”, que podia aparecer descentralizado dependendo do tema.
• Removida a classe genérica button do botão “Calcular”, que estava puxando o estilo padrão do tema/WooCommerce.

2.0.0

Reformulação completa do plugin, unificando todas as evoluções feitas sobre a base da versão 1.5:

Arquitetura
* Reescrita modular orientada a objetos: autocep.php (bootstrap), class-autocep-admin.php (painel), class-autocep-api.php (busca de CEP), class-autocep-shipping.php (frete), class-autocep-logger.php (diagnóstico).
* Painel administrativo próprio, com abas: Geral & Busca de CEP, Frete na Página de Produto, Frete no Carrinho, Frete no Checkout, Mensagens & UX, Aparência, Diagnóstico e Logs.

Busca de CEP
* Cascata de três APIs (ViaCEP, BrasilAPI, ApiCEP) com prioridade configurável e fallback automático.
* Cache via Transients API, com duração configurável e limpeza manual.
* Aviso para CEPs sem rua cadastrada, e mensagem de erro visível para CEP inválido/não encontrado.
* Compatibilidade ampla com checkouts de terceiros via observação automática de mudanças no formulário.
* Autocomplete do navegador opcional nos campos de endereço.

Frete
* Três simuladores independentes: produto, carrinho e checkout — todos consultando as Zonas de Entrega do WooCommerce em tempo real, com suporte a produtos variáveis, cupons aplicados e prazo de entrega.
* Compatibilidade com métodos de frete de terceiros (Melhor Envio, Frenet e outros), com tratamento robusto de falhas e desativação automática da caixa nativa do Melhor Envio para evitar duplicidade visual.
* Compatibilidade retroativa com o shortcode [shipping_calculator_on_product_page] do plugin de calculadora de frete anterior.

Aparência
* Redesenho das caixas de frete: visual compacto e moderno, cores personalizáveis via seletor nativo do WordPress.

Diagnóstico
* Verificação de status em tempo real das APIs de CEP e log de falhas.

1.5

• Versão legada: autocompletar endereço no checkout via API OpenCEP.

Obrigado por usar o AutoCEP.