WP Manifestindependent plugin directory
manifest / utilities / monquei

Calculadora de Juros Compostos

by MonqueiTech · github.com/sauloazola/monquei

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/sauloazola/monquei/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
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).