Polski for WooCommerce

更新日志

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<setting, value>]）加载覆盖项；内层数组会在渲染前合并到全局筛选设置之上。归档页面可通过 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 查询参数触发。向单视图添加 <link rel="alternate" type="text/markdown"> 以便发现，并在文章、页面和产品列表页面添加“查看 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-<bucket>#polski-module-<id>），该子页面会为每个带设置的模块（无论是否启用）动态注册。
• 设置向导：重写为 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
• 修复：将所有剩余的内联 <script> 标签（DataLayer 事件、JSON-LD 架构）替换为 wp_print_inline_script_tag() / wp_print_script_tag()
• 修复：重构了仓储查询，改用带 %i 表名占位符的 $wpdb->prepare()（消除了表名插值的抑制注释）
• 修复：将 Elementor 小工具中原始的 echo $html 替换为 wp_kses_post()
• 修复：为所有模板变量添加了 polski_ 前缀，以符合 WordPress.org 命名规范
• 修复：移除了数十处 phpcs:ignore 抑制注释，改用真正的修复方案

1.6.1

• 修复：将内联的后台 CSS 和 JS 移至已入队的资源文件（wp_enqueue_style / wp_enqueue_script）
• 修复：净化了 AJAX 产品筛选模板中的 $_GET 输入
• 修复：移除了手动调用的 load_plugin_textdomain()（自 WP 4.6 起，WordPress.org 会自动加载翻译）
• 修复：在将 $_POST 值传入 wp_verify_nonce() 之前先进行净化，从而加固了 nonce 验证
• 修复：在专家评测和产品元数据保存流程中补充了缺失的 wp_unslash() 和权限检查
• 修复：更新了 readme.txt 中的 Contributors 用户名，并移除了失效的捐赠 / GitHub 仓库链接

1.6.0

• 新增社交登录模块（Google + Facebook OAuth2，支持自动注册）
• 新增面向书店和出版商的产品作者分类法
• 新增专家评测自定义文章类型，支持评分和 Schema.org 标记
• 新增订单导出模块（CSV，支持 30 多个可配置字段）
• 新增 FAQ 模块，支持分类、折叠面板短代码以及 Schema.org FAQPage
• 增强了自定义结账字段，支持 5 种条件逻辑类型（字段值、配送方式、付款方式、商品分类、购物车总额）

1.5.0

• 新增了自动恢复库存模块 – 在订单取消、退款或失败时自动恢复产品库存
• 新增了 AJAX 加入购物车模块 – 无需刷新页面即可将产品加入购物车，包括可变产品
• 新增了自定义结账字段模块 – 添加、修改和重新排序结账字段，支持多种字段类型和验证
• 管理面板中新增了”库存和购物车”以及”结账”模块组

1.4.0

• 为可变产品新增了”起价”显示（显示”从 XX PLN 起”而非价格区间）
• 新增了最低订单金额和数量规则，并带购物车验证
• 新增了订单完成后的自动评价请求电子邮件
• 新增了对评价请求电子邮件的退出支持
• 改进了本地化：所有 __() 回退字符串现在使用英语源语言

1.3.0

• 新增了 GPSR 模块：8 个产品字段、CSV 批量导入/导出、产品列表中的状态列、产品页面展示
• 在我的账户中新增了客户撤销请求流程（欧盟指令 2023/2673）
• 新增了 DSA 工具包：举报表单短代码、管理后台举报页面、电子邮件通知
• 新增了 KSeF 就绪模块：基于 NIP 的自动检测、集成钩子、订单列表列
• 新增了安全事件模块：面向 CRA 的事件日志，支持状态跟踪和 CSV 导出
• 为产品评价新增了已验证购买徽章
• 扩展了网站审计，新增 DPA、DSA、KSeF 就绪、反漂绿、已验证评价和安全事件检查
• 新增了反漂绿产品字段（生态声明依据、证书、有效期）
• 在 WordPress 管理菜单中新增了各模块的动态设置页面
• 修复了 WooCommerce Blocks 单产品页面上的 GPSR 渲染问题
• 为提交至 WordPress.org 而精简的免费版本
• 5 个语言包：波兰语、德语、捷克语、斯洛伐克语、乌克兰语

1.1.0

• 新增了店面模块（比较、快速查看、徽章、标签页、视频、缩放、滑块、无限滚动、弹窗）
• 新增了可配置的管理后台和电子邮件文案
• 新增了撤销和候补名单的客户流程
• 改进了 WooCommerce Blocks 结账支持

1.0.0

• 首次发布
• GDPR 复选框、Omnibus 指令、撤销表单
• Shopmarks：单位价格、交付时间、税务提示
• 心愿单、候补名单功能
• 食品产品信息字段
• REST API、WP-CLI、CSV 导入/导出
• 完整的波兰语翻译