WPPYA支付插件fiee007二开版

共计 2034 个字符，预计需要花费 6 分钟才能阅读完成。

原来的 wppya 插件太老了

现在支持如下

1、支付宝当面付 3.0 集成
2、支持 PHP8.X
3、美化前后端
4、完全符合 WordPress 插件开发教程手册
WPPAY WordPress 付费插件说明文档

体验： 下载测试 | Terblog

一、插件简介

WPPAY 是一款 WordPress 付费内容插件，支持免登录付费查看隐藏内容、分段付费阅读、付费下载资源。

当前 1.0.0 版本使用支付宝当面付生成扫码订单，前端弹窗自动轮询检测支付结果，60 秒未付款自动关闭支付弹窗。

二、功能特性

支持整篇文章付费查看支持文章局部内容通过短代码单独付费隐藏支持付费解锁资源下载信息游客免登录购买，购买记录通过 Cookie 存储，可选搭配 IP 辅助校验登录用户购买记录永久保存，不受浏览器缓存影响集成支付宝当面付扫码支付渠道后台完整订单列表查询、管理功能

三、安装方法

将插件文件夹上传至 WordPress 目录 wp-content/plugins/ 进入 WP 后台「插件」页面，启用 WPPAY 插件后台左侧菜单点击「WPPAY」，完成基础配置与支付宝当面付参数填写编辑文章，在侧边 WPPAY 配置框设置收费类型、价格、下载资源信息

四、后台基础设置

后台访问路径：WPPAY > 设置

设置项 说明
cookie 保存天数 未登录游客的付费权限在浏览器 Cookie 内的有效存储天数
cookie key 用于加密生成购买状态 Cookie 的密钥，建议填写随机字符串，上线后不要修改
通过 IP 辅助判断 勾选后，Cookie 过期时可依靠访问 IP 识别游客历史购买记录
颜色设置 自定义前台付费提示框、支付按钮、弹窗主题颜色
支付宝当面付设置 依次填写支付宝应用 ID、商户应用私钥、支付宝公钥
五、文章收费类型配置

编辑文章时，在侧边 WPPAY 元框选择收费模式

收费类型 用途
不启用 当前文章关闭付费功能，全文免费展示
查看全部内容 用户支付后才能浏览整篇完整文章
查看部分内容 搭配

未支付时展示付费引导按钮，付款成功后自动显示内部全部内容。

2、跨文章复用付费配置（id 参数）

读取指定文章 ID 的价格、付费规则，多页面共用一套收费标准：

3、兼容短代码

自动读取当前文章 WPPAY 付费设置，无自定义参数：

[box] 受当前文章付费规则控制的隐藏内容

推荐优先使用，语义清晰且支持 id 跨文章参数。

七、付费下载资源操作步骤

文章收费类型选择「下载资源」填写商品收费价格，在下载信息框录入网盘链接、提取码、资源说明未付费用户：文章底部展示付费下载引导已付费用户：页面直接展示完整下载信息

八、完整支付流程

用户点击页面「立即支付」按钮前端 AJAX 请求后端，创建支付宝当面付订单弹出支付宝扫码支付弹窗前端每 5 秒轮询接口，校验支付回调状态检测到支付成功，自动刷新页面展示付费内容 60 秒内未完成付款，支付弹窗自动关闭，需重新发起支付

九、WordPress 插件开发规范合规说明

检查项 当前实现状态
插件标准头部信息 包含 Plugin Name、Plugin URI、Description、Version、Author、Text Domain、Requires at least、Requires PHP、License 完整字段
禁止直接访问文件 主文件与所有引入文件增加 ABSPATH 防直访判断
激活安装钩子 使用 register_activation_hook() 自动创建订单数据表
后台管理菜单 通过 admin_menu 钩子注册 WPPAY 设置页、订单管理页
标准化配置存储 使用 Settings API 的 register_setting()，自带数据清洗过滤函数
AJAX 接口安全校验 支付创建、订单查询等 AJAX 全部增加 nonce 防跨站验证
文章元框安全存储 元数据保存增加自动保存、修订、权限、nonce 多重校验
前端静态资源加载 使用 wp_enqueue_style()、wp_enqueue_script() 加载样式脚本，通过 WPPAY_VERSION 控制浏览器缓存
十、常见问题

1、支付成功后页面没有解锁付费内容

支付宝异步回调存在网络延迟，等待 10~30 秒后手动刷新页面即可正常展示内容。

2、修改 cookie key 后老游客丢失购买权限

cookie key 参与 Cookie 加密签名，修改后历史存储的购买 Cookie 全部失效，正式上线后不建议修改。

3、短代码不生效

检查两点：①当前文章收费类型选择「查看部分内容」；②收费价格填写大于 0 的有效金额。

十一、版本信息

当前版本：1.0.0