=== Simulador de Parcelas para Loja Virtual ===
Contributors: renatofroes
Tags: woocommerce, parcelamento, mercado pago, pix, elementor
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.2
Requires Plugins: woocommerce
Stable tag: 1.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Exiba parcelas do Mercado Pago e ofertas no Pix em produtos, páginas, blocos, templates e modais do WooCommerce.

== Description ==

O Simulador de Parcelas consulta as condições disponíveis no Mercado Pago para o preço do produto e apresenta uma estimativa clara na loja WooCommerce.

Escolha uma apresentação padrão para as páginas de produto ou use formatos diferentes em páginas, templates, popups e modais por shortcode, bloco Gutenberg ou widget Elementor.

= Modos de exibição =

* **Resumo expansível:** destaca a parcela preferida e permite abrir ou recolher as demais opções na própria página.
* **Tabela completa:** mantém todas as condições visíveis e se adapta a colunas estreitas.
* **Gatilho com modal:** apresenta uma chamada compacta e abre o simulador em uma janela acessível.

= Recursos adicionais =

* Prévia ao vivo dos três modos de exibição na tela de configurações.
* Resumo opcional da melhor parcela nos cards de produto.
* Posição automática configurável nas páginas de produto.
* Cores, alinhamento e prefixo personalizáveis.
* Cache das respostas da API para reduzir consultas repetidas.
* Access Token do Mercado Pago enviado somente no cabeçalho de autorização do servidor.
* Atualização automática após a escolha de uma variação do produto.
* Regras globais, por categoria e por produto.
* Limite máximo de parcelas, valor mínimo por parcela e preferência por opções sem juros.
* Bloco Gutenberg dinâmico e widget Elementor nativos.
* Diagnóstico integrado e compatibilidade declarada com HPOS e os blocos de Carrinho e Finalização do WooCommerce.
* Reutilização opcional da conexão do plugin oficial do Mercado Pago, com detecção automática do ambiente de teste ou produção.
* Access Token manual como alternativa para configurações independentes e continuidade da operação.
* Oferta inteligente opcional que compara um desconto Pix confirmado com a parcela preferida.
* Sincronização automática com o limite de parcelas ativo no Checkout Pro.

= Shortcodes =

Use `[simuparc_parcelamento]` para exibir o produto atual com o modo padrão da loja.

Use `[simuparc_parcelamento produto_id="123"]` para selecionar um produto específico.

O atributo `exibicao` aceita `resumo`, `tabela` ou `modal`:

`[simuparc_parcelamento produto_id="123" exibicao="resumo"]`

`[simuparc_parcelamento produto_id="123" exibicao="tabela"]`

`[simuparc_parcelamento produto_id="123" exibicao="modal"]`

No Gutenberg, procure pelo bloco **Simulador de Parcelas**. No Elementor, use o widget com o mesmo nome. O shortcode continua disponível para templates, popups e modais.

== External services ==

Este plugin se conecta à API do Mercado Pago para consultar as condições de parcelamento com base no preço do produto.

Dados enviados:

* O valor do produto (`amount`).
* A forma de pagamento de referência configurada, como `visa` ou `master`.
* O Access Token do Mercado Pago do administrador da loja, enviado no cabeçalho de autorização.

Finalidade:

* Consultar e exibir estimativas de parcelamento aplicáveis ao valor do produto.

Serviço utilizado:

* API de Parcelamento do Mercado Pago: https://api.mercadopago.com/v1/payment_methods/installments
* Termos de uso: https://www.mercadopago.com.br/ajuda/termos-e-condicoes_194
* Política de privacidade: https://www.mercadopago.com.br/ajuda/politica-de-privacidade_188

== Installation ==

1. No painel do WordPress, acesse **Plugins > Adicionar novo**.
2. Procure por **Simulador de Parcelas para Loja Virtual**, instale e ative o plugin.
3. Acesse **Configurações > Simulador de Parcelas**.
4. Reutilize a conexão oficial do Mercado Pago ou informe um Access Token independente e clique em **Testar conexão**.
5. Escolha o modo de exibição, a posição, as regras e a aparência desejados.
6. Salve as alterações.

== Frequently Asked Questions ==

= O WooCommerce é obrigatório? =

Sim. O plugin utiliza os dados e preços dos produtos do WooCommerce para montar a estimativa de parcelamento.

= Posso usar com Elementor ou Gutenberg? =

Sim. O plugin inclui um bloco Gutenberg e um widget Elementor nativos. O shortcode também permanece disponível. Informe `produto_id` quando o conteúdo estiver fora de uma página de produto.

= O plugin funciona com produtos variáveis? =

Sim. Depois que uma variação é selecionada, o simulador atualiza as condições usando o preço dessa variação e mantém as regras definidas no produto principal.

= Posso impedir parcelas com valores muito pequenos? =

Sim. Na aba **Regras**, configure o valor mínimo por parcela, o número máximo de parcelas e se o destaque principal deve preferir opções sem juros.

= Posso colocar o simulador dentro de outro modal? =

Sim. Use o modo `tabela` dentro de um modal existente ou `exibicao="modal"` para abrir a janela acessível fornecida pelo plugin.

= O valor exibido é definitivo? =

Não. A estimativa depende da resposta do Mercado Pago. As condições finais podem variar conforme a bandeira, o emissor e o cartão utilizado no pagamento.

