=== Brazilian Checkout Toolkit for WooCommerce ===
Contributors: riaanknoetze
Tags: woocommerce, checkout, brazil, cpf, cpnj
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Checkout pronto para o Brasil no WooCommerce: campos CPF/CNPJ, validação, máscaras e compatibilidade total com o Bloco de Checkout.

== Descrição ==

Lojas brasileiras precisam de alguns campos extras no checkout para manter conformidade, evitar problemas de entrega e reduzir erros em gateways de pagamento.

O **Brazilian Checkout Toolkit for WooCommerce** adiciona campos brasileiros no checkout (CPF/CNPJ, tipo de pessoa, bairro, número do endereço, etc.), melhora a experiência do cliente com máscaras de preenchimento e funciona com:

* **Checkout clássico do WooCommerce (shortcode)**
* **Bloco de Checkout do WooCommerce** (Cart & Checkout Blocks)

Também espelha os valores nos metadados legados `_billing_*`, usados por muitos temas, integrações e gateways.

= Missão =
Tornar o checkout do WooCommerce realmente adequado ao Brasil — com os campos certos, validação correta e uma UX fluida.

= Por que este plugin =
Ao contrário de soluções antigas que funcionam apenas no checkout clássico, este plugin foi pensado para lojas modernas:

* **Compatível com o Bloco de Checkout** (API de Campos Adicionais do WooCommerce 9.0+)
* **Compatível com versões anteriores** (checkout clássico e integrações existentes)
* **Leve e controlado por configurações** (ative apenas o que sua loja precisa)

= Principais recursos =

* **Tipo de pessoa** (Pessoa Física / Pessoa Jurídica)
* Campos **CPF / CNPJ** com validação opcional (configurações)
* Campos opcionais (configurações): **RG**, **Inscrição Estadual (IE)**, **Data de Nascimento**, **Gênero**
* **Número** e **Bairro** no endereço (Bairro pode ser opcional/obrigatório)
* **Opções de celular** (campo opcional, obrigatório, ou substituir o telefone do WooCommerce)
* **Máscaras / formatação** para CPF, CNPJ, telefone e mais (configurações)
* **Sugestão de e-mail** (Mailcheck) para reduzir falhas no checkout
* **Formato de endereço brasileiro** em pedidos e em “Minha conta”
* **Melhorias na API REST**: expõe os campos extras nas respostas REST do WooCommerce
* **Compatível com HPOS** (High-Performance Order Storage do WooCommerce)

= Onde ficam as configurações =
WooCommerce → Configurações → Entrega → **Campos Brasileiros no Checkout**

= Compatibilidade e requisitos =

* Requer **WooCommerce**
* WordPress 6.0+ (testado até 7.0)
* PHP 7.4+
* WooCommerce **9.0+** recomendado para suporte ao Bloco de Checkout (o plugin detecta a API automaticamente)

= Integrações =

Este plugin inclui camadas de compatibilidade / mapeamento de dados para:

* **Flux Checkout for WooCommerce**
* **Bcash** (adiciona número e dados de CPF/CNPJ)
* **Moip / Moip Transparent Checkout** (adiciona número, bairro, CPF e data de nascimento quando disponível)

= Créditos =

Este plugin é baseado no trabalho original de campos brasileiros no checkout por **Claudio Sanches** e colaboradores, e foi significativamente refatorado/modernizado.

Bibliotecas de terceiros incluídas:
* Mailcheck jQuery (https://github.com/Kicksend/mailcheck)
* jQuery Mask Plugin (https://github.com/igorescobar/jQuery-Mask-Plugin)

== Instalação ==

1. Instale e ative o **WooCommerce**.
2. Envie este plugin para `/wp-content/plugins/` ou instale pela tela de Plugins.
3. Ative o **Brazilian Checkout Toolkit for WooCommerce**.
4. Acesse WooCommerce → Configurações → Entrega → **Campos Brasileiros no Checkout** e configure os campos.

== Perguntas frequentes ==

= Funciona com o Bloco de Checkout do WooCommerce? =

Sim. Se a sua versão do WooCommerce disponibiliza a API de **Campos Adicionais do Checkout** (WooCommerce 9.0+), o plugin registra automaticamente os campos brasileiros para o Bloco de Checkout.

= Ainda funciona com o checkout clássico? =

Sim. O plugin mantém a injeção e validações do checkout clássico e também evita campos duplicados quando o Bloco de Checkout está em uso.

= Posso deixar a validação de CPF/CNPJ opcional? =

Sim. A validação pode ser ativada/desativada nas configurações do plugin.

= Posso mostrar somente Pessoas Físicas ou somente Pessoas Jurídicas? =

Sim. Você pode configurar o modo de “Tipo de pessoa” nas configurações.

= Onde fica a página de configurações? =

WooCommerce → Configurações → Entrega → **Campos Brasileiros no Checkout**.

== Capturas de tela ==

1. Tela de configurações (WooCommerce → Configurações → Entrega → Campos Brasileiros no Checkout)
2. Bloco de Checkout com campos brasileiros (CPF/CNPJ, tipo de pessoa, número, bairro)
3. Checkout clássico com campos brasileiros e máscaras
4. Tela do pedido no admin mostrando os dados brasileiros salvos
5. Minha conta → Endereços com o formato de endereço brasileiro

== Changelog ==

= 1.2.0 =
* Atualização - Testado até o WordPress 7.0.
* Atualização - Compatibilidade declarada até o WooCommerce 10.9.
* Desenvolvimento - Adicionada suíte de testes local (PHPUnit unitário + integração, Playwright e2e) e configuração de padrões de código PHPCS (WordPress/WooCommerce).

= 1.1.0 =
* Novo - Compatibilidade com o WooCommerce

= 1.0.0 =
* Lançamento inicial.
