> For the complete documentation index, see [llms.txt](https://aiblue.gitbook.io/aiblue/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aiblue.gitbook.io/aiblue/documentation/basico/editor.md).

# WordPress

O WordPress, por sua natureza de código aberto, não possui um painel de injeção de código nativo como os construtores "no-code". Em vez de editar diretamente os arquivos do tema, a abordagem mais segura e recomendada para usuários no-code é a utilização de plugins dedicados que fornecem uma interface de usuário para gerenciar códigos de maneira centralizada e segura.

**Método Recomendado: Uso de Plugin (Ex. WPCode)**

Este é o método mais seguro e flexível para adicionar o script do Agente, pois elimina o risco de quebrar o site ou perder o código em futuras atualizações de tema.22

1. Instalar e Ativar o Plugin: No painel de administração do WordPress, navegue até Plugins (Plugins) → Add New (Adicionar Novo). Busque por "WPCode" ou "Insert Headers and Footers" e, após encontrar, instale e ative o plugin.22
2. Acessar a Seção Headers & Footers: Após a ativação, um novo item de menu aparecerá, geralmente chamado Code Snippets. Navegue até lá e selecione Headers & Footers.22
3. Colar o Snippet no Campo "Footer": Cole o código do Aiblue no campo Footer. Este é o local de carregamento ideal para a maioria dos scripts de funcionalidade, pois eles são carregados após a renderização do conteúdo principal, otimizando o desempenho do site.22
4. Salvar e Publicar: Clique em Save Changes (Salvar Alterações) para aplicar o código em todo o site.<br>

**Método Alternativo: Adição Manual (Avançado)**

Este método é desaconselhado para iniciantes devido ao risco de corromper o site e de as alterações serem sobrescritas em atualizações futuras do tema.22 Envolve a edição manual dos arquivos do tema, como

header.php ou footer.php, o que requer conhecimentos de PHP e FTP/gerenciador de arquivos.<br>

**Análise e Recomendações:**

O ecossistema de plugins do WordPress preenche a lacuna de funcionalidades nativas que outras plataformas no-code possuem. A "melhor prática" no WordPress para a inclusão de código não é a edição direta de arquivos, mas sim a instalação de uma ferramenta externa que centralize essa funcionalidade de maneira segura e robusta. A causa de um usuário falhar seria tentar o método manual sem o conhecimento adequado ou escolher um plugin com uma função diferente.

A documentação disponível sobre plugins de código para WordPress revela a importância de escolher a ferramenta certa. Plugins como Code Embed 24 focam na exibição de código via

shortcodes em posts, enquanto o EmbedPress 25 é focado em incorporar conteúdo de URLs. Para a tarefa de injeção global de um script de Agente, a escolha correta é um plugin focado especificamente em "Headers & Footers" como o WPCode, o que demonstra uma compreensão profunda do ecossistema e evita a frustração de tentar a solução errada.

### Tabelas Essenciais para o Relatório

#### Tabela 1: Resumo Comparativo dos Métodos de Integração<br>

A tabela a seguir consolida as informações mais importantes, permitindo uma referência rápida e uma comparação visual entre as plataformas.

| Plataforma  | Método Principal de Inserção | Instalação Global       | Instalação por Página    | Local de Colocação Sugerido | Observações                                            |
| ----------- | ---------------------------- | ----------------------- | ------------------------ | --------------------------- | ------------------------------------------------------ |
| Ghost       | Code Injection               | Sim (Site Header)       | Sim (Post/Page Settings) | \<head>                     | Não confundir com Code Blocks.                         |
| Framer      | Embed Component              | Não (Por Elemento)      | Sim (Por Elemento)       | N/A                         | Funciona como um contêiner, requer publicação.         |
| Squarespace | Code Injection               | Sim (Header)            | Sim (Code Block)         | \<head>                     | Code Blocks requerem tags \<script>.                   |
| Webflow     | Custom Code                  | Sim (Project Settings)  | Sim (Page Settings)      | \</body>                    | Arquitetura em camadas. O Footer otimiza o desempenho. |
| Wix         | Custom Code                  | Sim (Custom Code Panel) | Sim (Custom Code Panel)  | Body - end                  | Requer plano premium e domínio.                        |
| WordPress   | Plugin (WPCode)              | Sim (Headers & Footers) | Sim (Snippets)           | \<footer>                   | A abordagem de plugin é a mais segura e recomendada.   |

#### Tabela 2: Checklist de Solução de Problemas (Troubleshooting)

<br>

Esta tabela aborda os problemas mais comuns que podem surgir durante a integração e suas soluções.

| Problema                                                    | Causa Provável                                                 | Solução                                                                                                   | Plataforma(s) Relevantes |
| ----------------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------ |
| O Agente não aparece.                                       | O site não foi publicado ou salvo.                             | Publique o site para que as alterações se tornem visíveis ao vivo.                                        | Todas as plataformas     |
| O site carrega lentamente.                                  | O script foi colocado na tag \<head>.                          | Mova o script para a seção de Footer ou Before \</body> tag para que o conteúdo carregue primeiro.        | Webflow, WordPress       |
| O código do script aparece como texto na página.            | O script não está entre as tags \<script>.                     | Envolva o snippet com as tags \<script> e \</script> no Bloco de Código.                                  | Squarespace              |
| O código não funciona após uma atualização do tema.         | O código foi adicionado manualmente aos arquivos do tema.      | Use um plugin ou o método de injeção de código nativo para gerenciar o script, evitando a perda de dados. | WordPress                |
| A funcionalidade de código customizado não está disponível. | O plano de assinatura ou o domínio não atendem aos requisitos. | Verifique se o seu plano Wix é premium e se o domínio está conectado.                                     | Wix                      |
| O Agente não aparece, mesmo com o código correto.           | O script de terceiros não está funcionando.                    | Verifique o status do serviço Aiblue. O problema pode não estar na plataforma.                            | Todas as plataformas     |

<br>
