包简介

Magento 2 JSON-LD Rich Data for AI Engine Optimization. Injects spec-compliant Product, Organization, BreadcrumbList, FAQPage, and WebSite schema. Fixes the 'Product schema — JSON-LD structured data' signal in angeo/module-aeo-audit.

README 文档

README

Fixes the "Product schema — JSON-LD structured data" signal in angeo/module-aeo-audit. Injects spec-compliant JSON-LD on product pages, CMS pages, and homepage.

What this module fixes

AEO Audit signal	Before	After
Product schema — JSON-LD structured data	FAIL / WARN	PASS
FAQPage schema — AI answer eligibility	WARN	PASS (on FAQ CMS pages)
Merchant policies — return & shipping schema	FAIL	PASS (when enabled & configured)
Product schema — AggregateRating	WARN	PASS (when reviews exist)
JSON-LD quality — BreadcrumbList	WARN	PASS (now rendered on product pages)

Schema types injected

Schema	Pages	Key fields
`Product`	All product pages	name, description, image, sku, gtin/mpn, offers.price, offers.priceCurrency, offers.availability, offers.hasMerchantReturnPolicy, offers.shippingDetails, aggregateRating
`Organization`	All pages	name, url, logo, sameAs, contactPoint
`WebSite`	Homepage only	name, url, potentialAction/SearchAction
`BreadcrumbList`	Product pages	category path
`FAQPage`	CMS pages with FAQ content	auto-detected Q&A pairs

Installation

composer require angeo/module-rich-data
bin/magento setup:upgrade
bin/magento cache:flush

Configuration

Stores → Configuration → Angeo → Rich Data (JSON-LD)

Product schema

Enable/disable
Include AggregateRating (from Magento reviews)
Include BreadcrumbList
Include SKU
Include Brand (configurable attribute)
Include GTIN / MPN (configurable attributes)
Item condition (New/Used/Refurbished)
In-stock / out-of-stock availability URLs

Merchant policies (return & shipping)

Injects offers.hasMerchantReturnPolicy and offers.shippingDetails — required by Google & ChatGPT Shopping since Jan 2026. Disabled by default; enable and fill in your real values.

Return policy: enable, return window (days), applicable country, return fee
Shipping details: enable, flat shipping rate, destination country, handling time (min/max days), transit time (min/max days)

Organization schema

Organization name (default: store name)
Logo URL
sameAs social URLs (comma-separated)
Contact telephone + type

WebSite schema

Enable/disable
Include SearchAction (Sitelinks Searchbox)

FAQPage schema

Enable/disable — auto-detected from CMS page content

FAQ page markup (recommended)

Add data-faq-question / data-faq-answer attributes to your CMS FAQ page for explicit Q&A detection:

<div data-faq-question="What is your return policy?"
     data-faq-answer="We offer 30-day returns on all items in original condition.">
</div>

Without these attributes the module uses heuristic detection: <h2>/<h3> followed by <p> are treated as question/answer pairs.

Extending with custom schemas

Implement Angeo\RichData\Api\Data\SchemaInterface and register via di.xml:

<type name="Angeo\RichData\Model\JsonLd\Renderer\SchemaRenderer">
    <arguments>
        <argument name="builders" xsi:type="array">
            <item name="my_schema" xsi:type="object">Vendor\Module\Model\JsonLd\Builder\MySchemaBuilder</item>
        </argument>
    </arguments>
</type>

CLI validation

# Validate on random product
bin/magento angeo:rich-data:validate --store=en_us

# Validate specific product on specific store
bin/magento angeo:rich-data:validate --store=en_us --product-id=42

Output example:

Validating JSON-LD for: [42] Alpine Hiking Jacket
  Store:   default
  URL:     https://mystore.com/alpine-jacket

Found 3 JSON-LD block(s):
  Block 1: @type:Organization — valid JSON ✓
  Block 2: @type:Product — valid JSON ✓
    PASS aggregateRating present
  Block 3: @type:BreadcrumbList — valid JSON ✓

All JSON-LD blocks are valid.

The Angeo AI Suite

Module	Purpose
`angeo/module-aeo-audit`	AEO audit — detects missing schema
`angeo/module-rich-data`	This module — fixes missing schema
`angeo/module-llms-txt`	Generates `/llms.txt`
`angeo/module-openai-product-feed-api`	ACP REST API for ChatGPT Shopping

License

MIT — see LICENSE

angeo/module-rich-data 适用场景与选型建议

angeo/module-rich-data 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 11 次下载、GitHub Stars 达 5，最近一次更新时间为 2026 年 04 月 18 日，在 PHP 生态内属于活跃度较高的组件。

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

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

围绕 angeo/module-rich-data 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

与 angeo/module-rich-data 相关的其它包

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

etws/magento-language-ru_ru 0

Russian Language Pack for Magento 2

dpdbenelux/magento2-shipping 12

DPD Magento2 Shipping extension

secit-pl/schema-org 4

Schema.org classes.

webnuvola/laravel-json-ld 5

Laravel wrapper for torann/json-ld

bramdeleeuw/silverstripe-schema 10

Add schema to a Silverstripe page

sweetrdf/json-ld 3

JSON-LD Processor for PHP

angeo/module-rich-data

包简介

关键字：