Plugin de receitas para TYPO3

Rezepte ohne Schema.org-Markup verschenken die wertvollsten Positionen in den Google-Suchergebnissen

Rezept-Suchanfragen gehören zu den wenigen Bereichen, in denen Google Rich Snippets mit Bild, Bewertung, Kochzeit und Kalorien anzeigt. Websites ohne korrektes Schema.org-Recipe-Markup erscheinen als einfacher blauer Link unter den visuell dominanten Rich Results. Die TYPO3 Recipe-Extension strukturiert Rezepte mit allen Feldern, die Google für Rich Snippets erwartet: Zutaten, Zubereitungsschritte, Nährwerte, Portionen, Zubereitungszeit, Schwierigkeitsgrad. Das Schema.org-Markup wird automatisch im JSON-LD-Format ausgegeben, ohne dass Redakteure HTML bearbeiten müssen.

Für Food-Blogs, Verlage mit Rezeptrubriken und Lebensmittelhersteller mit Rezeptdatenbanken ist das der Unterschied zwischen Sichtbarkeit und Unsichtbarkeit in der Google-Suche.

Cenários típicos de uso abrangem Food-Blogs, Produktwebsites und Gesundheitsportale

Das häufigste Szenario ist der Food-Blog oder das Online-Magazin mit Rezeptrubrik. Ein Verlag publiziert wöchentlich fünf neue Rezepte. Jedes Rezept wird im TYPO3-Backend als strukturierter Datensatz angelegt: Titel, Beschreibung, Zutatenliste mit Mengenangaben, Zubereitungsschritte als nummerierte Liste, Zeitangaben (Vorbereitung, Kochzeit, Gesamtzeit), Nährwerte pro Portion und ein Titelbild. Die Extension generiert daraus eine Detailseite mit korrektem Schema.org-Markup. Google zeigt in den Suchergebnissen das Bild, die Sterne-Bewertung, die Gesamtzeit und die Kalorienzahl.

Ein zweites Szenario sind Produktwebsites von Lebensmittelherstellern. Ein Olivenöl-Produzent zeigt zu jedem Produkt passende Rezepte. Die Rezepte verlinken auf das Produkt, das Produkt verlinkt auf die Rezepte. Diese bidirektionale Verknüpfung stärkt sowohl die Produktseite als auch die Rezeptseite in der Google-Bewertung.

Drittes Szenario: Gesundheitsportale und Ernährungsberatungen. Hier stehen die Nährwertangaben im Vordergrund. Ein Diabetes-Portal zeigt Rezepte mit Broteinheiten, glykämischem Index und Kohlenhydraten pro Portion. Die Extension erlaubt Custom Fields, sodass diese medizinisch relevanten Werte als strukturierte Daten erfasst und im Frontend prominent angezeigt werden.

Arquitetura técnica nutzt Extbase-Records mit automatischem JSON-LD-Output

Die Extension registriert einen eigenen Record-Typ für Rezepte in der TYPO3-Datenbank. Jeder Record enthält Felder für Titel, Beschreibung, Zutaten (als Inline-Relational-Records), Schritte (als sortierbare Liste), Zeiten (prepTime, cookTime, totalTime im ISO-8601-Format), Nährwerte (Kalorien, Fett, Kohlenhydrate, Protein) und Bilder über FAL.

Das Frontend-Rendering läuft über Fluid-Templates, die das Rezept als HTML-Seite darstellen und gleichzeitig ein JSON-LD-Script-Tag mit dem Schema.org/Recipe-Markup in den Head der Seite schreiben. Das Markup folgt der Google-Spezifikation: name, image, author, datePublished, description, prepTime, cookTime, totalTime, recipeYield, recipeIngredient, recipeInstructions und nutrition.

Die Listenansicht zeigt Rezepte als Kacheln mit Bild, Titel, Gesamtzeit und Bewertung. Filter nach Kategorie (Vorspeise, Hauptgericht, Dessert), Diätform (vegetarisch, vegan, glutenfrei) und Zubereitungszeit sind über TypoScript konfigurierbar.

Problemas frequentes betreffen fehlende Pflichtfelder und ungültige Zeitformate

Das grösste Problem für die Rich-Snippet-Darstellung sind fehlende Pflichtfelder. Google verlangt mindestens name, image und recipeInstructions. Wenn ein Redakteur ein Rezept ohne Bild oder ohne Zubereitungsschritte anlegt, wird das Schema.org-Markup zwar ausgegeben, aber Google ignoriert es und zeigt keinen Rich Snippet. A solução: Im TYPO3-Backend Pflichtfeld-Validierung aktivieren, sodass Rezepte ohne Bild und ohne mindestens einen Zubereitungsschritt nicht gespeichert werden können.

Zweites Problem: Ungültige Zeitformate. Schema.org erwartet ISO-8601-Duration (PT30M für 30 Minuten, PT1H15M für 1 Stunde 15 Minuten). Wenn die Extension die Redakteur-Eingabe “30 min” nicht korrekt in PT30M umwandelt, scheitert die Validierung im Google Rich Results Test. Die meisten Recipe-Extensions bieten dafür separate Eingabefelder für Stunden und Minuten, die intern in ISO-8601 konvertiert werden.

Drittes Thema: Duplicate Content bei Rezepten, die auf mehreren Seiten eingebettet sind. Wenn dasselbe Rezept auf der Kategorieseite und der Detailseite vollständig angezeigt wird, erzeugt das zwei Seiten mit identischem Schema.org-Markup. Google wertet das als Duplicate. A solução: Auf Kategorieseiten nur Teaser zeigen und das vollständige Schema.org-Markup ausschliesslich auf der Detailseite ausgeben.

Die Extension läuft unter TYPO3 v11 und v12, für v13 ist ein Extbase-Update nötig

Recipe-Extensions im TYPO3-Ökosystem werden von verschiedenen Anbietern gepflegt. Die Kompatibilität mit TYPO3 v12 ist bei aktiv gewarteten Extensions gegeben. Für TYPO3 v13 sind typischerweise Anpassungen an der Extbase-Model-Konfiguration und den TCA-Definitionen nötig, weil v13 einige veraltete TCA-Typen entfernt hat. A Gosign recomenda bei Rezept-Websites, die Schema.org-Ausgabe nach jedem TYPO3-Update mit dem Google Rich Results Test zu validieren, um sicherzustellen, dass die Markup-Qualität erhalten bleibt.