Z-Blog原创插件：剑侠自动地图生成器(jx_sitemap)v1.4.0 - 支持百度/IndexNow/搜狗推送

【插件简介】

  剑侠自动地图生成器（jx_sitemap）是一款专为 Z-Blog PHP 开发的高效站点地图插件。

支持自动生成 XML、HTML、TXT 三种格式地图，并集成百度普通收录 API、IndexNow（必应/Yandex）以及搜狗自动推送功能。

插件支持文章发布自动更新、蜘蛛访问记录统计及接口连通性检测，是 Z-Blog 站长进行搜索引擎优化（SEO）的必备利器。

  主要能力概览：

  · 生成 sitemap.xml（默认），可选生成 sitemap.html、sitemap.txt

  · 将 sitemap.xsl 部署到站点根目录，便于浏览器中预览 XML 样式

  · 维护 robots.txt 中的 Sitemap 声明（在插件逻辑内处理）

  · 文章 / 页面发布成功后，可按配置自动重建地图并尝试向搜索引擎推送新 URL

  · 支持百度搜索资源平台「普通收录」API Token

  · 支持 IndexNow 密钥（必应、Yandex 等），并可在站点根目录写入校验文件

  · 可选配置搜狗推送 Token；谷歌相关密钥仅作后台保存（插件不发起谷歌自动推送）

  · 后台提供地图 URL 列表、蜘蛛访问记录、推送统计等辅助功能

【安装与启用】

  1. 将整个 jx_sitemap 目录置于：zb_users/plugin/jx_sitemap/

  2. 登录 Z-Blog 后台 → 插件管理 → 找到「剑侠自动地图生成器」→ 启用

  3. 进入插件配置页（通常位于：插件管理 → 对应插件 → 设置 / 直接进入 main.php）

# 安装路径示例
zb_users/plugin/jx_sitemap/

【后台界面说明】

  插件后台分为多个标签页（以实际界面为准），常见包括：

  · 总览：保存配置、立即生成 Sitemap、查看上次生成时间与 URL 数量、打开

          sitemap.xml / sitemap.html / sitemap.txt 等链接

  · 搜索引擎密钥：填写百度 Token、IndexNow 密钥、搜狗 Token 等；可使用

                  「检测接口」对百度 / 必应(IndexNow) / 搜狗做连通性测试

  · 蜘蛛与统计：查看爬虫访问记录、推送成功/失败等汇总（具体以页面为准）

  · 地图列表：解析当前 sitemap.xml 中的 URL 列表便于核对

  · 帮助：插件内联说明

  首次使用建议在「总览」中点击「立即生成」或保存一次配置，确认网站根目录下

  已生成 sitemap.xml（及您勾选的其他格式文件）。

【核心配置项说明】

  1）自动更新

     开启后，在文章或页面发布成功时会触发地图重建与（若已填写密钥）推送逻辑。

     是否推送还取决于各平台 Token/密钥是否已正确填写。

  2）输出格式

     可同时勾选 XML / HTML / TXT；若全部关闭，保存时会强制保留 XML，避免无地图可用。

  3）收录范围

     可选择是否包含：分类、标签、独立页面、文章等；并可分别设置各类链接数量上限。

     注意：Z-Blog 中「独立页面」与「文章」类型不同；若只勾选文章、不勾选页面，

     则独立页面不会进入地图。未公开发布的内容通常也不会出现在地图中。

  4）自动刷新间隔

     若开启「按间隔自动刷新地图」类选项，插件会按您设置的分钟数在访问过程中

     尝试刷新地图（具体逻辑以实现为准），数值在配置允许范围内生效。

  5）网站地址（重要）

     百度推送接口中的 site 参数来自 Z-Blog「网站设置」里的站点地址（主机名）。

     请保证该地址与百度搜索资源平台中添加的站点域名一致（含是否带 www）。

【百度搜索资源平台（普通收录）】

  · 在百度搜索资源平台 → 普通收录 → 接口调用地址中，复制「token」字符串

  · 在插件「搜索引擎密钥」中，仅粘贴 Token 本身，不要粘贴整段

    http://data.zz.baidu.com/urls?site=...&token=...

    否则接口会返回错误（常见为 400，message 为 token invalid）

  · 站点须已在平台完成验证；Token 与站点绑定，换站点或重置 Token 后需重新填写

  · 「检测接口」会向百度提交首页 URL 做测试，会占用当日推送配额，请勿频繁点击

【IndexNow（必应等）】

  · 在插件中填写 IndexNow 密钥并保存后，插件会尝试在网站根目录生成

    「密钥.txt」校验文件（文件名为 密钥.txt，内容为密钥本身）

  · 请确保该文件可通过公网访问（与 IndexNow 文档要求一致）

  · 使用「检测接口」可辅助判断 HTTP 状态是否异常（如 422 多与域名或 URL 不一致有关）

【搜狗（可选）】

  · 若搜狗资源平台提供与百度类似的推送 Token，可填写保存；是否长期有效以

    搜狗官方接口为准。检测接口仅作连通性参考。

【谷歌】

  · 插件内可保存谷歌相关密钥字段，但本插件不按谷歌官方索引 API 自动推送 URL。

    收录请在 Google Search Console 中提交站点地图或按谷歌文档操作。

【文件位置说明】

  · 默认 sitemap.xml、sitemap.html、sitemap.txt 生成在 Z-Blog 站点根目录

    （与 index.php 同级，具体以 $zbp->path 为准）

  · sitemap.xsl 由插件复制到根目录，供浏览器渲染 XML 使用

【常见问题】

  Q：百度提示「错误码 400 — token invalid」？

  A：多为 Token 填错（误填整段接口 URL）、Token 已失效、或 Z-Blog 站点地址与

     百度平台添加的域名不一致。请只粘贴 Token，核对域名与验证状态后重试。

  Q：生成后只有 1 条 URL 或没有文章？

  A：检查是否未勾选「页面」或「文章」、内容是否未公开、数量上限是否过小；

     插件在特定条件下会在后台提示与「独立页面」相关的说明。

  Q：修改配置后不生效？

  A：保存配置后建议再执行一次「立即生成」；若使用缓存或 CDN，需刷新或排除

     sitemap 相关文件的缓存。

【卸载说明】

  卸载插件不会自动删除已生成的 sitemap.xml 等文件；若不再需要，请手动在站点根目录

  删除对应文件，并检查 robots.txt 是否仍引用旧地址。

【技术支持】

  作者信息与主页见 plugin.xml（url / author）。使用问题请结合 Z-Blog 版本、

  PHP 版本及上述平台官方文档排查。

================================================================================

  文档结束，更多插件访问：https://jianxiaym.com/?cate=3 

================================================================================