Documentação - TraduzSite

Visão Geral

O TraduzSite permite internacionalizar seu site sem mexer no backend, publicando traduções diretamente no navegador de forma rápida e segura.

Instalação sem código: apenas inserir o widget e escolher idiomas.
Traduções aplicadas automaticamente a textos e elementos comuns da interface.
Integração com IA para acelerar a geração de traduções.
Suporte a múltiplos idiomas com adaptação instantânea da interface.

Instalação do Widget

Adicione os scripts abaixo antes de fechar a tag body do site do cliente.

Código de Integração:

<!-- Código de integração do TraduzSite -->
<script>
    window.TraduzSiteWidgetConfig = {
        apiUrl: "https://irdigital.us/system/traduzsites/api/traduzir.php",
        idiomas: ["pt", "en", "es", "fr", "it"],
        posicao: "bottom-right",
        debug: false
    };
</script>
<script src="https://irdigital.us/system/traduzsites/widget.js" defer></script>
<script>
    (function tentaInit() {
        if (window.initTraduzSiteWidget && !window.__TraduzSiteIniciado) {
            try {
                window.__TraduzSiteIniciado = true;
                window.initTraduzSiteWidget(window.TraduzSiteWidgetConfig);
            } catch (e) { try { console.warn('[TraduzSite] erro init:', e); } catch(_){} }
        } else if (!window.__TraduzSiteDesistencias || window.__TraduzSiteDesistencias < 25) {
            window.__TraduzSiteDesistencias = (window.__TraduzSiteDesistencias || 0) + 1;
            setTimeout(tentaInit, 500);
        }
    })();
</script>

Nota: O código acima usa a URL atual do servidor. O widget detecta automaticamente a URL correta da API.

O widget detecta o idioma atual e aplica traduções do dicionário automaticamente.

Fluxo com IA

No Sistema, use “Extrair Palavras do Site” para gerar o dicionário inicial.
Use “Gerar Prompt para IA” e cole a resposta em “Processar Traduções”.
Revise e ajuste traduções manualmente no dicionário se necessário.

Ferramentas de IA recomendadas: ChatGPT, Claude e Gemini.

Cobrança Mensal

O widget consulta o status de cobrança por domínio.
Se estiver vencido (“due”), exibe o botão para pagamento com o link configurado no Admin.
No Admin, informe o domínio do cliente, salve o link global e marque pagamentos.

Preço padrão: R$ 29,90/mês com ciclo de 30 dias.

Exemplos de Configuração

Configuração Básica

window.TraduzSiteWidgetConfig = {
  apiUrl: "https://irdigital.us/system/traduzsites/api/traduzir.php",
  idiomas: ["pt", "en"],
  posicao: "bottom-right",
  debug: false
};

Configuração Avançada

window.TraduzSiteWidgetConfig = {
  apiUrl: "https://irdigital.us/system/traduzsites/api/traduzir.php",
  idiomas: ["pt", "en", "es", "fr", "it"],
  posicao: "top-left",
  debug: false
};

Solução de Problemas

Verifique se o script foi adicionado antes do fechamento da tag </body>
Confira se não há erros de JavaScript no console do navegador
Certifique-se de que a URL da API está correta

Verifique se o dicionário foi criado no sistema
Confira se o idioma de destino está disponível no dicionário
Teste a API diretamente: https://irdigital.us/system/traduzsites/api/traduzir.php?action=carregar_dicionario

O sistema já está configurado para permitir CORS. Se ainda houver problemas:

Verifique se o domínio do cliente está correto
Confira se não há redirecionamentos HTTPS incorretos
Teste em diferentes navegadores

Dicionário

As traduções são armazenadas e gerenciadas pelo sistema, mantendo colunas por idioma para aplicação rápida no widget.

O sistema evita termos técnicos e detecta idioma para evitar coluna errada.
Atualizações manuais são suportadas pelo Sistema e pela API.

Boas Práticas

Mantenha o primeiro idioma como padrão no widget.
Evite traduzir termos técnicos, nomes próprios e siglas.
Revise traduções críticas manualmente no dicionário.

Documentação do TraduzSite