FlowConsent auf WordPress installieren

Auf WordPress gehört der FlowConsent-Code in das Feld Header des Plugins WPCode (Code Snippets → Header & Footer) oder, bei individuell entwickelten Websites, in die functions.php eines Child-Themes. Die Installation umfasst drei Schritte: Code kopieren, einfügen, Cache leeren. Die häufigste Falle: Cache- oder Minifizierungs-Plugins, die das Script verschieben oder verzögern, und Google-Plugins wie Site Kit, die ihr eigenes gtag oberhalb des Banners einfügen.

Bevor Sie beginnen

Ein Konto auf app.flowconsent.com (Tarif Free kostenlos, ohne Kreditkarte, bis zu 25.000 Sitzungen pro Monat).
Ein erstelltes und bereitgestelltes Banner. Im Tarif Free erfolgt die Bereitstellung über Ihr eigenes Cloudflare-Konto (siehe Cloudflare-Anleitung), in Pro und Enterprise mit einem Klick.
Administratorzugang zu WordPress.

Schritt 1: Code kopieren

Öffnen Sie in FlowConsent Builder → Deployment → Integration, Tab HTML / No-code. Der Code besteht aus zwei Teilen, in dieser Reihenfolge:

FlowConsent-Code

html

<script>
// FlowConsent Loader - VOR jedem anderen Script im <head> platzieren
window.dataLayer=window.dataLayer||[];
function gtag(){dataLayer.push(arguments);}
gtag('consent','default',{
  'ad_storage':'denied',
  'analytics_storage':'denied',
  'ad_user_data':'denied',
  'ad_personalization':'denied',
  'wait_for_update':500
});
gtag('set','url_passthrough',true);
gtag('set','ads_data_redaction',true);
</script>
<!-- FlowConsent CMP -->
<script src="https://IHR-LIZENZCODE.consent.flowconsent.com/cookie-manager.js?code=IHR_LIZENZCODE"></script>

Der erste Block setzt die denied-Standardwerte von Google Consent Mode v2, der zweite lädt das Banner. Beide müssen so weit oben wie möglich im <head> stehen, vor jedem Tracking-Script (Google Analytics, Meta Pixel, Google Tag Manager…): Alles, was darüber steht, entgeht der vorherigen Blockierung.

Schritt 2, empfohlene Methode: das Plugin WPCode

WPCode (früher „Insert Headers and Footers“) ist mit über 3 Millionen aktiven Installationen das meistgenutzte Plugin für diesen Zweck.

Suchen Sie im Menü Plugins nach WPCode, installieren und aktivieren Sie es.
Öffnen Sie im linken Menü Code Snippets → Header & Footer.
Fügen Sie den Code ganz oben in das Feld Header ein, über allem bereits vorhandenen Code (Google Analytics, GTM, Pixel).
Speichern Sie.

Schritt 2, Alternative: ein Child-Theme

Wenn Sie kein weiteres Plugin möchten, nutzen Sie ein Child-Theme: WordPress rät davon ab, das Parent-Theme direkt zu bearbeiten, weil das nächste Update Ihre Änderungen löschen würde. Hängen Sie den Code in der functions.php des Child-Themes mit Priorität 1 an den Hook wp_head. Er läuft damit vor der Ausgabe der von Plugins eingereihten Scripts (Priorität 9):

wp-content/themes/ihr-child-theme/functions.php

php

<?php
add_action( 'wp_head', function () {
  ?>
  <!-- Hier den vollständigen FlowConsent-Code einfügen (beide Blöcke) -->
  <?php
}, 1 );

Verwenden Sie dafür nicht den integrierten Datei-Editor: Er legt keine Sicherung an, und ein PHP-Fehler kann die Website lahmlegen. Arbeiten Sie per SFTP oder über den Dateimanager Ihres Hosters.

Schritt 3: Caches leeren

Leeren Sie den Cache Ihres Cache-Plugins, Ihres Hosters und Ihres CDN. Sonst erhalten Besucher weiterhin die alte Version der Seiten, ohne Banner.

Typische Fallen bei WordPress

Es darf nur ein Cookie-Banner aktiv sein: Deaktivieren Sie jedes andere Consent-Plugin, bevor FlowConsent live geht.

Installation prüfen

Öffnen Sie die Website in einem privaten Fenster: Das Banner erscheint.
Im Tab Netzwerk der Entwicklertools geht vor dem Klick auf Akzeptieren keine Anfrage an Google, Meta oder andere Dritte.
Starten Sie den Installationsassistenten (Builder → Integration): Er prüft die Live-Seite (Loader mit Ihrem Lizenzcode vorhanden, Consent-Mode-Stub vorhanden, Stub vor jedem Google-Tag). Siehe Installationsassistent.
Schließen Sie mit einem Ablehnungs-Scan aus dem Tab Compliance ab (Compliance-Prüfung).

Mit Ihrem KI-Agenten erledigen (MCP)

FlowConsent bietet einen offiziellen MCP-Server, https://mcp.flowconsent.com, nutzbar aus Claude, ChatGPT oder jedem MCP-Client. Die Verbindung erfolgt per OAuth 2.0 mit Ihrem FlowConsent-Konto, ohne API-Schlüssel. Ihr Agent ruft den Code und die Platzierungsanweisungen ab (Tools get_banner_snippet und get_setup_instructions), prüft die Installation mit einem echten Scan (verify_consent_compliance) und kann eine wiederkehrende Überwachung einrichten (monitor_compliance). Ihre WordPress-Website ändert er nicht: Das Einfügen bleibt Ihre Aufgabe.

Beispielanfrage: „Gib mir den Code meines Banners für meine WordPress-Website und prüfe, ob er auf https://meineseite.de korrekt installiert ist.“

Siehe MCP-Server-Anleitung und die Seite FlowConsent MCP.

Häufige Fragen

Kann ich FlowConsent über Google Tag Manager laden?

Nein. Ein über GTM geladenes Banner kommt für die vorherige Blockierung zu spät. Platzieren Sie den Code im <head> oberhalb des GTM-Containers: Google-Tags beachten dann die Consent-Mode-v2-Signale, andere Tags benötigen die „Zusätzlichen Einwilligungseinstellungen“. Details in der Consent-Mode-Anleitung.

Fast immer liegt es am Cache: Leeren Sie Plugin-, Hoster- und CDN-Cache und testen Sie in einem privaten Fenster. Prüfen Sie dann im Seitenquelltext, ob der Code im <head> steht.

Brauche ich ein Child-Theme, wenn ich WPCode nutze?

Nein, beide Methoden sind Alternativen. WPCode behält den Code bei Theme-Updates; ein Child-Theme lohnt sich nur, wenn Sie kein weiteres Plugin möchten.

Funktioniert das mit einem Block-Theme (Full Site Editing)?

Ja. WPCode und der Hook wp_head funktionieren mit klassischen Themes ebenso wie mit Block-Themes.