Title: Polski for WooCommerce
Author: Mariusz Szatkowski
Published: 2026 年 5 月 29 日
Last modified: 2026 年 6 月 2 日
---
搜索插件
# Polski for WooCommerce
作者：[Mariusz Szatkowski](https://profiles.wordpress.org/motylanogha/)
[下载](https://downloads.wordpress.org/plugin/polski.1.22.2.zip)
* [详情](https://cn.wordpress.org/plugins/polski/#description)
* [评价](https://cn.wordpress.org/plugins/polski/#reviews)
* [安装](https://cn.wordpress.org/plugins/polski/#installation)
* [开发进展](https://cn.wordpress.org/plugins/polski/#developers)
[支持](https://wordpress.org/support/plugin/polski/)
## 描述
**Polski for WooCommerce** 是一款面向波兰商店的免费 WooCommerce 插件。它有助于处理
GPSR 产品安全信息、Omnibus 30 天最低价格历史记录、GDPR 同意、撤回表单、单位价格、
支持 KSeF 的开票钩子、DSA 报告和店面模块。
本插件专为波兰在线商店、代发货商和代理机构打造，将最常见的波兰和欧盟要求集中于一
处，并让您按需开启或关闭每个模块。
本插件可帮助您配置与波兰和欧盟市场惯例相关的商店工作流程。它不提供法律建议，也不
保证合规性。请始终针对您自己的业务、产品和义务审查您的设置。
#### 文档和实用链接
* **文档** – https://polski.wppoland.com/
* **插件页面（波兰文）** – https://wppoland.com/pl/polski/
* **插件页面（英文）** – https://wppoland.com/en/polski/
* **源代码（GitHub）** – https://github.com/wppoland/polski
* **报告问题或请求功能** – https://github.com/wppoland/polski/issues
* **讨论想法和问题** – https://github.com/wppoland/polski/discussions
#### 为什么选择 Polski for WooCommerce？
* **丰富的模块集** – 在一个插件中集成 GPSR 相关产品字段、Omnibus 价格历史、同意
复选框、撤回申请、产品数据和店面模块
* **专为波兰商店打造** – 专注于在波兰销售的 WooCommerce 配置
* **免费且开源** – 包含核心产品、结账和店面工具
* **现代化代码库** – PHP 8.1+、React 管理面板、REST API、WP-CLI 支持
* **区块就绪** – 完全兼容 WooCommerce 区块的结账和购物车
* **HPOS 兼容** – 兼容 WooCommerce 高性能订单存储
#### 最近新增的工具
* **商店健康监测** – 被动后台监测前端致命错误、结账失败率和销售异常，提供电子邮件
和 webhook 警报以及状态仪表盘
* **GPSR 相关产品字段** – 制造商、进口商、欧盟负责人、产品标识符、安全警告和说明，
支持批量 CSV 导入或导出
* **撤回申请流程** – 我的账户中的撤回操作，带确认页面、申请记录、电子邮件确认和
审计记录
* **DSA 举报工具** – 联系点设置、通过短代码 [polski_dsa_report] 提供的违法内容举
报表单、管理员举报管理页面以及电子邮件通知
* **KSeF 集成挂钩** – 基于 NIP 的订单标记、用于发票插件集成的操作挂钩，以及订单
列表状态列
* **安全事件** – 针对漏洞、数据泄露、支付失败、第三方中断和内部跟进的事件日志，
支持 CSV 导出
* **产品可持续性字段** – 环保声明依据、证书链接和到期日期字段
* **已验证购买徽章** – 在真正购买过产品的客户的产品评论上显示绿色徽章
#### 结账和同意
* **同意复选框** – 在结账、注册和评论时可配置的同意复选框，并附带完整的审计记录
* **Omnibus 价格历史** – 在促销产品上自动显示 30 天最低价格
* **撤回权** – 带电子邮件确认的撤回和退货申请流程
* **双重确认** – 客户注册的电子邮件验证（GDPR 最佳实践）
* **商店页面** – 将条款、隐私政策和撤回内容附加到 WooCommerce 电子邮件中
* **争议解决** – 在您的版本说明/条款页面上显示 ODR 平台通知
* **同意审计记录** – 记录客户同意情况，包含时间戳、IP 和上下文
#### 产品展示（Shopmarks）
* **单位价格** – 显示每千克、每升、每米或任意自定义单位的价格
* **交付时间** – 在产品页面和列表中显示预计交付时间
* **税务通知** – 显示含税/不含税价格信息及增值税税率
* **价格显示** – 自定义价格在整个商店中的显示方式
#### 店面功能
* **心愿单** – 保存喜爱的产品以备日后查看
* **产品比较** – 并排对比产品
* **等候名单** – 补货后的电子邮件通知
* **快速查看** – 从列表中以灯箱形式预览产品
* **图库缩放** – 增强的产品图片缩放功能
* **精选视频** – 在产品页面上展示产品视频
* **产品滑块** – 以轮播形式展示产品集合
* **无限滚动** – 在归档页面上自动加载更多产品
* **产品选项卡管理器** – 自定义产品页面的选项卡
* **AJAX 产品筛选器** – 无需刷新页面即可动态筛选产品
* **AJAX 搜索** – 实时产品搜索
* **产品徽章** – 促销、新品、推荐和自定义徽章
* **促销弹窗** – 定向弹窗营销活动
#### 食品和杂货
* **食品产品信息** – 配料、营养成分和过敏原声明
* **可选的食品标签字段** – 在需要的地方配置产地、经销商、酒精和营养信息显示
#### 管理员和开发者工具
* **现代化 React 管理面板** – 模块管理，每个模块都有独立的设置页面
* **REST API** – 用于设置、复选框、法律页面、撤回和搜索的完整 API
* **WP-CLI 命令** – 通过命令行管理 Polski
* **CSV 导入/导出** – 批量管理产品数据，包括 GPSR 和环保声明字段
* **短代码** – 嵌入通知、撤回表单、GPSR 信息、DSA 举报表单等
* **数据库迁移** – 安全的、带版本控制的架构更新
* **集成挂钩** – KSeF 操作挂钩、过滤器，以及与热门插件的兼容性
* **扩展的审计范围** – 涵盖 DPA 登记册、DSA、KSeF 就绪、反漂绿、已验证评论和安全
事件
* **事件记录** – 记录店铺端的安全事件并导出，以供内部审查
### 快速入门
请按照以下步骤为波兰商店配置插件。请务必就您的具体情况咨询合格的律师：
1. **验证法律页面**：前往 **Polski > Modules**，确保 **Legal Pages** 已激活。进入其
设置，选择您的条款、隐私政策和撤回页面。
2. **配置复选框**：前往 **Polski > Modules > Legal Checkboxes**（确保其已激活），并
启用结账所需的复选框（条款、隐私、撤回）。
3. **设置增值税税率**：请确保在 **WooCommerce > Settings > Tax** 中配置了正确的波兰
增值税税率（23%、8%、5%、0%）。
4. **单位价格**：对于按重量或体积销售的产品，请在产品编辑器的 **Polski** 选项卡中输入
单位定价数据。
5. **Omnibus**：一旦产品开始促销，本插件会追踪过去 30 天内的最低价格。请检查输出结果，
并在 **Polski > Modules > Omnibus** 中调整显示方式。
6. **GPSR**：如果您销售实物商品，请在产品的 **Polski** 选项卡中填写制造商和负责人详细
信息，并检查哪些信息应显示在产品页面上。
### 配置
本插件采用模块化设计。您可以根据需要启用或禁用功能：
* **产品信息**：GPSR 字段、单位价格、交付时间和食品数据。
* **结账与同意**：同意复选框、撤回流程和法律页面工具。
* **店面**：心愿单、比较、搜索、筛选和徽章。
每个具有配置选项的已启用模块都会作为 **Polski** 下的子菜单出现，或在模块页面上提供“
设置”链接。
### 外部服务
#### GUS REGON API（波兰中央统计局）
当启用 NIP 查询模块时，本插件会连接到 GUS REGON 公共登记处，根据用户输入的 NIP（
税号）检索公司数据。仅当用户明确触发查询时才会建立此连接。
* 发送的数据：NIP 号码
* 服务网址：[https://wyszukiwarkaregon.stat.gov.pl/](https://wyszukiwarkaregon.stat.gov.pl/)
* 服务条款：[https://api.stat.gov.pl/Home/RegulaminBIR](https://api.stat.gov.pl/Home/RegulaminBIR)
* 服务隐私政策：[https://bip.stat.gov.pl/](https://bip.stat.gov.pl/)
#### Google OAuth
当启用社交登录模块并配置了 Google 登录时，点击**使用 Google 继续**的客户会被重定向
到 Google 进行身份验证。插件会用授权码换取访问令牌并获取个人资料数据，以便客户登录
或创建账户。
* 发送的数据：重定向 URI、客户端 ID、授权码和用于获取个人资料的访问令牌
* 接收的数据：Google 账户 ID、电子邮件地址、全名、名字和姓氏
* 服务网址：[https://accounts.google.com/](https://accounts.google.com/)
* 服务条款：[https://policies.google.com/terms](https://policies.google.com/terms)
* 服务隐私政策：[https://policies.google.com/privacy](https://policies.google.com/privacy)
#### Facebook OAuth
当启用社交登录模块并配置了 Facebook 登录时，点击**使用 Facebook 继续**的客户会被
重定向到 Facebook 进行身份验证。插件会用授权码换取访问令牌并获取个人资料数据，以便
客户登录或创建账户。
* 发送的数据：重定向 URI、应用 ID、授权码和用于获取个人资料的访问令牌
* 接收的数据：Facebook 账户 ID、电子邮件地址、全名、名字和姓氏
* 服务网址：[https://www.facebook.com/](https://www.facebook.com/)
* 服务条款：[https://www.facebook.com/legal/terms](https://www.facebook.com/legal/terms)
* 服务隐私政策：[https://www.facebook.com/privacy/policy/](https://www.facebook.com/privacy/policy/)
#### Google Tag Manager / Google Analytics
当启用 DataLayer 模块并配置了 GTM 容器 ID 或 GA4 衡量 ID 时，插件会在店面加载 Google
跟踪代码管理器或 Google Analytics 脚本，并根据访客活动推送电子商务事件。
* 发送的数据：页面浏览量和电子商务事件数据，例如产品 ID、产品名称、价格、购物车
操作、结账事件和订单总额，具体取决于您的配置
* 服务网址：[https://www.googletagmanager.com/](https://www.googletagmanager.com/)
* 服务条款：[https://policies.google.com/terms](https://policies.google.com/terms)
* 服务隐私政策：[https://policies.google.com/privacy](https://policies.google.com/privacy)
后台反馈和停用反馈存储在 WordPress 本地，不会发送至外部服务。
### 免责声明
本插件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用
性和非侵权性的保证。
WPPoland（wppoland.com）对因使用或无法使用本插件而导致的任何直接、间接、附带、特殊、
后果性或惩戒性损害概不负责，包括但不限于利润损失、商誉损失、数据损失或其他无形损失。
本插件为 WooCommerce 商店提供技术工具和模板。它不构成法律建议，也不保证合规性。在
生产环境中使用之前，请审查所有生成的文本和设置。在部署到正式商店之前，请始终在开发
或暂存环境中进行测试。
WPPoland 对因使用本插件而产生的任何法律、财务、监管或其他后果不承担任何责任。安装
并启用本插件即表示您承认完全自行承担风险。
## 屏幕截图
* [[
* 带开关和各模块设置的模块管理仪表板
* [[
* 产品编辑器中的 GPSR 产品安全字段
* [[
* 结账时带审计记录的 GDPR 同意复选框
* [[
* Omnibus 指令 – 促销产品 30 天最低价格
* [[
* 在我的账户 > 订单中的撤销请求操作
* [[
* DSA 非法内容举报表单（短代码）
* [[
* 店面上的 AJAX 搜索和筛选
* [[
* 产品列表上的心愿单、比较和快速查看
## 区块
该插件提供了 4 个区块.
* Polski AJAX Search Dynamic AJAX product search form for WooCommerce storefronts.
* Polski AJAX Filters Dynamic WooCommerce product filters with archive-safe GET
fallback.
* Polski Product Slider Dynamic merchandising slider for related, upsell, sale,
and featured products.
* Legal Checkboxes Checkout consent and acknowledgement checkboxes for WooCommerce
stores in Poland.
## 安装
#### 自动安装
1. 在 WordPress 后台中前往**插件 > 安装插件**。
2. 搜索 **Polski for WooCommerce**。
3. 点击**立即安装**，然后点击**启用**。
4. 导航至侧边栏中新增的 **Polski** 菜单项。
#### 手动安装
1. 从 WordPress.org 仓库下载插件 ZIP 文件。
2. 在 WordPress 后台中，前往**插件 > 安装插件 > 上传插件**。
3. 选择 ZIP 文件并点击**立即安装**。
4. 点击**启用插件**。
## 常见问题
### Polski for WooCommerce 是免费的吗？
是的。Polski for WooCommerce 是免费的开源软件，遵循 GPLv2 或更高版本许可。
### Polski 支持 WooCommerce 产品的 GPSR 吗？
是的。Polski 包含 8 个专用于 GPSR 相关数据的产品字段、批量 CSV 导入或导出、产品列表
中的状态列以及产品页面显示工具。您应当审查哪些字段和呈现方式适合您自己的产品和义务。
### 它支持 WooCommerce 订单的撤回表单吗？
是的。Polski 会直接在“我的账户 > 订单”中为符合条件的订单添加撤回操作。客户打开确认
页面，提交请求，然后收到确认，该请求会被记录到审计日志中。
### Polski 是否已为 WooCommerce 中的 KSeF 工作流程做好准备？
Polski 可以根据账单数据中的 NIP 标记可能需要 KSeF 开票的订单，并提供操作钩子（`polski/
ksef/invoice_ready`、`polski/ksef/is_required`）用于开票插件集成。订单列表中会显示
一个 KSeF 状态列。
### Polski 支持波兰 WooCommerce 商店的 GDPR 同意工作流程吗？
是的。Polski 包含可配置的同意复选框、同意记录、双重确认注册以及相关的数据处理工具，
可以支持 GDPR 工作流程。请针对您自己的商店和义务审查相关配置。
### 它支持 WooCommerce 促销产品的 Omnibus 价格历史记录吗？
是的。Polski 会跟踪并显示促销产品在过去 30 天内的最低价格。在生产环境中依赖此功能
之前，请针对您自己的商店审查其输出和定价工作流程。
### Polski 能与 WooCommerce 区块结账配合使用吗？
是的。Polski 完全支持经典结账和购物车以及基于区块的结账和购物车。
### Polski 能与 HPOS（高性能订单存储）配合使用吗？
是的。Polski 声明完全兼容 WooCommerce HPOS（自定义订单表）。
### 我可以在哪里报告错误或提交功能建议？
请使用 WordPress.org 支持论坛获取支持和提交功能建议。
### 是否有面向非技术用户的简单反馈表单？
是的。插件后台包含一个简单的反馈表单，可将消息存储在 WordPress 本地。请勿在该表单
中包含密码、许可证密钥或客户个人数据。
### 停用和卸载有什么区别？
停用 Polski 会保留您的设置和已存储的数据。卸载会移除插件文件。只有在启用了卸载时
移除数据的设置后，插件数据才会被删除。
## 评价
### [Idealna wtyczka dla polskiego sklepu WooCommerce – bardzo polecam!](https://wordpress.org/support/topic/idealna-wtyczka-dla-polskiego-sklepu-woocommerce-bardzo-polecam/)
[Marcin](https://profiles.wordpress.org/mszatkowski/) 2026 年 5 月 31 日
Zainstalowałem wtyczkę Polski i jestem bardzo zadowolony – od razu mam wszystkie
wymagania prawne (GPSR, Omnibus, RODO) oraz przydatne funkcje jak wishlistę i porównywarkę,
wszystko w jednym darmowym pluginie. Sklep działa lepiej, a ja nie muszę szukać
dziesięciu różnych wtyczek do różnych rzeczy!
[ 阅读所有1条评价 ](https://wordpress.org/support/plugin/polski/reviews/)
## 贡献者及开发者
「Polski for WooCommerce」是开源软件。 以下人员对此插件做出了贡献。
贡献者
* [ Mariusz Szatkowski ](https://profiles.wordpress.org/motylanogha/)
「Polski for WooCommerce」插件已被翻译至 3 种本地化语言。 感谢[所有译者](https://translate.wordpress.org/projects/wp-plugins/polski/contributors)
为本插件所做的贡献。
[帮助将「Polski for WooCommerce」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/polski)
### 对开发感兴趣吗?
您可以[浏览代码](https://plugins.trac.wordpress.org/browser/polski/)，查看[SVN仓库](https://plugins.svn.wordpress.org/polski/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/polski/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/polski/)。
## 更新日志
#### 1.22.2
* Translations: translated all interface strings added in 1.21.0 and 1.22.0 (Consent
Manager, Tag Manager, AI Bridge, Custom Integrations, Safe Fonts, and Custom
Triggers) into every bundled locale (Polish, German, Czech, Slovak, Ukrainian,
Lithuanian, Belarusian, Simplified Chinese). Recompiled the binary and JavaScript
translation files.
#### 1.22.1
* Fixed (privacy): the shop business-identification ability and the withdrawal
annex documents no longer fall back to the site administrator email when no public
contact email is configured. They now return an empty email instead, so the administrator
address is never exposed through publicly readable output.
#### 1.22.0
* New: Consent Manager – a native cookie-consent banner with categories (necessary,
preferences, analytics, marketing), Google Consent Mode v2 (signals default to
denied and update when the visitor chooses), consent-gated script loading, and
a records-of-consent log with CSV export. Module is off by default.
* New: unified Tag Manager – load common marketing and analytics tags (such as
Meta Pixel, TikTok, Microsoft Ads, Clarity, LinkedIn, Pinterest, X, Matomo, Plausible,
PostHog, Hotjar, Inspectlet, Crazy Egg, Simple Analytics) by entering your own
IDs. Every tag is loaded only after the matching consent category is granted.
Module is off by default.
* New: Custom Integrations – add your own header or footer snippets, each assigned
to a consent category so it runs only after that category is granted.
* New: Safe Fonts – help reduce layout shift and defer Google Fonts, with an option
to hold the fonts stylesheet until the chosen consent category is granted.
* New: Custom Triggers – push custom data-layer events on page or click conditions,
optionally gated by consent.
* All new modules are off by default and integrate with the Consent Manager.
#### 1.21.0
* New: AI Bridge – exposes read-only store information to AI assistants and agents
through the WordPress Abilities API (WordPress 6.9 or newer). Abilities cover
product facts, Omnibus price history, GPSR product-safety data, products still
missing GPSR data, compliance status and overall store health. Every ability
is read-only and protected by a WooCommerce capability check; nothing in your
store is changed automatically.
* New: AI product summary – generate a short, plain-language product summary on
demand from the product editor. Uses your site’s configured AI provider when
one is available (WordPress AI Client) and simply does nothing when none is configured.
* New: GPSR safety-text draft helper – generate a draft product-safety text that
you review and edit before saving. Drafts only; nothing is published automatically.
* Compatibility: the AI features degrade gracefully when no AI provider is configured,
and are forward-compatible with the WordPress AI Client. No third-party AI keys
are stored by the plugin.
#### 1.20.1
* Fixed: the admin screens now load their scripts reliably. The bundled admin and
frontend scripts are emitted as classic browser scripts (with their WordPress
script dependencies declared) instead of ES modules, so the React-based admin
renders correctly across setups.
* Translations: refreshed all bundled locales (Polish, German, Czech, Slovak, Ukrainian,
Lithuanian, Belarusian, Simplified Chinese) so every interface string is up to
date.
#### 1.20.0
* 新模块：促销/动态定价（基础版）。可选，默认关闭。在模块设置中配置两种自动购物
车折扣：批量折扣（产品行数量达到阈值后该产品行享受百分比折扣）和购物车折扣（购物
车小计达到阈值时享受百分比折扣，作为购物车费用应用）。从原价幂等地重新计算，在
WooCommerce 反复计算总额时保持安全。
#### 1.19.0
* 新模块：退货和投诉（RMA）。可选，默认关闭。客户可以从我的账户为符合条件的订单
提交投诉（reklamacja）或退货（zwrot）请求；请求会被存储，通过电子邮件向客户和
商店确认，并在新的管理队列（WooCommerce > Polski > 退货和投诉）中进行管理，支持
状态变更（已提交、处理中、已解决、已拒绝）。它沿用了撤销请求流程，并复用同意/
订单基础设施。可配置符合条件的时限和通知电子邮件。提供工具和模板，而非法律建议。
* 店面模块编排：统一加载器，使心愿单、快速查看及页面加载后渲染的其他按钮（无限滚动、
AJAX 筛选、快速查看弹窗）保持正常工作，并改进了无障碍性和性能。
#### 1.18.0
* 整个管理后台的视觉形象焕新：全新的 Polski 品牌，采用自托管的 Schibsted Grotesk
和 Hanken Grotesk 网页字体（font-display swap）、字母组合菜单图标和文字标识仪表
板页眉。管理样式仅在插件自身的页面加载，绝不在店面加载，以保护 Core Web Vitals。
* 店面结构化数据：插件现在为 WooCommerce 自带的 Product 和 Offer JSON-LD（无重复
图谱）增加 priceValidUntil 值，并在促销产品上以真实的 Omnibus 30 天最低价格作为
MinimumPrice 规范，以获得更好的丰富搜索结果和机器可读性。
* 扩展了波兰语、德语、捷克语、斯洛伐克语、乌克兰语、简体中文、白俄罗斯语和立陶宛
语的本地化目录，并持续进行翻译维护。
* 排版清理：在界面字符串和所有翻译目录中将长破折号替换为连字符，以实现一致的渲染。
#### 1.17.0
* 商店健康监控器：新的可选模块（默认关闭），用于对商店运营进行持续、被动的监控。
三个传感器通过 WP-Cron 每 5 分钟运行一次：前端致命错误（`shutdown` 处理程序，
仅限店面）、结账失败率（在 2 小时滚动窗口内观察 `woocommerce_checkout_order_processed`、
其 Store API 等价事件以及 `woocommerce_order_status_failed`），以及销售异常检查（
将上一个完整小时与过去 8 周内同一星期几/同一小时的典型订单数对比，最多每小时评估
一次）。绝不会下任何合成订单。警报通过电子邮件和可选的 JSON webhook（兼容 Slack/
Discord）发出，并带有可配置的冷却时间；当该模块启用时，硬性宕机还会在安全事件
日志中记录一条条目。报告与工具下的健康仪表盘提供手动“立即运行检查”、当状态非正常
时的后台通知，以及一个只读 REST 端点 `GET /polski/v1/store-health`。区块结账通过
Store API 钩子覆盖。设置：警报电子邮件/webhook、失败率阈值和最小样本量、销售异常
阈值，以及警报冷却时间。
#### 1.15.0
* B2B 字段：可选的“Potrzebuję faktury VAT”切换，与现有的“以公司身份购买”复选框相互
独立。波兰电商惯例将开具发票的需求视为与公司/消费者身份正交（paragon 与 faktura），
因此该字段是独立的选择项。保存到 `_polski_needs_invoice` 订单元数据。同时贯通
经典结账和 WC 8.6+ 附加字段 API。新增设置 `polski_b2b.show_needs_invoice_toggle`（
默认关闭）。
* Compare：粘性底部抽屉（`polski_compare.show_sticky_bar`，默认关闭），显示所比较
产品的缩略图，并带有“Porównaj (N)”CTA 和一个清空全部按钮。在比较页面本身上隐藏；
当列表为空时自动抑制。具备移动端响应式 CSS。
* Compare：用于页眉计数器的新短代码 `[polski_compare_count]`，支持 `template`、`
class` 和 `hide_when_empty` 属性。会渲染一个指向比较页面的锚点，并带有 `data-
polski-compare-count` 属性，现有的 AJAX 层可实时更新该属性。
* AJAX 筛选器：命名预设。`[polski_filters preset="b2b"]` 短代码参数会从新的 `polski_filter_presets`
选项（`[name => array]`）加载覆盖项；内层数组会在渲染前合并到
全局筛选设置之上。归档页面可通过 `polski/filters/archive_preset` 过滤器映射到
某个预设。可通过 `polski/filters/preset`（preset、name）进行按预设的运行时调整。
#### 1.14.1
* B2B 字段：完整的 IBAN 验证。`B2BCheckoutService::isPlausibleIban()` 现在执行
ISO 13616 mod-97 校验和以及国家代码长度查找（PL=28、DE=22、GB=22、FR=27、IT=27，
外加另外 25 个欧盟/瑞士/英国市场）。取代了之前仅做结构检查的合理性校验。
* DSA：在举报提交处理程序上按 IP 进行速率限制。默认每个 IP 每小时 5 次举报；时间
窗口和限制可通过 `polski/dsa/rate_limit_window_seconds` 和 `polski/dsa/rate_limit_max_attempts`
过滤。源 IP 可通过 `polski/dsa/rate_limit_ip` 过滤，适用于位于反向代理之后的站
点。
* 代码质量：在原有模块中更严格地遵循 Plugin Check 合规。CRA `IncidentRepository`
现在使用 `%i` 占位符而非插值的 `{$table}` 查询；`FilterService` 使用作用域化的`
phpcs:disable`/`enable` 块来说明只读的基于 GET 的筛选上下文，而不是让一个推荐
级警告悬而未决；`CRAIncidentsPage` 在将 `$_POST['kind']` 和 `$_POST['severity']`
传入 `IncidentKind::tryFrom()` 和 `Severity::tryFrom()` 之前添加了 `wp_unslash()`
+ `sanitize_key()`；`templates/forms/ajax-filters.php` 净化了单字符串的 `$_GET[
$key]` 读取。
#### 1.14.0
* B2B 结账字段：通过 `woocommerce_register_additional_checkout_field`（WC 8.6+）
支持区块结账。NIP、REGON 和 IBAN 现在通过单次注册即可同时出现在经典结账和区块
结账中。由 WC 附加字段 API 写入的值会在保存时镜像到传统的 `_billing_nip`、`_billing_regon`、`
_billing_iban` 订单元数据（`woocommerce_set_additional_field_value`），以便现有
的 KSeF 和发票模块无需改动即可读取。当现代 API 可用时，会自动跳过仅限经典的 `
woocommerce_billing_fields` 路径，从而防止重复的账单行。WC < 8.6 的商店将继续
使用仅限经典的路径以及公司切换。
* DSA 模块：针对每个产品的举报小工具。在单个产品页面上提供可选的可折叠“Zgłoś nielegalne
treści (DSA)”部分，举报表单会预填产品永久链接和易读的名称。表单会提交到现有的`
polski_dsa_report` admin-post 处理程序，因此举报会进入与短代码提交相同的后台队列。
位置可配置（在产品摘要之后或在产品元数据区块中）。新增过滤器 `polski/dsa/product_widget_enabled`。
默认值 `polski_dsa.product_widget_enabled`（关闭）和 `polski_dsa.product_widget_position`（`
after_summary`）。
* DSA 模块：为 `polski_dsa` 填充了默认值（`contact_email`、`form_title`、`form_intro`，
以及新的小工具键），使管理员在首次激活时看到的是预填值而非空字符串。
#### 1.13.0
* 新模块：B2B 结账字段。为 WooCommerce 经典结账添加可选的“以公司身份购买”切换以及
NIP、REGON 和 IBAN 字段，并根据该切换进行条件显示/隐藏。NIP 在提交时使用官方波兰
校验和算法进行验证，并保存到标准的 `_billing_nip` 元数据中，以便现有的 KSeF 和
发票集成无需改动即可读取。REGON 接受 9 位或 14 位数字；IBAN 通过结构合理性检查（
国家前缀 + 13-32 位字母数字主体，长度 15-34）。设置组 `polski_b2b`（`enabled`、`
show_company_toggle`、`nip`、`regon`、`iban`）。新增静态工具 `Polski\Util\NipValidator`（`
isValid`、`normalize`、`format`）。如果其他集成已注册了 NIP 字段，Polski 会跳
过自身的 NIP 注册以避免重复字段。
#### 1.12.0
* AI Feed：位于站点根目录的 `/llms.txt` 清单，遵循 https://llmstxt.org 的开放标准。
会查找 `/llms.txt` 这一公认文件的 AI 代理现在可获得站点的 Markdown 索引——标题、
描述、带 `?output_format=md` 链接的法律页面、WooCommerce 商店页面，以及热门产品
分类。过滤器：`polski/ai_feed/llms_txt_enabled`、`polski/ai_feed/llms_txt_sections`、`
polski/ai_feed/llms_txt_category_limit`。设置 `polski_ai_feed.llms_txt_enabled`（
默认 `true`）。
#### 1.11.0
* 新模块：AI Feed。通过内容协商以 Markdown 形式提供单篇文章、页面和 WooCommerce
产品，使 AI 代理和 LLM 爬虫无需抓取 HTML 即可采集商店内容。由 `Accept: text/markdown`
标头或 `?output_format=md` 查询参数触发。向单视图添加 `` 以便发现，并在文章、页面和产品列表页面添加“查看 AI 版本”
行操作。
* AI Feed：产品 Markdown 丰富了波兰市场数据——SKU、GTIN/EAN、毛价/正常价/促销价、
货币、税务类别、Omnibus 最低价（最近 30 天）、配送时间、库存数量和可用性、重量、
尺寸、品牌、制造商、GPSR 责任人，以及产品分类。Front matter 以 YAML 形式公开相同
字段，便于结构化采集。
* AI Feed：过滤器 `polski/ai_feed/enabled`、`polski/ai_feed/post_types`、`polski/
ai_feed/post_markdown`、`polski/ai_feed/product_markdown`、`polski/ai_feed/product_facts`、`
polski/ai_feed/password_required`。设置组 `polski_ai_feed`（`enabled`、`post_types`）。
默认文章类型：`post`、`page`、`product`。
#### 1.10.0
* 新模块：OSS 观察器。通过与独立的 One Stop Shop 插件集成，跟踪欧盟共同体内 10,000
欧元的 B2C 配送阈值。可直接从模块行一键安装 + 激活。当观察器被开启而外部插件不存在
时，WooCommerce 后台通知会提示安装。提供过滤器 `polski_tax_oss_enabled`，以便
自定义税务集成可根据 OSS 状态分支税务逻辑。
* 模块页面：重新设计为 WP 列表表格（名称 / 已启用 / 描述 / 编辑），并按 MoSCoW
优先级分组——法律与合规、税务与定价、结账与订单、内容与信任、高级与工具。铅笔图
标会为每个分组打开专门的设置子页面（`admin.php?page=polski-group-#polski-
module-`），该子页面会为每个带设置的模块（无论是否启用）动态注册。
* 设置向导：重写为 5 步引导式流程（公司 > 法律 > 税务与 OSS > 结账 > 完成）。每
一步都使用带内联说明面板的切换行；可选步骤提供跳过步骤 + 继续；税务步骤上的 OSS
切换会在完成时触发 One Stop Shop 插件的安装。
* 仪表盘：为希望在完成后重新运行引导式设置的商家提供“重新启动设置向导”按钮。
#### 1.9.1
* 合规清单：无障碍（WCAG）部分——针对静态首页 HTML 扫描 9 条启发式规则（html lang、
跳转链接、h1、viewport meta、main 地标、search 角色、焦点轮廓、自动播放声音、
缺失的 img alt）。REST：`GET /polski/v1/compliance/accessibility`。
* 合规清单：Cookie 横幅现在包含推送通知请求检测器——会标记在没有用户交互的情况下
触发的 `Notification.requestPermission`、`PushManager.subscribe` 以及常见的第三
方推送 SDK。
* 新模块：RODO 培训文档生成器。后台页面 `Polski > RODO training docs` 可下载三份
可打印的 HTML 模板（培训日志、原则摘要、数据泄露应对手册）。预先以来自设置向导
的商店数据进行品牌化。
#### 1.9.0
* 新模块：投诉模板生成器。可直接打印的投诉表单（formularz reklamacyjny），自动填入
卖家数据。后台页面 `Polski > Complaint template` 支持预览 + 下载为独立 HTML。`[
polski_complaint_template]` 短代码可嵌入客户页面。
* 新模块：版权 / 许可声明辅助工具。`[polski_copyright]` 短代码 + `polski/copyright`
区块，包含年份、所有者和可选的许可。`[polski_image_credit]` 短代码用于为每张图片
标注来源链接和许可。
#### 1.8.2
* 新模块：商家识别信息。通过 `[polski_business_info]` 短代码和动态 Gutenberg 区块`
polski/business-info` 呈现商店的商业数据（名称、地址、NIP、REGON、电子邮件、电话）。
读取在设置向导中设定的值（`polski_general` 选项）。支持区块格式和内联格式，分隔
符可配置。
#### 1.8.1
* 新模块：SBOM 生成器。输出一份 CycloneDX 1.4 JSON 文档，列出 PHP（composer.lock）
和 JS（package-lock.json）依赖项以及插件元数据。后台页面 `Polski > SBOM` 支持
一键下载。Content-Type 为 `application/vnd.cyclonedx+json`——可直接用于 Dependency-
Track / Trivy。
#### 1.8.0
* 新模块：CRA 事件报告。记录正在被积极利用的漏洞和安全事件，并附带 CRA 第 14 条
早期预警截止时间（事件/被利用漏洞为 24 小时，未遂事件为 72 小时）。后台页面 `
Polski > CRA incidents` 可用于记录、派发（webhook + 邮件）和标记为已解决。按
ENISA SRP 草案架构进行 JSON 导出。每小时 cron 检查临近的截止时间。动作钩子 `polski_cra_incident_recorded`
和 `polski_cra_incident_deadline_approaching`。迁移 2.1.0 创建 `polski_cra_incidents`。
#### 1.7.2
* 站点审计：四项新增的暗黑模式检查。强制创建账户（欧盟指令 2023/2673）、过期/虚假
的促销倒计时（产品在 date_to 过期后仍处于促销状态）、min/max 价差超过 50% 的可变
产品上误导性的“起价”、通过过大的低库存阈值（>5）制造的虚假紧迫感。
#### 1.7.1
* 合规清单：新增 Cookie 横幅（主动同意）部分。使用 1 小时瞬态缓存扫描首页 HTML，
并报告 9 条规则（横幅是否存在、接受、拒绝是否同等醒目、精细化设置、Analytics/
Marketing 类别、隐私政策链接、撤回提示、默示同意措辞陷阱）。
* REST API：`GET /polski/v1/compliance/cookie-banner?url=` 以 JSON 形式返回 cookie
横幅清单。
* 5 个新单元测试。
#### 1.7.0
* 新模块：针对隐私政策（RODO 第 13 条）和服务条款（《电子服务提供法》 / 《消费者
权利法》）的合规清单。采用结构化启发式扫描器，包含 17 + 15 条规则、严重级别（
必需/推荐/可选），以及一个显示评分和各要素通过/未通过情况的 WP 后台清单页面。
* REST API：`GET /polski/v1/compliance/page/{privacy|terms}` 以 JSON 形式返回完整
清单。
* 后台：新增子菜单 Polski > 合规清单。
* 12 个单元测试，涵盖规范化（HTML + 变音符号剥离）、规则评估、评分计算和默认规则
集。
#### 1.6.3
* 修复：在所有 `$wpdb` 自定义表调用（仓储、Migrator、DSAService、uninstall.php）
上添加了逐行带说明理由的 `phpcs:ignore` 注释
* 修复：在服务类（ExpertReview、DoubleOptIn、SocialLogin、ReviewRequest、Faq）中的`
meta_key` / `meta_value` / `meta_query` / `tax_query` 查找上添加了 `phpcs:ignore`
注释
* 修复：在邮件模板中的 WooCommerce 邮件页眉/页脚 `do_action()` 调用上添加了 `phpcs:
ignore`
* 结果：Plugin Check 现在对已构建的发布包报告 0 个错误和 0 个警告
#### 1.6.2
* 修复：弱化了插件描述和 FAQ 的措辞，以避免暗示法律合规或法律保证
* 修复：在外部服务中说明了 Google OAuth、Facebook OAuth 以及 Google Tag Manager/
Google Analytics
* 修复：从后台侧边栏和停用弹窗中移除了失效的 GitHub 支持链接
* 修复：加固了后台和店面流程中剩余的 `$_GET` 和 `$_POST` 处理
* 修复：在目标仍位于站内的情况下，将内部的 `wp_redirect()` 调用替换为 `wp_safe_redirect()`
* 修复：从评测请求邮件中移除了 HEREDOC 用法，以更好地兼容 Plugin Check
* 修复：将所有剩余的内联 `