# Simulador de Parcelas para Loja Virtual

**Exibe condições de parcelamento do Mercado Pago em páginas de produto, blocos, templates e modais do WooCommerce.**

## Recursos principais
- Obtém automaticamente as condições de parcelamento do Mercado Pago.
- Configuração fácil no painel do WordPress.
- Permite escolher a posição da tabela na página do produto.
- Oferece resumo expansível, tabela completa e gatilho com modal.
- Permite definir um modo global ou sobrescrever o formato em cada shortcode.
- Aceita um produto específico para uso em páginas, Elementor e Gutenberg.

## Compatibilidade

- WordPress 5.0 ou superior.
- PHP 7.2 ou superior.
- WooCommerce ativo.
- Testado até o WordPress 7.1.

O plugin inclui uma alternativa interna para APIs de identificação adicionadas depois do WordPress 5.0, mantendo os controles de resumo e modal únicos mesmo nas versões antigas suportadas.

## Serviços externos

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

**Dados enviados:**
- O valor do produto (`amount`)
- Um método de pagamento fixo (ex.: `visa`)
- O Access Token configurado pelo administrador da loja

**Finalidade:**
- Exibir opções de parcelamento em tempo real nas páginas de produto da loja.

**Serviço utilizado:**
- API de Parcelamento do Mercado Pago  
- [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)

## Instalação
1. Baixe o plugin no WordPress.org ou no GitHub.
2. No painel do WordPress, vá para **Plugins > Adicionar novo** e faça o upload do arquivo `.zip`.
3. Ative o plugin e vá para **Configurações > Simulador de Parcelas**.

## Configuração
1. Insira o **Access Token do Mercado Pago**.
2. Escolha a **posição da tabela na página do produto**.
3. Use **Testar conexão** para conferir as credenciais.
4. Escolha um dos três modos de exibição e acompanhe a prévia.
5. Salve as configurações.

## Shortcodes

Usa o produto atual e o modo padrão configurado no painel:

```text
[simuparc_parcelamento]
```

Exibe um produto específico em qualquer página ou modal:

```text
[simuparc_parcelamento produto_id="123"]
```

Escolha o formato em cada uso com `exibicao="resumo"`, `exibicao="tabela"` ou `exibicao="modal"`:

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

No Gutenberg, use o bloco **Shortcode**. No Elementor, use o widget **Shortcode**.

## Capturas de tela

As quatro imagens publicadas no diretório WordPress.org mostram o painel, o resumo expansível, a tabela completa e o modal aberto em uma página real de produto.

### Painel e prévia dos modos

![Painel de configuração com os três modos](https://ps.w.org/simulador-parcelas/assets/screenshot-1.png)

### Resumo expansível

![Resumo expansível aberto na página de produto](https://ps.w.org/simulador-parcelas/assets/screenshot-2.png)

### Tabela completa

![Tabela completa responsiva na página de produto](https://ps.w.org/simulador-parcelas/assets/screenshot-3.png)

### Modal de parcelamento

![Modal de parcelamento aberto](https://ps.w.org/simulador-parcelas/assets/screenshot-4.png)

## Alterações da versão 1.2.0

- Três modos de exibição que podem coexistir e ser escolhidos globalmente ou por shortcode.
- Painel reorganizado com prévias distintas e controles visuais alinhados.
- Shortcode pronto para Elementor, Gutenberg, templates e modais.
- Tabela responsiva em colunas estreitas e espaçamento protegido contra estilos de temas.
- Resumo expansível controlado pelo plugin e modal acessível.
- Token do Mercado Pago fora da URL e respostas armazenadas em cache.

## Suporte e contribuição
Se precisar de ajuda, visite https://renatofroes.com.br.