TYPO3: Open-Graph-Daten von jh_opengraphprotocol zu EXT:seo migrieren

Bei einigen TYPO3-Upgrades der letzten Jahre war die Extension jh_opengraphprotocol (öffnet in neuem Tab) für die Open-Graph-Tags im Einsatz. Die gibt es in der aktuellsten Version (1.3.2) aber nur bis TYPO3 8.7. Ist jedoch kein Problem, denn ab TYPO3 9 ist die SEO-Extension (öffnet in neuem Tab) im Core dabei – mit eigenen Feldern für Open Graph.

Hier eine kurze Anleitung, um die Daten aus der alten Extension in die Felder von EXT:seo zu übernehmen.

Inhalt	jh_opengraphprotocol	EXT:seo
og:title	tx_jhopengraphprotocol_ogtitle	og_title
og:description	tx_jhopengraphprotocol_ogdescription	og_description
og:image	tx_jhopengraphprotocol_ogfalimages	og_image
og:type	tx_jhopengraphprotocol_ogtype	– (kein Feld)

Vorbereitung

Migration per SQL

1) og:title – nur Seiten mit altem Titel, ohne bereits gepflegten EXT:seo-Titel:

UPDATE pages
SET og_title = tx_jhopengraphprotocol_ogtitle
WHERE tx_jhopengraphprotocol_ogtitle <> ''
  AND (og_title IS NULL OR og_title = '');

2) og:description – nach demselben Muster:

UPDATE pages
SET og_description = tx_jhopengraphprotocol_ogdescription
WHERE tx_jhopengraphprotocol_ogdescription <> ''
  AND (og_description IS NULL OR og_description = '');

3) og:image – hier sind zwei Tabellen beteiligt. Die Bilder selbst hängen als Referenzen in sys_file_reference, in pages steht nur deren Anzahl. Zuerst die Referenzen umbiegen – nur für Seiten, die in EXT:seo noch kein Bild haben:

UPDATE sys_file_reference r
JOIN pages p ON p.uid = r.uid_foreign
SET r.fieldname = 'og_image'
WHERE r.tablenames = 'pages'
  AND r.fieldname = 'tx_jhopengraphprotocol_ogfalimages'
  AND p.og_image = 0;

Danach die Anzahl in pages übernehmen:

UPDATE pages
SET og_image = tx_jhopengraphprotocol_ogfalimages
WHERE tx_jhopengraphprotocol_ogfalimages > 0
  AND og_image = 0;

Die Reihenfolge ist wichtig: Erst die Referenzen, dann die Anzahl – sonst greift die Bedingung og_image = 0 beim ersten Statement nicht mehr.

Die Extension hat außerdem noch das ältere Feld tx_jhopengraphprotocol_ogimage, in dem Bilder als Dateipfad statt als FAL-Referenz gespeichert sind. Das migriere ich nicht automatisch – solche Bilder lieber im Backend neu zuweisen.

Aufräumen

Wenn die Open-Graph-Daten im Backend unter Seiteneigenschaften → Social Media passen:

Für den og:type gibt es in der Core-Extension allerdings kein Feld. Dafür bringt EXT:seo zusätzlich eigene Felder für Twitter/X mit (twitter_title, twitter_description, twitter_image, twitter_card) – die alte Extension hatte so etwas nicht.