= O Access Token fica exposto no navegador? =

Não. As credenciais salvas não são devolvidas para a tela de configurações. A solicitação é feita pelo servidor, e o token é enviado no cabeçalho de autorização da requisição ao Mercado Pago.

= O plugin pode reutilizar a configuração do Mercado Pago usada no checkout? =

Sim. Selecione a conexão oficial do Mercado Pago na aba **Conexão**. O simulador acompanha o ambiente ativo de teste ou produção sem copiar a credencial para suas próprias configurações. O modo manual continua disponível.

= O plugin pode comparar Pix e parcelamento? =

Sim. Ative a **Oferta inteligente** e selecione o desconto Pix oficial do Mercado Pago ou informe um percentual confirmado manualmente. A comparação permanece oculta quando não existe um desconto válido.

== Screenshots ==

1. Tela de configurações com três modos selecionáveis e prévia ao vivo.
2. Resumo expansível aberto em uma página de produto.
3. Tabela completa responsiva com número de parcelas, valor de cada parcela e total.
4. Gatilho compacto com o modal de parcelamento aberto em uma página de produto.

== Changelog ==

= 1.5.0 =

* Novo: card de oferta inteligente comparando preço no Pix, economia transparente e parcela preferida.
* Novo: detecção automática do desconto ativo no gateway Pix oficial do Mercado Pago.
* Novo: percentual Pix confirmado manualmente para configurações de checkout independentes.
* Novo: regras globais, por categoria e por produto para a visibilidade da oferta inteligente.
* Experiência: a comparação com Pix permanece informativa e não compete com os controles de compra do produto.
* Novo: sincronização automática com o limite de parcelas do Checkout Pro quando ele é a experiência de cartão ativa.
* Segurança: nenhum preço ou economia no Pix é exibido sem um desconto ativo e válido.
* Painel: aba dedicada à Oferta inteligente com prévia ao vivo e estado da integração.

= 1.4.0 =

* Novo: reutilização opcional das credenciais configuradas no plugin oficial do Mercado Pago para WooCommerce.
* Novo: sincronização automática com o ambiente de teste ou produção do checkout.
* Novo: seletor da origem da conexão com estado claro e alternativa manual.
* Novo: diagnóstico da integração oficial, do gateway de cartão e da consistência com o checkout.
* Segurança: credenciais manuais ou oficiais salvas não são devolvidas à página de configurações.
* Compatibilidade: instalações existentes com token manual mantêm o comportamento atual após a atualização.

= 1.3.0 =

* Novo: regras inteligentes com valor mínimo, número máximo de parcelas e preferência sem juros.
* Novo: regras por produto e categoria que sobrescrevem as configurações globais.
* Novo: atualização automática após a escolha de uma variação do WooCommerce.
* Novo: bloco Gutenberg dinâmico.
* Novo: widget Elementor nativo com seleção de produto e modo de exibição.
* Novo: escolha da forma de pagamento de referência nas consultas ao Mercado Pago.
* Novo: diagnóstico integrado do ambiente e das configurações.
* Compatibilidade: suporte declarado ao WooCommerce HPOS e aos blocos de Carrinho e Finalização.
* Compatibilidade: registro adaptativo do bloco para versões antigas do editor e API v3 em versões modernas do WordPress.
* Compatibilidade: metadados validados com WordPress 7.1 e WooCommerce 10.7.

= 1.2.0 =

* Novo: resumo expansível, tabela completa e gatilho com modal.
* Novo: atributos de shortcode para Elementor, Gutenberg, templates e modais.
* Novo: configurações reorganizadas com prévias ao vivo, exemplos copiáveis e teste de conexão.
* Segurança: Access Token movido da URL para o cabeçalho de autorização.
* Desempenho: cache compartilhado para shortcodes, páginas de produto e cards.
* Acessibilidade: navegação por teclado e atributos ARIA nos controles de resumo e modal.
* Correção: scripts de temas não interceptam mais o controle do resumo expansível.
* Correção: a tabela responsiva não força mais rolagem horizontal nem corta o conteúdo.
* Correção: controles de seleção alinhados e atualização mais clara da prévia no painel.
* Correção: espaçamento da primeira coluna protegido contra estilos agressivos de temas.

= 1.1.0 =

* Adicionadas informações de parcelamento aos cards de produto.
* Adicionada opção para ativar ou desativar o resumo nos cards.
* Adicionados alinhamento, cor e prefixo configuráveis.
* Adicionado cache para evitar consultas repetidas ao Mercado Pago.

= 1.0.1 =

* Lançamento inicial.

== Upgrade Notice ==

= 1.5.0 =

Adiciona uma comparação entre Pix e parcelamento voltada à conversão, exibida somente quando as condições do checkout foram confirmadas.

= 1.4.0 =

Permite reutilizar a conexão oficial do checkout Mercado Pago sem remover a configuração manual independente.

= 1.3.0 =

Adiciona produtos variáveis, regras por produto e categoria, bloco Gutenberg, widget Elementor e diagnóstico integrado.

= 1.2.0 =

Atualização recomendada com três modos de exibição, shortcodes flexíveis e correções visuais para temas e colunas estreitas.

== Support ==

Para suporte e contribuições, acesse: https://renatofroes.com.br/contatos