Documentação do Plugin WordPress
Aprenda a instalar, configurar e personalizar seu widget de conversão de moedas
Índice
1 Instalação
Método 1: Instalar pelo WordPress (Recomendado)
- Acesse o painel administrativo do WordPress
- Navegue até Plugins > Adicionar Novo
- Pesquise por "Currency.Wiki Converter"
- Clique em "Instalar agora" e depois em "Ativar"
Método 2: Instalação Manual
- Baixe o plugin do WordPress.org
- Vá em Plugins > Adicionar Novo > Enviar Plugin
- Selecione o arquivo ZIP baixado e clique em "Instalar agora"
- Ative o plugin após a instalação
2 Usando o Bloco Gutenberg
A maneira mais fácil de adicionar o conversor de moedas às suas páginas:
- Edite qualquer página ou post usando o editor Gutenberg
- Clique no botão + para adicionar um novo bloco
- Pesquise por "Conversor de Moedas" ou navegue até a categoria Widgets
- Configure o widget usando o painel lateral à direita
Dica: Você pode visualizar uma prévia ao vivo do seu widget enquanto altera as configurações no editor de blocos.
3 Uso de Shortcode
Você também pode adicionar o widget usando shortcodes em posts, páginas ou templates do tema:
Uso Básico
[currencywiki_converter]
Atributos Disponíveis
| Atributo | Padrão | Descrição |
|---|---|---|
| style | compact | Estilo do widget (compacto, em linha, alto, mini-gráfico, etc.) |
| theme | auto | Tema de cores (auto, claro, escuro) |
| from | USD | Moeda de origem padrão (código ISO de 3 letras) |
| to | EUR | Moeda de destino padrão (código ISO de 3 letras) |
| amount | 1 | Valor padrão para conversão |
| accent | #3b82f6 | Cor de destaque (código hex como #3b82f6) |
| embed | script | Método de incorporação (script ou iframe) |
| width | auto | Largura personalizada em pixels |
| height | auto | Altura personalizada em pixels |
Exemplos
Widget com tema escuro:
[currencywiki_converter theme="dark"]
Moedas e valor personalizados:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Estilo mini-gráfico:
[currencywiki_converter style="mini-chart"]
Usando incorporação via iframe (para compatibilidade com temas):
[currencywiki_converter embed="iframe"]
4 Estilos do Widget
Escolha entre vários estilos de widget para combinar com o design do seu site:
mini
Conversor minimalista, perfeito para espaços pequenos (250x140px)
square
Conversor quadrado com proporção 1:1 (250x250px)
compact
Conversor pequeno e eficiente em espaço (280x200px)
inline
Layout horizontal, ótimo para cabeçalhos (450x120px)
tall
Layout vertical com rótulos clássicos (220x360px)
mini-chart
Conversor compacto com gráfico histórico (250x260px)
multi-expandable
Converta para múltiplas moedas, usuários podem adicionar/remover (300x400px)
multi-fixed
Lista fixa de múltiplas conversões de moedas (280x360px)
rates-compact
Lista simples de taxas de câmbio (260x260px)
rates-viewer
Visualizador completo de taxas com gráfico (350x420px)
rates-viewer-compact
Visualizador compacto de taxas com gráfico (300x340px)
Dica: Use o Construtor de Widgets no seu painel WordPress para visualizar todos os estilos antes de adicioná-los ao seu site.
5 Opções de Configuração
A página de configurações do plugin no seu painel WordPress permite configurar opções padrão:
Opções de Tema
- auto - Ajusta automaticamente ao esquema de cores do seu site
- light - Sempre usar fundo claro
- dark - Sempre usar fundo escuro
Método de Incorporação
- script - Padrão. O widget carrega embutido com funcionalidade completa. Os menus de moedas aparecem sobre o conteúdo ao redor.
- iframe - Opção alternativa. O widget carrega em um iframe isolado. Use se houver conflitos de estilo com seu tema.
Nota: Se os menus de moedas aparecerem atrás de outros elementos ou forem cortados, tente mudar para o modo de incorporação via iframe.
6 Solução de Problemas
Widget não aparece?
Certifique-se de que o plugin está ativado. Verifique se há plugins de cache que precisam ser limpos. Tente usar o método de incorporação via iframe se o script não funcionar.
Widget com aparência quebrada ou conflito de estilos?
Alguns temas do WordPress podem conflitar com o script do widget. Mude para o modo de incorporação via iframe adicionando embed="iframe" ao seu shortcode.
Menu de moedas oculto ou cortado?
Isso pode acontecer quando elementos do container têm overflow:hidden. Tente usar o modo iframe ou ajuste o CSS do seu tema para permitir overflow no container do widget.
Widget mostrando taxas antigas?
As taxas de câmbio são atualizadas automaticamente. Se você usa um plugin de cache, exclua os scripts do widget do cache ou limpe o cache após alterações.
Precisa de Ajuda?
Não encontrou o que procura? Nossa equipe de suporte está pronta para ajudar.
