EXT:vgwort — Tracking Pixels in TYPO3, the Easy Way

Im ersten Teil dieser Serie haben wir uns angeschaut, was VG Wort eigentlich ist, warum es für Publisher relevant ist und wie das METIS-Portal funktioniert. Falls du den Einstieg verpasst hast: Teil 1: VG Wort und TYPO3 — Was du als Publisher wissen musst liefert dir das nötige Grundlagenwissen.

Jetzt wird es praktisch. Du weißt, dass VG Wort Geld für deine Online-Texte ausschüttet. Du weißt, dass dafür Zählpixel auf deinen Seiten eingebunden werden müssen. Die Frage ist: Wie bekomme ich das in TYPO3 sauber umgesetzt, ohne an Templates herumzubasteln oder Tracking-Codes manuell ins HTML zu kopieren?

Die Antwort: EXT:vgwort — unsere kostenlose, quelloffene Extension, die genau dieses Problem löst.

• Teil 1: VG Wort und TYPO3: Was du als Publisher wissen musst 
• Teil 2: EXT:vgwort: Zählpixel in TYPO3, der einfache Weg (dieser Artikel)
• Teil 3: VG Wort Pro: Automatisierte Meldung für professionelle Publisher

Wie bei allen unseren Extensions setzen wir auf Composer. Eine einzige Zeile reicht:

composer req b13/vgwort

Die Extension unterstützt TYPO3 v13 und v14 und setzt PHP 8.2 oder höher voraus. Damit decken wir die aktuellen LTS-Versionen ab, die in den meisten Projekten im Einsatz sind.

Nach der Installation musst du die Extension noch im TYPO3 Backend aktivieren — bei Composer-basierten Installationen geschieht das in der Regel automatisch.

EXT:vgwort nutzt das Site-Set-Konzept von TYPO3, um sich sauber in deine Seite zu integrieren. Füge die Extension als Dependency in der config.yaml deines Site-Packages hinzu:

Das war’s im Grunde schon. Durch diese Einbindung rendert die Extension den Zählpixel automatisch nach dem öffnenden <body>-Tag — aber nur auf Seiten, denen auch tatsächlich ein Pixel zugewiesen wurde. Keine Pixel-Zuweisung, kein Tracking-Code im HTML. Sauber.

VG Wort verteilt die Zählpixel auf verschiedene Subdomains (vg01.met.vgwort.de bis vg09.met.vgwort.de). Welche Subdomain für deine Pixel gilt, siehst du in deinem METIS-Konto, wenn du Zählmarken bestellst. Standardmäßig verwendet die Extension vg08. Falls deine Pixel eine andere Subdomain verwenden, pass das in der settings.yaml deines Site-Packages an:

In den meisten Fällen reicht die automatische Einbindung über das Site Set. Wenn du aber mehr Kontrolle über die Platzierung des Pixels brauchst — etwa weil dein Template-Setup speziell ist — kannst du den Pixel auch manuell per Fluid Partial rendern:

In unserer Erfahrung brauchen das die wenigsten Projekte. Aber es ist gut zu wissen, dass die Option existiert.

Für Redakteure ändert sich wenig am gewohnten Workflow. Die Extension fügt den Seiteneigenschaften einen neuen Reiter VG Wort hinzu, der zwei Felder enthält:

Zählpixel-Code (tx_vgwort_pixel): Hier trägt der Redakteur den öffentlichen Identifikationscode des Zählpixels ein. Diesen Code erhältst du, wenn du im METIS-Portal Zählmarken bestellst — jede Zählmarke besteht aus einem öffentlichen und einem privaten Code. In dieses Feld kommt der öffentliche.

Seite ignorieren (tx_vgwort_ignore): Eine Checkbox, um eine Seite explizit von der VG Wort Erfassung auszuschließen. Das ist praktisch für Seiten, die zwar redaktionellen Inhalt haben, aber aus bestimmten Gründen nicht gemeldet werden sollen — etwa Landingpages mit wenig eigenem Text oder Seiten mit überwiegend fremden Inhalten.

Der Ablauf ist denkbar einfach: Redakteur öffnet die Seiteneigenschaften, wechselt zum VG Wort Reiter, fügt den Pixel-Code ein, speichert. Fertig. Beim nächsten Seitenaufruf wird der Zählpixel automatisch im HTML gerendert.

