外掛說明
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
visaoumaster. - 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
Support
Para suporte e contribuições, acesse: https://renatofroes.com.br/contatos
螢幕擷圖
適用於區塊編輯器
這個外掛提供 1 個可供區塊編輯器使用的區塊。
- Simulador de Parcelas
安裝方式
- No painel do WordPress, acesse Plugins > Adicionar novo.
- Procure por Simulador de Parcelas para Loja Virtual, instale e ative o plugin.
- Acesse Configurações > Simulador de Parcelas.
- Reutilize a conexão oficial do Mercado Pago ou informe um Access Token independente e clique em Testar conexão.
- Escolha o modo de exibição, a posição, as regras e a aparência desejados.
- Salve as alterações.
常見問題集
-
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_idquando 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
tabeladentro de um modal existente ouexibicao="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.
-
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.
使用者評論
參與者及開發者
變更記錄
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.