WP Manifestindependent plugin directory
manifest / utilities / monquei

Calculadora de Juros Compostos

Um plugin para WordPress que simula investimentos com juros compostos de forma simples, com visual moderno, UX otimizada, otimizado para o tema Hello Elementor e Elementor. Parte da coleção Calculadora de Juros Compostos, Calculadora de Renda Fixa Simples e Calculadora de Renda Fixa Completo. Agora exibe valores brutos sem IR e aceita apenas valores inteiros no campo "Prazo".

by MonqueiTech · github.com/sauloazola/monquei

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/sauloazola/monquei/archive/refs/heads/main.zip
Readme github.com/sauloazola/monquei ↗

Via Editor Comum do WordPress

  1. Crie ou edite uma página/post no painel de administração.
  2. No editor de texto (modo clássico ou bloco "Shortcode" no Gutenberg), insira [calculadora_juros_compostos_simples].
  3. Publique ou atualize a página/post.

Via Elementor

  1. Edite a página com o Elementor.
  2. Arraste o widget "Shortcode" para a área desejada.
  3. No campo do widget, insira [calculadora_juros_compostos_simples].
  4. Salve e publique a página.

Via Gutenberg

  1. Edite a página/post com o editor de blocos (Gutenberg).
  2. Adicione um bloco "Shortcode" (ou use o bloco "Código" se necessário).
  3. Insira [calculadora_juros_compostos_simples] no campo do bloco.
  4. Publique ou atualize a página/post.

Funcionalidades da Calculadora

  • Campos de Entrada:

    • "Valor da aplicação (R$)": Com máscara "R$ X.XXX,XX", sem "0" à esquerda.
    • "Investimento mensal (R$)": Com máscara "R$ X.XXX,XX", sem "0" à esquerda.
    • "Prazo": Numérico puro (sem vírgula), sem "0" à esquerda, com opção de meses (1 a 1200) ou anos (1 a 100), com toggle "Meses/Anos" funcionando corretamente.
    • "Taxa de Juros": Numérico com vírgula para decimais, sem "0" à esquerda, com opção de anual (até 100%) ou mensal (até 30%, ex.: 10,5), com toggle "Anual/Mensal" funcionando corretamente.

  • Resultados Automáticos:

    • Valor total bruto em verde (#84B686).
    • Total investido, Rendimento bruto, Na poupança em linhas separadas com linhas sutis.
    • Frase "Em X meses você teria:" com "X" em verde (#84B686) e o restante em azul (#010658), "Valor total bruto" em preto.
    • Link para investimento via WhatsApp.

Estrutura do Plugin

O plugin contém os seguintes arquivos:

  • calculadora-juros-compostos-simples.php: Arquivo principal, inicializa o plugin e adiciona a página de boas-vindas.
  • includes/class-calculadora-juros-compostos-simples.php: Classe principal, gerencia shortcodes, assets e hooks WordPress.
  • assets/css/calculadora-juros-compostos.css: Estilos CSS para o design moderno, simples e responsivo, com toggles estilizados (fundo verde claro #e0f7e9, texto azul #010658, borda #84B686).
  • assets/js/calculadora-juros-compostos.js: Lógica JavaScript para cálculos automáticos, máscaras, toggles de unidade ("Meses/Anos" e "Anual/Mensal"), suporte a vírgula na taxa de juros e interatividade.

Personalização

  • Cores: As cores padrão (#84B686 verde, #010658 azul escuro) podem ser ajustadas via CSS customizado no tema ou em um plugin de personalização.
  • Layout: O plugin é otimizado para Hello Elementor/Elementor, mas pode ser ajustado com CSS para outros temas, evitando conflitos com cabeçalho à esquerda e rodapé à direita.

Contribuições

  • Reportar Bugs: Abra uma issue no repositório GitHub (se disponível) ou entre em contato via monqueitech.com.br.
  • Pull Requests: Desenvolvedores podem contribuir enviando melhorias ou correções no código, seguindo as diretrizes de codificação WordPress.
  • Suporte: Para suporte técnico, entre em contato pelo e-mail suporte@monqueitech.com.br ou pelo WhatsApp (+55 12 98115-3079).

Licença

Este plugin é distribuído sob a licença GPL-2.0+. Veja o arquivo LICENSE (se incluído) para mais detalhes.

Changelog

  • 5.8.0:
    • Correção dos toggles "Meses/Anos" e "Anual/Mensal" para funcionar corretamente, permitindo alternar unidades e atualizar valores automaticamente (ex.: 5 anos = 60 meses; 10% anual ≈ 0,8% mensal).
    • Ajuste no design dos toggles para corresponder à imagem fornecida (fundo verde claro #e0f7e9, texto azul #010658, borda #84B686, bordas arredondadas).
    • Manutenção do suporte a vírgulas no campo "Taxa de Juros" (ex.: 10,5) e correção para aceitar vírgulas no campo "Prazo" (arredondando para inteiro).
    • Manutenção do design idêntico às especificações anteriores (#84B686 verde, #010658 azul escuro), sem contorno no box esquerdo, fundo #F2F8F3 no box direito e contorno cinza claro #e9ecef no box principal.
    • Compatibilidade com Hello Elementor e Elementor, shortcode [calculadora_juros_compostos_simples] e página de boas-vindas administrativa.
    • Cálculo usando a taxa de juros e prazo convertidos (mensal ou anual), com IR (22,5% para até 6 meses, 20% para mais) e comparação com a poupança (0,5% ao mês estimado).
  • 5.8.1:
    • Correção do campo "Prazo" para aceitar apenas valores inteiros (sem vírgula), usando máscara numérica pura e arredondando a conversão entre "Meses" e "Anos".
  • 5.8.2:
    • Remoção do cálculo do IR, exibindo apenas "Valor total bruto" e "Rendimento bruto" nos resultados.

Notas Técnicas

  • Compatibilidade: Testado com WordPress 5.0+, PHP 7.4+, Hello Elementor e Elementor.
  • Desempenho: Otimizado para carregar assets (CSS/JS) apenas nas páginas com o shortcode, minimizando impacto no desempenho.
  • Segurança: Usa boas práticas WordPress (verificação ABSPATH, enfileiramento seguro, sanitização de dados).