Wer viele Seiten betreut, verliert schnell den Überblick: Welche Seiten haben bereits einen Pixel? Welche noch nicht? Wurde eine wichtige Seite vergessen?

EXT:vgwort erweitert das TYPO3 Info-Modul (Web > Info) um eine VG Wort Übersicht. Dort siehst du auf einen Blick, welche Seiten Pixel zugewiesen haben, welche explizit ignoriert werden und welche noch offen sind. Das macht die Qualitätskontrolle deutlich einfacher — besonders wenn mehrere Redakteure an einer Website arbeiten.

Standardmäßig zeigt die Extension die VG Wort Felder nur auf normalen Seiten (Doktype 1). Wenn du eigene Seitentypen verwendest — etwa für Blog-Artikel, News-Detailseiten oder andere spezielle Doktypen — kannst du diese einfach registrieren:

Wichtig dabei: Dein Site-Package muss b13/vgwort als Composer-Dependency deklarieren, damit die Konfiguration zum richtigen Zeitpunkt geladen wird. Das ist Standard-TYPO3-Praxis, aber ich erwähne es trotzdem, weil wir diesen Stolperstein in Projekten schon gesehen haben.

Der VG Wort Zählpixel ist ein Tracking-Mechanismus — auch wenn er keine Cookies setzt und keine personenbezogenen Daten im klassischen Sinne erhebt. Trotzdem solltest du das Thema nicht ignorieren. In unserer Erfahrung empfiehlt es sich, den Zählpixel in deiner Datenschutzerklärung transparent zu erwähnen. VG Wort stellt dafür Musterformulierungen bereit, die du in deine Datenschutzseite einbauen kannst. Sprich im Zweifelsfall mit deinem Datenschutzbeauftragten — gerade bei größeren Projekten ist das kein überflüssiger Schritt.

Ich bin ehrlich: EXT:vgwort ist bewusst einfach gehalten. Es ist eine single-purpose Extension, die genau eine Sache gut macht — Zählpixel in TYPO3-Seiten einbinden.

Die kostenlose Version ist genau richtig für dich, wenn:

• Du einen kleineren Blog oder eine Website mit überschaubarer Seitenzahl betreibst.
• Deine Redakteure die Pixel manuell aus dem METIS-Portal kopieren und einzelnen Seiten zuweisen können.
• Die jährliche Meldung an VG Wort manuell über das METIS-Portal erfolgt.
• Du keinen automatisierten Abgleich zwischen TYPO3 und VG Wort brauchst.

Für ein Blog mit 20, 50 oder auch 100 Artikeln ist das völlig ausreichend. Du bestellst Zählmarken in METIS, weist sie im TYPO3 Backend zu, und am Jahresende meldest du deine Texte manuell im Portal.

Wenn die Seitenzahl wächst, wächst auch der manuelle Aufwand. Und genau da stößt du auf die Grenzen der kostenlosen Version:

• Kein Pixel-Pool-Management: Du musst Pixel einzeln aus METIS kopieren und in TYPO3 einfügen. Bei 500 Artikeln wird das mühsam.
• Keine Autoren-Zuordnung: VG Wort verlangt bei der Meldung die Zuordnung zu Autoren. Das passiert in der kostenlosen Version komplett außerhalb von TYPO3.
• Keine automatische Textmeldung: Die eigentliche Registrierung deiner Texte bei VG Wort — mit Titel, Autor, URL und Zeichenzahl — erfolgt manuell im METIS-Portal oder per CSV-Upload.
• Keine API-Anbindung: Es gibt keine Verbindung zwischen TYPO3 und der VG Wort METIS-Schnittstelle.

Für Publisher mit hunderten oder tausenden Artikeln, mehreren Autoren und dem Wunsch nach einem durchgehend automatisierten Workflow ist das auf Dauer nicht praktikabel. Genau dafür haben wir VG Wort Pro entwickelt — aber dazu mehr im dritten und letzten Teil dieser Serie.

Im nächsten Artikel zeige ich dir, wie VG Wort Pro den gesamten Prozess automatisiert: vom Pixel-Pool, der sich direkt aus der API befüllt, über die Autoren-Verwaltung in TYPO3 bis hin zur automatischen Textmeldung an VG Wort. Wenn du heute mit der kostenlosen Version startest und später mehr brauchst, ist der Umstieg nahtlos.