Plugin de receitas para TYPO3

Receitas sem marcação Schema.org desperdiçam as posições mais valiosas nos resultados do Google

Buscas por receitas estão entre os poucos temas em que o Google exibe rich snippets com foto, avaliação, tempo de preparo e calorias. Sites sem a marcação Schema.org Recipe correta aparecem como um simples link azul, abaixo dos rich results, que dominam visualmente a página. A extensão de receitas para TYPO3 estrutura cada receita com todos os campos que o Google espera para os rich snippets: ingredientes, modo de preparo, valores nutricionais, porções, tempo de preparo e grau de dificuldade. A marcação Schema.org sai automaticamente em formato JSON-LD, sem que os redatores precisem mexer em HTML.

Para blogs de culinária, editoras com seções de receitas e fabricantes de alimentos com bancos de receitas, essa é a diferença entre aparecer ou sumir na busca do Google.

Os cenários típicos incluem blogs de culinária, sites de produtos e portais de saúde

O cenário mais comum é o blog de culinária ou a revista online com seção de receitas. Uma editora publica cinco receitas novas por semana. Cada receita é criada no backend do TYPO3 como registro estruturado: título, descrição, lista de ingredientes com quantidades, modo de preparo em lista numerada, tempos (pré-preparo, cozimento, tempo total), valores nutricionais por porção e uma imagem principal. A partir disso, a extensão gera uma página de detalhe com marcação Schema.org correta. Nos resultados de busca, o Google mostra a foto, a avaliação em estrelas, o tempo total e as calorias.

Um segundo cenário são os sites de produtos de fabricantes de alimentos. Um produtor de azeite mostra receitas adequadas a cada produto. As receitas levam ao produto, e o produto leva às receitas. Essa ligação nos dois sentidos fortalece tanto a página do produto quanto a página da receita na avaliação do Google.

Terceiro cenário: portais de saúde e consultórios de nutrição. Aqui, os valores nutricionais são o foco. Um portal sobre diabetes mostra receitas com porções de carboidrato para a contagem de carboidratos, índice glicêmico e gramas de carboidrato por porção. A extensão permite campos customizados, para que esses valores clinicamente relevantes sejam registrados como dados estruturados e exibidos com destaque no frontend.

A arquitetura técnica usa registros Extbase com saída automática em JSON-LD

A extensão registra um tipo de registro próprio para receitas no banco de dados do TYPO3. Cada registro tem campos para título, descrição, ingredientes (como Inline Relational Records), etapas (como lista ordenável), tempos (prepTime, cookTime, totalTime no formato ISO 8601), valores nutricionais (calorias, gorduras, carboidratos, proteínas) e imagens via FAL.

A renderização no frontend é feita por templates Fluid, que exibem a receita como página HTML e, ao mesmo tempo, gravam no head da página uma tag script JSON-LD com a marcação Schema.org/Recipe. A marcação segue a especificação do Google: name, image, author, datePublished, description, prepTime, cookTime, totalTime, recipeYield, recipeIngredient, recipeInstructions e nutrition.

A visualização em lista mostra as receitas como cards com foto, título, tempo total e avaliação. Filtros por categoria (entrada, prato principal, sobremesa), tipo de dieta (vegetariana, vegana, sem glúten) e tempo de preparo podem ser configurados via TypoScript.

Os problemas frequentes envolvem campos obrigatórios ausentes e formatos de tempo inválidos

O maior problema para a exibição em rich snippet são campos obrigatórios ausentes. O Google exige no mínimo name e image e recomenda também recipeInstructions. Se um redator cria uma receita sem foto, a marcação Schema.org até é gerada, mas o Google não exibe rich snippet. A solução: ativar a validação de campos obrigatórios no backend do TYPO3, de modo que receitas sem foto e sem pelo menos uma etapa de preparo não possam ser salvas.

Segundo problema: formatos de tempo inválidos. O Schema.org espera durações no padrão ISO 8601 (PT30M para 30 minutos, PT1H15M para 1 hora e 15 minutos). Se a extensão não converte corretamente a entrada “30 min” do redator em PT30M, a validação no Rich Results Test do Google falha. Quase todas as extensões de receitas oferecem, para isso, campos separados para horas e minutos, convertidos internamente para ISO 8601.

Terceiro tema: conteúdo duplicado em receitas incorporadas em várias páginas. Se a mesma receita aparece completa na página da categoria e na página de detalhe, surgem duas páginas com marcação Schema.org idêntica. O Google considera isso conteúdo duplicado. A solução: nas páginas de categoria, mostrar apenas teasers e gerar a marcação Schema.org completa exclusivamente na página de detalhe.

A extensão roda no TYPO3 v11 e v12, e o v13 exige uma atualização do Extbase

Extensões de receitas no ecossistema TYPO3 são mantidas por diferentes fornecedores. Nas extensões com manutenção ativa, a compatibilidade com o TYPO3 v12 está garantida. Para o TYPO3 v13, costumam ser necessários ajustes na configuração dos models Extbase e nas definições de TCA, porque o v13 removeu alguns tipos de TCA obsoletos. Em sites de receitas, a Gosign recomenda validar a saída Schema.org com o Rich Results Test do Google após cada atualização do TYPO3, para garantir que a qualidade da marcação se mantenha.