包简介

Food recipes extension of plugin tx_news for TYPO3 CMS

README 文档

README

Adds a Recipe record type to georgringer/news. A recipe is a news item with the type Recipe that carries ingredient sections, instruction sections, nutrition information, and free-text fallback fields. The extension also emits schema.org Recipe JSON-LD structured data so search engines can render rich results.

Features

New Recipe record type for tx_news — adds the recipe palette to existing news with type = 3
Ingredient sections with title, ingredient list, and optional bodytext
Instruction sections with title and ordered instruction steps
Free-text fallback ingredient text and instruction text (RTE)
Nutrition info — yield, calories, proteins, carbs, fats, fiber
Automatic JSON-LD (Recipe schema.org structured data) via a Fluid ViewHelper — emits HowToStep for single-section recipes and HowToSection for multi-section recipes
Drop-in Recipe Detail partial that renders every recipe field
Configurable author for the JSON-LD payload via the TYPO3 extension configuration
Multilingual labels (EN, CS out of the box)
TYPO3 13 and 14 compatible

Examples

www.mlsnej.cz

Requirements

PHP 8.3+
TYPO3 13.4 or 14.3+
georgringer/news ^14.0

Installation

composer require marekskopal/typo3-recipe

After installation, run the database analyser in the TYPO3 Install Tool to create the required tables.

Setup

Include the TypoScript Set Recipe in your site package or via the site configuration sets. The Set wires the Recipe domain model as a tx_news subclass and exposes the partial path under plugin.tx_news.view.partialRootPaths.

Backend Setup

Create or edit a news record on a page where the News content element is placed. Switch the Type to Recipe and fill in the recipe palette:

Ingredient sections — inline children with title, ingredient list, and optional bodytext
Ingredient text — RTE fallback shown after ingredient sections
Instruction sections — inline children with title and ordered instructions
Instruction text — RTE fallback shown after instruction sections
Yield — e.g. 4 servings (used as recipeYield)
Calories / Proteins / Carbs / Fats / Fiber — nutrition values (integers; calories drive the JSON-LD NutritionInformation block)

Rendering the recipe

The extension ships Resources/Private/Partials/Recipe/Detail.html and registers its path on plugin.tx_news.view.partialRootPaths. Render it from your tx_news Detail template:

<f:if condition="{newsItem.type} == 3">
    <f:render partial="Recipe/Detail" arguments="{recipe: newsItem}" />
</f:if>

The partial renders ingredient sections, instruction sections, nutrition table, optional RTE fallbacks, and emits the JSON-LD block using the ViewHelper below.

JSON-LD ViewHelper

The Fluid ViewHelper <r:structuredData recipe="{recipe}" /> outputs a <script type="application/ld+json"> block with schema.org Recipe structured data. Register the namespace at the top of a template:

<html xmlns:r="http://typo3.org/ns/MarekSkopal/MsRecipe/ViewHelpers" data-namespace-typo3-fluid="true">

The structured data includes name, image, author, datePublished, description, keywords, recipeYield, nutrition, recipeIngredient, and recipeInstructions (using HowToStep for a single instruction section, or HowToSection when multiple sections exist).

Author Configuration

Configure the author block of the JSON-LD payload in the extension configuration (Admin Tools → Settings → Extension Configuration → ms_recipe):

Key	Description
`authorName`	Author name. Empty value omits the `author` field from the JSON-LD output.
`authorUrl`	Optional author URL — written as `author.url` when set.

Customization

Templates

Override the bundled partial by adding your own path with a higher index:

plugin.tx_news.view.partialRootPaths.500 = EXT:your_extension/Resources/Private/Partials/

Then provide a Recipe/Detail.html in that directory.

Styling

The bundled partial renders semantic markup (<ul> for ingredients, <ol> for instructions) without bundled CSS. Style the .recipe, .recipe-ingredients, .recipe-instructions, and .recipe-nutrition wrappers from your own site CSS.

License

GPL-2.0-or-later

marekskopal/typo3-recipe 适用场景与选型建议

marekskopal/typo3-recipe 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 33 次下载、GitHub Stars 达 0，最近一次更新时间为 2022 年 12 月 29 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「typo3」「recipes」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 marekskopal/typo3-recipe 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 marekskopal/typo3-recipe 我们能提供哪些服务？

定制开发 / 二次开发

基于 marekskopal/typo3-recipe 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 marekskopal/typo3-recipe 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

cmsexperts/link2language 17

Set Links with a specific language parameter

blueways/deployer-recipes 0

blueways deployer recipes

t3brightside/gallerycontent 0

TYPO3 CMS extension to create gallery content element with preset crop ratios and pagination

drupal/varbase_workflow_base 0

A recipe to manage advanced editorial and publishing workflow with content moderation. Build on top of the basic Workflow integration in Drupal CMS.

drupal/varbase_seo_base 0

A recipe to manage default installed modules, configs and permissions for Varbase Search Engine Optimization (SEO) Core features and settings.

macopedia/typo3-interactive-tour 13

An interactive tour through the TYPO3 backend.

marekskopal/typo3-recipe

包简介

关键字：