文档与 License 接口

本软件是一个 WordPress 插件，不能独立运行。请先搭建好 WordPress 网站，再安装本插件。还没有 WordPress？请前往 wordpress.org 下载安装。

1. 安装插件

把 superinquiry 目录上传到 wp-content/plugins/（或在后台上传 zip）。
启用插件，自动创建示例表单与「业务员」角色。
在页面插入短代码 [superinquiry_form id="1"]。
（Pro）在 Super Inquiry → License 填入授权码解锁专业版。

环境要求：WordPress 5.8+、PHP 7.4+、MySQL 5.7+。

2. License 接口（供插件调用）

均为 POST，返回 JSON。字段：license_key、site_url。

curl -X POST "https://superinquiry.com/api/verify" \

  -d "license_key=SI-XXXX-XXXX-XXXX-XXXX" \

  -d "site_url=https://client-site.com"

{"success":true,"valid":true,"status":"active",

 "expires_at":"2027-07-10 00:00:00","max_activations":3,

 "activations_used":1,"message":"License is valid."}

POST https://superinquiry.com/api/activate — 绑定站点，占用一个激活名额
POST https://superinquiry.com/api/deactivate — 解绑站点，释放名额

status: active / not_activated / expired / disabled / not_found / limit_reached / bad_request

站点按主机名归一化（转小写、去掉 www.）后计数，因此同一站点重复激活不会重复占用名额。

verify 的判定是「按站点」而不是「按授权码」：没有占到名额的域名会收到 not_activated（还有空位，可直接激活）或 limit_reached（名额已满），而不是 active。缺少 site_url 的请求一律拒绝。

3. Pro：登录安全（可选）

在 Super Inquiry → Pro Settings 开启后，wp-login.php 与未登录状态下的 /wp-admin 会返回 404，登录表单改为在你自定义的地址（默认 /adm/）响应；同时启用同 IP 失败次数锁定，并阻断 ?author=N 与 REST 用户接口的用户名枚举。admin-ajax.php、admin-post.php 与 wp-cron.php 始终可访问，前台表单与定时任务不受影响。

被锁在外面？在 wp-config.php 加一行即可恢复默认登录页：

define( 'SUPERINQUIRY_DISABLE_LOGIN_RENAME', true );