# FlowConsent auf WordPress installieren

Auf WordPress kommt der FlowConsent-Code in Code Snippets → Header & Footer (WPCode) oder ein Child-Theme. Danach Cache leeren und das Site-Kit-gtag entfernen.

> Canonical: https://www.flowconsent.com/de/doc/install-wordpress
> Last updated: 2026-10-01
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](https://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](/de/doc/cloudflare-deployment)), 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:

```html title="FlowConsent-Code"
<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.

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

> [!TIP]
> Steht in diesem Feld bereits ein Google-Tag oder Google Tag Manager, lassen Sie ihn **unterhalb** des FlowConsent-Codes. Google Analytics und Werbepixel entfernen Sie am saubersten und deklarieren sie stattdessen unter **Builder → Services**: Das Banner lädt sie dann erst nach der Einwilligung.

## Schritt 2, Alternative: ein Child-Theme

Wenn Sie kein weiteres Plugin möchten, nutzen Sie ein [Child-Theme](https://developer.wordpress.org/themes/advanced-topics/child-themes/): 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`):

```php title="wp-content/themes/ihr-child-theme/functions.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

> [!WARNING]
> **Cache und Minifizierung.** Optionen wie „JavaScript aufschieben“, „JavaScript-Ausführung verzögern“ oder „JS-Dateien zusammenfassen“ (WP Rocket, LiteSpeed Cache, Autoptimize, W3 Total Cache…) können den Code ans Seitenende verschieben oder bis zur ersten Interaktion zurückhalten. Tracking-Scripts laufen dann vor dem Banner. Nehmen Sie den Consent-Mode-Stub (`FlowConsent Loader`) und die Domain `consent.flowconsent.com` von diesen Optimierungen aus.

> [!WARNING]
> **Google-Plugins, die gtag einfügen.** Site Kit by Google gibt wie andere Google-Analytics-Plugins ein eigenes `gtag` im `<head>` aus, oft oberhalb der WPCode-Ausgabe. Deaktivieren Sie die Code-Platzierung unter **Site Kit → Settings → Connected Services → Analytics → Edit**, Schalter **Place Google Analytics code**, und deklarieren Sie Google Analytics unter **Builder → Services**. Site Kit zeigt Ihre Statistiken weiterhin im WordPress-Dashboard an.

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

## Installation prüfen

1. Öffnen Sie die Website in einem privaten Fenster: Das Banner erscheint.
2. Im Tab **Netzwerk** der Entwicklertools geht vor dem Klick auf **Akzeptieren** keine Anfrage an Google, Meta oder andere Dritte.
3. 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](/de/doc/setup-wizard).
4. Schließen Sie mit einem **Ablehnungs-Scan** aus dem Tab **Compliance** ab ([Compliance-Prüfung](/de/doc/compliance-verification)).

## 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](/de/doc/mcp-server) und die Seite [FlowConsent MCP](/de/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](/de/doc/google-consent-mode).

### Warum erscheint das Banner nach der Installation nicht?

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.