Wer Teil 2 dieser Serie gelesen hat, kennt bereits unsere kostenlose Extension EXT:vgwort. Sie löst ein konkretes Problem: Zählpixel kommen sauber in die Seite, Redakteure können Pixel zuweisen, und die DSGVO-konforme Auslieferung funktioniert automatisch. Für viele Websites reicht das.
Aber was passiert, wenn du 200 Artikel mit Pixeln verwaltest? Wenn drei Autoren regelmäßig Texte veröffentlichen und jeder seine eigene VG-Wort-Karteinummer hat? Wenn du am Jahresende für einen Verlag die Textmeldung an die VG Wort machen musst — und das bedeutet: Jeden einzelnen Text aus der Website kopieren, in T.O.M. (dem METIS-Webportal der VG Wort) einfügen, Autoren zuordnen, Mindestlänge prüfen, absenden, Status nachverfolgen?
Dann wird die manuelle Arbeit zum echten Engpass. Und genau hier setzt EXT:vgwort-pro an.
Online-Texte bringen Traffic—und oft auch Tantiemen. Teil 1 unserer Serie erklärt, wie die VG Wort und METIS funktionieren und warum sich die Integration ins CMS lohnt.
weiterlesen: VG Wort und TYPO3: Was du als Publisher wissen musst
Zählpixel ohne Template-Bastelei: Teil 2 zeigt, wie du VG-Wort-Tracking mit unserer kostenlosen Extension EXT:vgwort in TYPO3 aufsetzt.
weiterlesen: EXT:vgwort — Tracking Pixels in TYPO3, the Easy Way
Schluss mit Copy-Paste in T.O.M.: Teil 3 zeigt, wie VG Wort Pro Pixelbestellung, Autorenverwaltung und Textmeldung direkt in TYPO3 abbildet.
weiterlesen: VG Wort Pro: Automatisierte Meldung für professionelle PublisherEin wichtiger Punkt vorweg: Die Pro-Extension ersetzt die kostenlose Version nicht — sie erweitert sie. Alles, was du in Teil 2 über Pixelzuweisung und Frontend-Rendering gelesen hast, bleibt bestehen. Pro fügt die Schicht darüber hinzu: die Kommunikation mit der VG Wort über deren METIS REST API.
Noch ein wichtiger Unterschied zu Teil 2: Die freie Extension unterstützt TYPO3 v13 und v14. EXT:vgwort-pro setzt TYPO3 v14 voraus — wer noch auf v13 ist, muss zuerst upgraden.
Konkret bedeutet das: Statt zwischen TYPO3 und dem T.O.M.-Portal hin und her zu wechseln, erledigst du die gesamte VG-Wort-Verwaltung im TYPO3-Backend. Pixelbestellung, Autorenverwaltung, Textmeldung, Statusabgleich — alles an einem Ort.
Die Pro-Extension nutzt acht Endpunkte der METIS REST API: Registrierung, Autorenprüfung, Pixelbestellung, Qualitätskontrolle, Synchronisation und URL-Verwaltung. Damit deckt sie den kompletten Lebenszyklus eines VG-Wort-Textes ab.
Unterstützt werden beide Kontoarten: Verlag (für Verlage und Agenturen, die im Auftrag ihrer Autoren melden) und Urheber (für Einzelpersonen, die selbst publizieren). Die Konfiguration erfolgt über die TYPO3-Site-Settings in YAML — wer Multi-Site-Setups betreibt, kann pro Site unterschiedliche Zugangsdaten hinterlegen.
Was ich persönlich für unverzichtbar halte: den Testmodus. Die Extension kann gegen die Testumgebung der VG Wort (tom-test.vgwort.de) arbeiten, bevor du irgendetwas produktiv meldest. Gerade bei der ersten Einrichtung oder wenn du Workflows für einen Kunden aufsetzt, nimmt das enorm viel Druck raus.
In der freien Extension weist du Pixel einzeln manuell zu. Pro führt das Konzept eines Pixel-Pools ein: einen Vorrat an Zählpixeln, die deinen Seiten automatisch zugeordnet werden können.
Du hast zwei Wege, den Pool zu füllen. Entweder importierst du die CSV-Datei, die VG Wort über T.O.M. zum Download anbietet. Oder du bestellst Pixel direkt über die METIS API — bis zu 1.000 Stück pro Anfrage, ohne den Browser zu wechseln.
Was im Hintergrund passiert, klingt unspektakulär, spart aber in der Praxis viel Ärger: Öffentliche und private Codes werden automatisch einander zugeordnet, Duplikate werden erkannt und abgefangen, und eine Lock-Funktion verhindert, dass zugewiesene Pixel versehentlich verändert werden. In Multi-Site-Setups sind die Pools pro Site isoliert — ein Pixel aus Site A kann nicht versehentlich auf Site B landen.
Sobald mehr als eine Person Texte schreibt, wird die Autorenverwaltung relevant. Pro bietet ein vollständiges CRUD für Autoren: Name und VG-Wort-Karteinummer.
Der entscheidende Vorteil gegenüber einer manuellen Liste: Du kannst Karteinummern direkt gegen die VG-Wort-API validieren. Statt beim Jahresabschluss festzustellen, dass eine Karteinummer falsch war und die Meldung abgelehnt wird, prüfst du das sofort bei der Anlage.
Autoren können als inaktiv markiert werden — praktisch für ehemalige Mitarbeiter oder Gastautoren, die nicht mehr schreiben, deren historische Texte aber weiterhin gemeldet werden müssen. Pro Seite können mehrere Autoren zugeordnet werden, was der Realität in Redaktionen deutlich näherkommt als ein einzelnes Autorenfeld.
Ein weiterer, oft unterschätzter Vorteil: In T.O.M. kannst du eine Textmeldung nicht speichern, wenn die Karteinummer eines Autors fehlt — alle eingegebenen Daten sind weg. Das passiert gerne genau dann, wenn du unter Zeitdruck am Jahresende stehst und ein Autor seine Karteinummer gerade nicht zur Hand hat. Mit Pro kannst du Autoren in TYPO3 anlegen und Seiten zuordnen, auch ohne dass die Karteinummer schon bekannt ist. Du kannst die gesamte Meldung also das ganze Jahr über vorbereiten — nicht erst dann, wenn der Jahresabschluss drückt. Sobald du die Karteinummer hast, trägst du sie nach und sendest ab. Kein erneutes Eingeben, kein Datenverlust.
Hier wird es spannend, denn die Text-Registrierung ist das Feature, das den meisten manuellen Aufwand eliminiert.
Stell dir den bisherigen Ablauf vor: Du öffnest deine Website im Browser, kopierst den Text eines Artikels, wechselst zu T.O.M., fügst den Text ein, prüfst ob die Mindestlänge von 1.800 Zeichen erreicht ist, ordnest einen Autor zu, sendest die Meldung ab, und notierst dir irgendwo den Status. Für 50 Artikel wird das zu einem ganzen Arbeitstag.
Mit Pro passiert folgendes: Du öffnest die Text-Registrierung im TYPO3-Backend, wählst eine Seite aus, und die Extension rendert die Live-Seite, extrahiert den relevanten Content und prüft automatisch die Mindestlänge.
Warum ist das wichtig? Weil eine gerenderte Seite in der Regel viel mehr enthält als den eigentlichen Artikeltext. Navigation, Footer und Sidebar sind offensichtlich — aber auch Teaser zu verwandten Artikeln, Bildunterschriften, Autorenbios, Call-to-Action-Blöcke und ähnliches landen im HTML. Ohne Markierungen würde die Extension all das mitzählen und an die VG Wort übermitteln. Das verfälscht die Zeichenzahl und schickt Inhalte mit, die nicht zum eigentlichen Meldungstext gehören.
Die Content-Extraktion ist dabei intelligent gelöst. Du kannst in deinem Fluid-Template Marker setzen, um exakt zu definieren, welcher Bereich als Meldungstext gilt — über die Fluid-Partials VgwortInclude und VgwortExclude, die die Extension mitbringt. Den Partial-Pfad registrierst du einmal in deiner TypoScript-Konfiguration:
1
2
# In your site package: EXT:my_site/Configuration/TypoScript/setup.typoscript
lib.contentElement.partialRootPaths.5 = EXT:vgwort_pro/Resources/Private/Extraction/Partials
Danach kannst du die Partials in deinen Fluid-Templates einbinden. Die Partials funktionieren als Wrapper: Du umschließt den relevanten Bereich mit VgwortInclude, und einzelne Bereiche, die nicht in die Zeichenzählung einfließen sollen (z.B. Code-Blöcke oder Teaser), mit VgwortExclude:
1
2
3
4
5
6
7
<f:render partial="VgwortInclude" contentAs="content">
<article>... your article text ...</article>
</f:render>
<f:render partial="VgwortExclude" contentAs="content">
<div class="code-block">...</div>
</f:render>
Ohne Marker fällt die Extension auf das <main>-Element zurück, und als letzten Fallback auf <body>.
Technisch gesehen: Eine Middleware entfernt die Marker aus normalen Frontend-Responses, sodass Besucher nichts davon sehen. Die Text-Registrierung ruft die Seite intern mit dem Query-Parameter ?vgwort-markers=1 auf — damit bleiben die Marker erhalten und die Extraktion weiß, welcher Bereich relevant ist. Diese Requests erhalten automatisch Cache-Control: private, no-store.
Bevor die Meldung rausgeht, sehen Redakteure den extrahierten Text in einem Modal-Dialog. Sie können prüfen, ob Navigation, Footer oder andere irrelevante Bereiche versehentlich mit erfasst wurden, und den Text bei Bedarf anpassen. Im Modal legst du auch die Beteiligungsart (Urheber oder Übersetzer) pro Seite fest — dieselbe Person kann auf Seite A als Urheber und auf Seite B als Übersetzer gemeldet werden. Bei Verlagskonten (publisher: true in den Site Settings) erscheint außerdem eine Checkbox zur Verlagsbeteiligung: Damit kann der Verlag pro Seite aus der Vergütungsbeteiligung aussteigen. Bei persönlichen Konten ist diese Option ausgeblendet. Erst dann geht die Meldung per Klick an die METIS API. Den Registrierungsstatus trackt die Extension anschließend automatisch.
Das klingt nach einem kleinen Unterschied, aber rechne es einmal durch: Bei einem manuellen Aufwand von fünf Minuten pro Text — Kopieren, Formatierung bereinigen, in T.O.M. einfügen, Autor zuordnen, absenden — sind 100 Texte über acht Stunden Arbeit. Mit Pro sind es ein paar Klicks pro Text, den Rest erledigt die Extension.
Pro bringt ein eigenes Backend-Modul unter Web > VG Wort mit — mit Ansichten für die verschiedenen Verwaltungsaufgaben. Die wichtigsten Ansichten:
Die Pool-Verwaltung zeigt den aktuellen Pixelvorrat, welche Pixel zugewiesen sind und welche noch verfügbar. Die Ansicht Seiten ohne Pixel listet alle Seiten auf, die noch kein Zählpixel haben — gerade bei großen Sites mit hunderten Unterseiten ist das Gold wert, weil dir sonst garantiert Seiten durch die Lappen gehen. Die Autorenübersicht fasst alle angelegten Autoren mit Validierungsstatus zusammen. Und das Text-Registrierungs-Interface bündelt den oben beschriebenen Meldungs-Workflow.
Wer zwischen T.O.M. und TYPO3 abgleichen möchte, findet in der Sync-Ansicht eventuelle Diskrepanzen — etwa Pixel, die in T.O.M. einem anderen Text zugeordnet sind als in TYPO3. Der Sync umfasst dabei die letzten 36 Monate — ältere Meldungen werden nicht berücksichtigt.
Optional — wer das TYPO3 Dashboard nutzt — gibt es ein Widget mit einer Status-Übersicht pro Site: Wie viele Seiten haben kein Pixel? Gibt es unverifizierte Autoren? Welche Texte sind zu kurz für eine Meldung? Wie steht es um den Pool? Ein schneller Blick beim Öffnen des Backends, statt sich erst durch verschiedene Module klicken zu müssen.
In einem Ein-Redakteur-Setup ist Rechtevergabe kein Thema. Sobald aber mehrere Personen beteiligt sind — Redakteure, die Texte schreiben, eine verantwortliche Person für die VG-Wort-Meldung, vielleicht ein externer Dienstleister — wird es relevant.
Pro bietet fünf granulare Berechtigungsstufen über Page TSconfig: Upload (CSV-Import), Bestellung (API-Pixelbestellung), Validierung (Autorenprüfung), Meldung (Textregistrierung) und Synchronisation. Admins umgehen diese Einschränkungen automatisch. So kannst du etwa einer Redakteurin erlauben, Texte zur Meldung vorzubereiten, ohne dass sie die Meldung selbst absenden kann.
Multi-Site ist vollständig unterstützt: Konfiguration, Pixelpools und Autorendatenbanken sind pro Site isoliert. Für Agenturen, die mehrere Kundenprojekte auf einer TYPO3-Installation betreiben, ist das ein Muss.
Und für alle, die TYPO3 Workspaces nutzen: Pro arbeitet auf Live-Daten — eine tiefe Workspace-Integration gibt es nicht. Was die Extension macht: Sie erkennt, wenn ein Redakteur im Workspace-Kontext arbeitet, und zeigt einen Hinweis, dass VG-Wort-Aktionen auf dem aktuellen Live-Stand basieren. Texte, die noch im Draft sind, sollten erst nach dem Publish gemeldet werden — das liegt aber in der Verantwortung der Redaktion.
Die Marker-Middleware der Pro-Extension bleibt in allen Fällen aktiv — sie entfernt die HTML-Marker aus normalen Frontend-Antworten (damit Besucher sie nicht im Quelltext sehen) und sorgt dafür, dass interne Extraktions-Anfragen (?vgwort-markers=1) nicht gecacht werden (Cache-Control: private, no-store). Eine eingebaute Consent-Logik gibt es nicht — ob und wie du VG-Wort-Tracking datenschutzrechtlich absicherst, liegt in deiner Verantwortung als Site-Betreiber.
Ich möchte hier ehrlich sein, weil ich glaube, dass das langfristig mehr hilft als jede Verkaufsstrategie.
Die kostenlose Extension reicht, wenn du eine überschaubare Website mit einer Handvoll Seiten betreibst, die Zählpixel brauchen. Wenn du einmal im Jahr fünf oder zehn Texte manuell in T.O.M. meldest, ist das zumutbar. Nutz in dem Fall EXT:vgwort und spar dir die Lizenzkosten.
Pro lohnt sich, wenn einer oder mehrere dieser Punkte zutreffen:
Alle Pro-Features — Pixelbestellung, Textmeldung, Sync, Autorenvalidierung — laufen über die METIS REST API. Verlagskonten haben API-Zugriff standardmäßig. Bei persönlichen Konten (Urheber) ist das nicht automatisch so.
Als Urheber musst du in T.O.M. unter “Optionale Zusatzfunktionen“ (auch bekannt als „Verlagsfunktionen für Urheber“) erst API-Zugriff beantragen. Das ist kein automatischer Prozess: VG Wort prüft den Antrag, und die Aktivierung kann Zeit in Anspruch nehmen — oder wird nicht unmittelbar gewährt. Meine Empfehlung: Beantrage API-Zugriff, bevor du Pro installierst. Ohne aktiven API-Zugriff funktionieren die zentralen Pro-Features nicht.
Wenn du in T.O.M. deinen API-Schlüssel einrichtest, wirst du feststellen, dass die Beschreibung dort „WordPress“ erwähnt. Das ist irreführend — der API-Zugriff funktioniert mit jedem CMS, also selbstverständlich auch mit TYPO3.
Noch ein praktischer Hinweis: Urheber-Konten sind auf rund 4.000 Pixel pro Jahr begrenzt. Für einen Blog oder eine überschaubare Website ist das in der Regel kein Problem, aber bei sehr großen Textbeständen kann das relevant werden. Sobald der API-Zugriff aktiviert ist, nutzen beide Kontoarten dieselben API-Endpunkte — der Unterschied liegt nur in der Beantragung und den Kontingenten.
Wer einen kleinen Blog betreibt, keinen API-Zugriff hat oder den Antragsprozess scheut, ist mit der freien Extension gut bedient.
Wer bereits EXT:vgwort nutzt, kann nahtlos auf Pro upgraden. Da Pro die freie Extension erweitert und nicht ersetzt, bleiben alle bereits zugewiesenen Pixel und die Frontend-Integration bestehen. Du installierst die Pro-Extension, konfigurierst die API-Zugangsdaten in den Site Settings, und kannst sofort mit der Pool-Verwaltung und Textmeldung loslegen. Eine Migration bestehender Daten ist nicht nötig.
Die Lizenzierung von EXT:vgwort_pro wird in zwei Varianten verfügbar sein: eine Blogger-Lizenz und eine Verlags-Lizenz. Die genaue Aufteilung und die konkreten Preise werden gerade finalisiert — kontaktier uns, wenn du Interesse hast oder wissen möchtest, welche Variante für dich passt.
Die kostenlose Extension EXT:vgwort findest du bereits auf GitHub und über Composer. Eine Landingpage mit allen Details zu den Pro-Features und Lizenzoptionen findest du hier.
Wenn du Fragen zur VG-Wort-Integration in deinem TYPO3-Projekt hast — ob mit der freien oder der Pro-Extension — meld dich bei uns. Wir beraten gerne.
Du hast Fragen zur Integration von VG Wort in dein TYPO3-Projekt, egal ob mit der kostenlosen oder der Pro-Extension? Meld dich bei uns, wir helfen dir gern weiter.
