Integração com WordPress

Encontrando seu Banner ID

Antes de começar, você precisa do seu Banner ID. Para encontrá-lo:

1. Acesse o Dashboard da Cookield
2. Vá para Banners no menu lateral
3. Selecione o banner do seu site
4. Na aba Instalação, copie o Banner ID (formato: ban_xxxxxxxxx)

Método 1: Plugin Cookield (Recomendado)

O plugin oficial Cookield para WordPress é a forma mais simples de integração.

1. No painel do WordPress, vá para Plugins → Adicionar novo
2. Pesquise por "Cookield"
3. Clique em Instalar agora e depois em Ativar
4. Vá para Configurações → Cookield
5. Cole seu Banner ID no campo indicado
6. Clique em Salvar alterações

Método 2: Manual via header.php

Adicione o script diretamente no arquivo header.php do seu tema ativo:

1. No painel do WordPress, vá para Aparência → Editor de tema
2. Selecione o arquivo header.php
3. Adicione o script antes de <?php wp_head(); ?>
4. Clique em Atualizar arquivo

<!-- wp-content/themes/seu-tema/header.php -->
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
  <meta charset="<?php bloginfo('charset'); ?>">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">

  <!-- Cookield CMP — adicionar ANTES de wp_head() -->
  <script src="https://cdn.cookield.io/banner/SEU_BANNER_ID.js" async></script>

  <?php wp_head(); ?>
</head>

Método 3: Via functions.php (wp_head hook)

Este método usa o hook wp_head para injetar o script programaticamente. Mais seguro contra atualizações de tema.

// wp-content/themes/seu-tema/functions.php
// (ou no functions.php do tema filho)

function cookield_add_banner_script() {
    ?>
    <script src="https://cdn.cookield.io/banner/SEU_BANNER_ID.js" async></script>
    <?php
}
add_action('wp_head', 'cookield_add_banner_script', 1);

O parâmetro 1 define prioridade máxima, garantindo que o script seja carregado antes de outros.

Alternativa: wp_enqueue_scripts

// functions.php — usando wp_enqueue_scripts
function cookield_enqueue_banner() {
    wp_enqueue_script(
        'cookield-banner',
        'https://cdn.cookield.io/banner/SEU_BANNER_ID.js',
        array(), // sem dependências
        null,    // sem versão (URL já versionada)
        false    // false = carrega no <head>
    );
}
add_action('wp_enqueue_scripts', 'cookield_enqueue_banner', 1);

Verificando a instalação

1. Acesse seu site em uma janela anônima
2. O banner de consentimento deve aparecer na primeira visita
3. No Dashboard da Cookield, vá para Banners → Status — deve mostrar "Ativo"
4. Abra o DevTools (F12) → Console — não deve haver erros