Consentl no Ghost

Adicione o Consentl ao Ghost com a injeção de código, ou no tema para ficar em primeiro lugar no <head>, e veja que funcionalidades do Ghost não são retidas.

Loader em primeiro lugar no <head>: Depende do método

Método	Em primeiro lugar no `<head>`?	Plano
A. Injeção de código	Não: perto do fim do `<head>` (dentro de `{{ghost_head}}`)	Todos os planos e alojamento próprio
B. Tema `default.hbs`	Sim	Ghost(Pro) Publisher ou superior (temas personalizados), ou alojamento próprio

Porque é que o método A costuma ser suficiente. O Ghost apresenta a injeção de código do cabeçalho do site no fim de {{ghost_head}}. Quase todos os scripts que o Ghost escreve antes dela são diferidos (Portal, pesquisa, barra de anúncios, recursos dos cartões, contagens de comentários, atribuição de membros, estatísticas web do Ghost), pelo que um loader do Consentl síncrono continua a ser executado antes deles. Ser executado primeiro não significa que o Consentl os retenha: são scripts próprios do Ghost, e o Consentl não os bloqueia (consulte Limitações). As exceções são o Stripe.js (apenas quando as subscrições pagas estão ativadas) e qualquer <script> que o seu tema coloque acima de {{ghost_head}}.

A sua chave do site Consentl está na página Configuração do seu site no painel. Adicione o nome de anfitrião da publicação no campo Domínios; www. e o domínio sem www contam como o mesmo site, pelo que não é preciso adicionar www. separadamente.

O que inclui o seu plano Consentl

Free: apenas banner, registo de consentimentos e bloqueio manual.
Pro: acrescenta o Google Consent Mode v2.
Business: acrescenta o bloqueio automático de rastreadores conhecidos e as regras de bloqueio que acrescentar no painel.

Nos planos Free e Pro, só são retidas as tags que marcar manualmente.

A. Injeção de código

Ghost Admin → Settings → Code injection (no Ghost 5 e 6, em Advanced; clique em Open).
Em Site header, cole o loader como primeira linha:
```
<script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=en"></script>
```
Se o site também utilizar o modelo Consentl para o GTM, acrescente &gcm=ext ao URL para que só o modelo envie comandos do Consent Mode.
Save.
Verifique se o seu tema tem tags <script> acima de {{ghost_head}} no default.hbs. Se carregarem rastreadores, utilize o método B.

B. Tema (realmente em primeiro lugar)

Transfira o seu tema: Settings → Site → Theme → Change theme → Installed e depois transfira o tema ativo a partir do respetivo menu.

No default.hbs, cole o loader imediatamente a seguir a <meta charset="utf-8">:

<head>
    <meta charset="utf-8">
    <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l={{@site.locale}}"></script>

Comprima o tema em zip e carregue-o. Remova a versão por injeção de código, se a tiver acrescentado.

Extras

Ligação «Definições de cookies»: acrescente um item de navegação (Settings → Site → Navigation, navegação secundária) com o URL #consentl. As ligações cujo URL termina em #consentl ou #consentl-preferences, e qualquer elemento com o atributo data-consentl-open, abrem as preferências.
Declaração de cookies: acrescente um cartão HTML à página da sua política de cookies:
```
<div data-consentl-declaration data-api="https://api.consentl.com" data-key="SITE_KEY" data-locale="en"></div>
<script src="https://api.consentl.com/v1/blocks.js" defer></script>
```
Utilize data-consentl-request ou data-consentl-withdrawal em vez disso para o formulário de pedidos relativos a dados pessoais ou o formulário de livre resolução da UE. O formulário de livre resolução exige o plano Pro ou superior e tem de ser ativado no painel; caso contrário, fica vazio.
A injeção de código por artigo ou por etiqueta é executada depois do cabeçalho do site; não é preciso nada aí.

Verificar que funciona

Abra a publicação numa janela privada: o banner aparece. Veja o código-fonte para saber onde está o loader.

A região do visitante é determinada a partir do seu endereço IP: o Consentl consulta o país em memória em cada visualização de página (nada é guardado) e aplica a regra do painel para esse país. Os estados dos EUA não são distinguidos: os visitantes dos EUA recebem a sua regra para todos os EUA ou, se não existir, a sua primeira regra para um estado dos EUA. Um país desconhecido recebe a sua regra para regiões desconhecidas (opt-in por predefinição).

Limitações

A atribuição de membros guarda o histórico de navegação antes do consentimento. Quando o rastreio da origem dos membros do Ghost está ativado, member-attribution.min.js guarda as páginas que um visitante viu em sessionStorage (ghost-history) desde a primeira visualização de página, para que um registo posterior possa ser atribuído. O Consentl não o retém. Desative o rastreio da origem dos membros (nas definições de estatísticas do Ghost Admin; a definição tem um nome semelhante a «Member sources» / «track member sources», verifique o nome atual na sua versão do Ghost) ou trate-o como uma decisão jurídica sua e descreva-o na sua política de cookies.
As estatísticas web do Ghost (Tinybird, ghost-stats) não utilizam cookies e são carregadas pelo próprio Ghost; o bloqueio automático do Consentl não as abrange. Desative-as em Settings → Analytics se a sua avaliação jurídica exigir consentimento.
O Stripe.js é necessário para as subscrições pagas e é estritamente necessário para os pagamentos; não é bloqueado.
O Portal (registo e início de sessão de membros) não é bloqueado. Não conseguimos confirmar, a partir da documentação do Ghost, que cookies ou armazenamento utiliza. Verifique em DevTools → Application (Cookies, Local Storage, Session Storage) numa visita nova e depois de iniciar sessão, e liste o que encontrar na sua declaração de cookies.
Tags inseridas diretamente. Um <script src>, um píxel <img> ou um <iframe> escrito na injeção de código, no tema ou num cartão HTML é obtido pelo navegador antes de qualquer script o poder travar, mesmo quando o Consentl impede a sua execução. Marque essas tags manualmente e remova os píxeis em <noscript>:
```
<script type="text/plain" data-consentl="marketing" src="https://ads.example.com/tag.js"></script>
<iframe data-consentl="marketing" data-src="https://www.youtube-nocookie.com/embed/ID" title="Video"></iframe>
<img data-consentl="marketing" data-src="https://tracker.example.com/pixel.gif" alt="" width="1" height="1">
```
As tags carregadas por código (GTM, o loader JavaScript de um píxel) são retidas sem qualquer pedido quando o bloqueio automático está ativado (plano Business e superiores).
O Ghost(Pro) Starter não permite carregar temas personalizados, pelo que só está disponível o método A.

Com dificuldades? Escreva para support@consentl.com — respondemos em inglês nos dias úteis.