Plugin przepisów dla TYPO3

Przepisy bez Schema.org-Markup tracą najcenniejsze pozycje w wynikach wyszukiwania Google

Zapytania o przepisy należą do nielicznych obszarów, w których Google wyświetla Rich Snippets ze zdjęciem, oceną, czasem gotowania i kalorycznością. Witryny bez prawidłowego markup Schema.org/Recipe pojawiają się jako zwykłe niebieskie linki pod dominującymi wizualnie wynikami Rich Results. Rozszerzenie Recipe dla TYPO3 strukturyzuje przepisy ze wszystkimi polami, których Google oczekuje dla Rich Snippets: składniki, kroki przygotowania, wartości odżywcze, porcje, czas przygotowania, poziom trudności. Markup Schema.org generowany jest automatycznie w formacie JSON-LD, bez konieczności edycji HTML przez redaktorów.

Dla blogów kulinarnych, wydawnictw z rubrykami przepisów oraz producentów żywności z bazami przepisów to różnica między widocznością a niewidocznością w wyszukiwarce Google.

Typowe scenariusze obejmują blogi kulinarne, witryny produktowe i portale zdrowotne

Najczęstszym scenariuszem jest blog kulinarny lub magazyn online z rubryką przepisów. Wydawca publikuje co tydzień pięć nowych przepisów. Każdy przepis tworzony jest w backendzie TYPO3 jako ustrukturyzowany rekord: tytuł, opis, lista składników z ilościami, kroki przygotowania jako numerowana lista, czasy (przygotowanie, gotowanie, łącznie), wartości odżywcze na porcję i zdjęcie tytułowe. Rozszerzenie generuje z tego stronę szczegółową z poprawnym markupem Schema.org. Google pokazuje w wynikach wyszukiwania zdjęcie, ocenę gwiazdkową, czas łączny i liczbę kalorii.

Drugim scenariuszem są witryny produktowe producentów żywności. Producent oliwy z oliwek pokazuje przy każdym produkcie pasujące przepisy. Przepisy linkują do produktu, produkt linkuje do przepisów. To dwukierunkowe powiązanie wzmacnia zarówno stronę produktu, jak i stronę przepisu w ocenie Google.

Trzeci scenariusz: portale zdrowotne i poradnie dietetyczne. Tutaj na pierwszy plan wysuwają się wartości odżywcze. Portal dla diabetyków pokazuje przepisy z wymiennikami węglowodanowymi, indeksem glikemicznym i zawartością węglowodanów na porcję. Rozszerzenie umożliwia Custom Fields, dzięki czemu te istotne medycznie wartości można rejestrować jako dane strukturalne i prominentnie wyświetlać we frontendzie.

Architektura techniczna wykorzystuje rekordy Extbase z automatycznym wyjściem JSON-LD

Rozszerzenie rejestruje własny typ rekordu dla przepisów w bazie TYPO3. Każdy rekord zawiera pola dla tytułu, opisu, składników (jako Inline-Relational-Records), kroków (jako sortowalna lista), czasów (prepTime, cookTime, totalTime w formacie ISO-8601), wartości odżywczych (kalorie, tłuszcz, węglowodany, białko) i obrazów przez FAL.

Renderowanie frontendowe odbywa się przez szablony Fluid, które prezentują przepis jako stronę HTML, jednocześnie wpisując znacznik script JSON-LD z markupem Schema.org/Recipe do nagłówka strony. Markup zgodny jest ze specyfikacją Google: name, image, author, datePublished, description, prepTime, cookTime, totalTime, recipeYield, recipeIngredient, recipeInstructions oraz nutrition.

Widok listy pokazuje przepisy jako kafelki ze zdjęciem, tytułem, czasem łącznym i oceną. Filtry według kategorii (przystawka, danie główne, deser), sposobu odżywiania (wegetariańskie, wegańskie, bezglutenowe) i czasu przygotowania można konfigurować przez TypoScript.

Częste problemy dotyczą brakujących pól obowiązkowych i nieprawidłowych formatów czasu

Największym problemem dla wyświetlania Rich Snippet są brakujące pola obowiązkowe. Google wymaga przynajmniej name, image i recipeInstructions. Gdy redaktor utworzy przepis bez zdjęcia lub bez kroków przygotowania, markup Schema.org wprawdzie zostaje wygenerowany, ale Google go ignoruje i nie wyświetla Rich Snippet. Rozwiązanie: w backendzie TYPO3 włączyć walidację pól obowiązkowych, tak aby przepisów bez zdjęcia i bez przynajmniej jednego kroku przygotowania nie dało się zapisać.

Drugi problem: nieprawidłowe formaty czasu. Schema.org oczekuje ISO-8601 Duration (PT30M dla 30 minut, PT1H15M dla 1 godziny i 15 minut). Jeśli rozszerzenie nie konwertuje wpisu redaktora “30 min” poprawnie na PT30M, walidacja w Google Rich Results Test się nie powiedzie. Większość rozszerzeń Recipe oferuje w tym celu osobne pola wprowadzania dla godzin i minut, które wewnętrznie są konwertowane do ISO-8601.

Trzeci temat: duplicate content przy przepisach osadzanych na wielu stronach. Gdy ten sam przepis jest w pełni wyświetlany na stronie kategorii i na stronie szczegółowej, powstają dwie strony z identycznym markupem Schema.org. Google ocenia to jako duplikat. Rozwiązanie: na stronach kategorii pokazywać tylko zajawki i pełny markup Schema.org generować wyłącznie na stronie szczegółowej.

Rozszerzenie działa pod TYPO3 v11 i v12, dla v13 konieczna jest aktualizacja Extbase

Rozszerzenia Recipe w ekosystemie TYPO3 utrzymywane są przez różnych dostawców. Kompatybilność z TYPO3 v12 jest zapewniona przy aktywnie rozwijanych rozszerzeniach. Dla TYPO3 v13 zazwyczaj konieczne są dostosowania w konfiguracji modeli Extbase i definicjach TCA, ponieważ v13 usunął niektóre przestarzałe typy TCA. Gosign zaleca, by przy witrynach kulinarnych po każdej aktualizacji TYPO3 walidować wyjście Schema.org za pomocą Google Rich Results Test, aby zapewnić utrzymanie jakości markupu.