Como Usar a Integração WPCode

Tempo de leitura: 4 minutos | Dificuldade: Iniciante

Visão Geral

WPCode é um plugin popular do WordPress para gerenciar snippets de código personalizados — scripts de cabeçalho/rodapé, PHP personalizado, CSS personalizado, pixels de conversão e assim por diante. A integração WPCode do WP Simple Pay registra um nome de usuário oficial wpsimplepay dentro da biblioteca de snippets do WPCode, facilitando a descoberta e instalação de snippets de código específicos do WP Simple Pay sem copiar de páginas de documentação.

Quando a integração estiver ativa, você pode pesquisar na biblioteca do WPCode por snippets como “WP Simple Pay – Hide Title”, “WP Simple Pay – Custom Currency Format” ou “WP Simple Pay – Conditional Field Display” e instalá-los com um clique. Os snippets são executados dentro do ambiente de execução seguro do WPCode e podem ser ativados, desativados ou modificados através da interface do usuário do WPCode.

Pré-requisitos

• WP Simple Pay (qualquer nível)
• O plugin WPCode instalado e ativado

Passo 1: Instalar WPCode

Se você ainda não tem o WPCode:

1. Navegue até Plugins > Adicionar Novo no seu admin do WordPress.
2. Pesquise por WPCode.
3. Instale e ative o plugin publicado por WPCode (anteriormente “Insert Headers and Footers”).

A versão gratuita é suficiente para usar a biblioteca de snippets do WP Simple Pay.

Passo 2: Verificar se a Integração está Ativa

Assim que ambos os plugins estiverem ativos, a integração se registra automaticamente — nenhuma configuração manual é necessária. Para verificar:

1. Navegue até Code Snippets > Library no seu admin do WordPress (o menu WPCode).
2. Navegue ou pesquise na biblioteca.
3. Procure por snippets criados por WP Simple Pay.

Passo 3: Navegar pelos Snippets do WP Simple Pay

Dentro da Biblioteca do WPCode, você pode filtrar ou pesquisar por snippets contribuídos pela equipe do WP Simple Pay. Categorias comuns de snippets disponíveis incluem:

• Ajustes de comportamento do formulário — Ocultar títulos, alterar rótulos de botões, restringir tempo de envio
• Lógica condicional — Mostra/oculta campos com base no estado do formulário ou nos dados do usuário
• Moeda e formatação — Regras personalizadas de exibição de moeda, formatação de números
• Personalizações de e-mail — Modifique modelos de e-mail, anexe dados a e-mails
• Exibição no frontend — Ajuste como os formulários são renderizados em páginas ou modelos específicos
• Personalizações de webhook — Modifique o comportamento do payload do webhook
• Ganchos avançados para desenvolvedores — Filtros e ações para personalização detalhada

Cada snippet inclui uma descrição, o nome do autor e uma prévia do código para que você possa revisar o que ele faz antes de instalar.

Etapa 4: Instalar um Snippet

Quando encontrar um snippet que deseja:

1. Clique no card do snippet para abrir sua página de detalhes.
2. Clique em Usar Snippet (ou Instalar, dependendo da versão do WPCode).
3. O WPCode importa o snippet para o seu site como um rascunho. Ele não está ativo por padrão — revise-o primeiro.
4. Clique em Salvar e Ativar para habilitá-lo.

O WPCode cuida do ambiente de execução para que você não precise editar arquivos de tema ou plugin diretamente.

Etapa 5: Gerenciar Snippets Instalados

Os snippets instalados aparecem em Code Snippets > All Snippets. A partir daí, você pode:

• Ativar ou desativar um snippet
• Editar o código (útil para personalizar parâmetros como IDs de formulário)
• Agendar quando o snippet será executado (páginas específicas, dispositivos, funções de usuário)
• Desativar um snippet temporariamente para solução de problemas

Por que usar o WPCode em vez de editar arquivos diretamente?

	Snippets do WPCode + WP Simple Pay	Edição de functions.php ou de um plugin personalizado
Erros de sintaxe	Capturados e revertidos automaticamente	Pode deixar seu site com a tela branca
Segurança de atualização	Snippets persistem em atualizações de plugins/temas	Atualizações de tema podem apagar alterações
Visibilidade	Todo o código personalizado visível em um só lugar	Espalhados por arquivos
Desativação	Desativar com um clique	Requer edição de arquivo ou FTP
Controle de versão	Rastreamento de alterações integrado	Git/backup manual

Para não desenvolvedores, o WPCode é a maneira mais segura de aplicar personalizações. Para desenvolvedores, ainda é útil porque todo o seu código personalizado é centralizado e sobrevive à substituição de plugins/temas.

Perguntas Frequentes

Onde posso ver a biblioteca de snippets do WP Simple Pay?

Dentro da guia Biblioteca do WPCode, uma vez que ambos os plugins estejam ativos. Você também pode navegar pela biblioteca pública no site do WPCode e pesquisar por “WP Simple Pay” — mas a instalação requer que o plugin WPCode esteja em execução no seu site.

Os snippets são gratuitos?

Os snippets oficiais do WP Simple Pay são gratuitos. Alguns snippets avançados podem exigir uma assinatura do WPCode Pro se usarem recursos exclusivos do WPCode Pro (por exemplo, lógica condicional, agendamento), mas os próprios snippets não têm custo extra.

Posso escrever meus próprios snippets?

Sim. O WPCode suporta snippets personalizados que você mesmo cria — eles não precisam vir da biblioteca. A integração apenas registra o nome de usuário da biblioteca do WP Simple Pay; ela não restringe o que você pode fazer com o WPCode de outra forma.

Os snippets quebrarão quando eu atualizar o WP Simple Pay?

O WP Simple Pay mantém uma API estável de filtros e ações, então a maioria dos snippets continua funcionando entre as versões. Se um snippet depender de uma função interna que muda, ele falhará graciosamente (ou será marcado como obsoleto na listagem do snippet no WPCode). Sempre teste os snippets após atualizações importantes do plugin.

Como isso é diferente da guia Automações?

A guia Automações se integra ao Uncanny Automator para fluxos de trabalho sem código entre eventos do WP Simple Pay e outros aplicativos. O WPCode é para personalizações de PHP/JS/CSS no seu próprio site. Eles atendem a necessidades diferentes e podem ser usados juntos.

Por que não vejo os snippets do WP Simple Pay no WPCode?

Certifique-se de que ambos os plugins estejam ativos e que você esteja olhando para a guia Biblioteca, não para sua lista de snippets locais. A integração é registrada nas páginas administrativas do WPCode, portanto, visite Code Snippets > Library pelo menos uma vez após a ativação para garantir que o registro seja executado.

Próximos Passos?

• Como Usar a Guia Automações – Automações sem código via Uncanny Automator
• Informações Gerais Sobre Integrações – Outras integrações disponíveis