yoone-wc-subscriptions/docs/项目新增.md

开发一个名为yoone-subscriptions的WordPress插件，实现订阅功能。

1. 插件基础框架：

• 创建标准的 WordPress 插件目录结构
• 包含主插件文件 yoone-subscriptions.php 并添加必要的插件头信息
• 实现 WooCommerce 插件激活/卸载钩子
• 建立国际化支持（textdomain: yoone-subscriptions）

2. 产品订阅管理：

• 可以为单独产品设置订阅计划
• 订阅计划包括：订阅周期（月、年）、订阅数量（默认1）、订阅价格（可选）配置是否显示 perchase one time 选项

3. 前端功能

• 产品页
  • 设置了订阅计划的产品页显示订阅计划的选项(以及金额折扣)
  • 可以加购
• 购物车
  • 可以在购物车中添加订阅项目(显示订阅标识)
  • 购物车中订阅产品的行项目价格 = 订阅价格 × 订阅周期 × 订阅数量
  • 购物车与订单行项目显示订阅产品的摘要，包括订阅周期、订阅数量、订阅价格

4. 代码规范

• 符合 WordPress 编码规范
• 代码分层, 比如数据库存储, 前端展示, 后端逻辑,管理表单等
• 所有方法添加详细注释,包括
  • 功能说明
  • 参数说明
  • 返回值说明
  • 涉及的 WooCommerce 或者 wordpress 的钩子
• 关键操作添加日志记录
• 实现必要的安全验证

文档:

• 完整的 README.md 包含：
  • 插件功能概述
  • 安装说明
  • 配置指南
  • 截图示例
  • 常见问题
• 代码内文档（PHPDoc 标准）

参考实现:

• sumosubscriptions
• woocommerce-subscriptions_v8.0.0
• yith-woocommerce-subscription-premium
• wpc-composite-products-premium_v7.6.2 测试要求:
• 兼容 woocommerce payments api,包括 yoone-moneris-payments
• 性能测试（大数据量场景）

请按照以上需求实现插件，保持代码结构清晰并确保所有功能点都有详细注释说明实现逻辑。