在线工具箱（webTool）使用说明

版本：1.0.00

一、简介

在线工具箱是 zsadmin 的独立插件，内置 JSON 格式化、MD5 加密、UUID/GUID 生成、IP 查询、Whois 查询、ICP 备案查询、网站状态检测等 180+ 个在线工具页面。

• 前台默认入口：/webTool/
• 后台配置入口：应用菜单「在线工具箱 → 工具箱设置」
• 支持自定义访问前缀与独立域名绑定

二、安装与启用

1. 将 webTool 插件目录放入 plugins/ 下。
2. 进入后台「应用中心 → 插件」，找到「在线工具箱」执行安装/启用。
3. 安装时会把插件静态资源同步到 public/static/webTool/。
4. 插件关闭（基础设置中关闭「启用在线工具箱」）后，前台全部工具页返回 404。

三、前台访问

• 工具标识即模板文件名，例如 view/index/json.html 对应 /webTool/json/。
• 支持 .html 伪静态后缀（如 /webTool/json.html）。
• 页面内链接、表单提交地址会按当前前缀或绑定域名自动生成。

四、后台配置（工具箱设置）

菜单路径：在线工具箱 → 工具箱设置（权限节点 admin/webTool_setting）。

包含四个标签页：

1. 基础设置

  - 启用在线工具箱：关闭后前台 404。

  - 全局 <head> 注入代码：写入每个工具页面的 <head>，用于统计脚本、验证 meta 等；留空则使用 data/web.php 自带 header。

1. 首页 SEO

  - 首页 Title / Keywords / Description，保存后写入 plugins/webTool/data/web.php。

1. 路由配置

  - 访问前缀：默认 webTool，修改后新前缀与旧 /webTool/ 地址均可访问。

  - 独立域名：填写后可在该域名根路径访问工具箱。

1. 工具 SEO

  - 列出全部工具的 Title / Keywords / Description，支持按工具标识或标题实时搜索过滤，可批量修改后统一保存。

保存时会自动清理前台页面缓存与模板编译缓存。

五、独立域名绑定

1. 为该域名添加 DNS 解析，指向本站服务器。
2. 在 Web 服务器（如 Apache/Nginx）新增站点，站点根目录指向 zsadmin 的 public/，并配置好伪静态。
3. 后台「工具箱设置 → 路由配置」填写独立域名（如 tool.example.com），保存。
4. 访问 https://tool.example.com/（首页）或 https://tool.example.com/json/（工具页）。

说明：

• 绑定域名后仍保留 /{前缀}/ 访问方式，方便站内互链与后台预览。
• 在绑定域名下访问时，页面内链接自动改写为根路径；静态资源 /static/webTool/ 路径不受影响。
• 域名格式需为 xxx.com 形式，填写 http:// 或带路径会自动清理。

六、修改访问前缀

• 前缀仅支持小写字母、数字与短横线（31 位以内）。
• 与系统保留路径冲突的前缀不可用（如 admin、static、api、login 等）。
• 修改前缀后旧 /webTool/ 地址继续兼容，页面链接自动改写为新前缀。

七、友情链接与页脚

• 页面底部友情链接优先读取「友情链接」插件的已审核链接，数量取自该插件「侧栏显示条数」配置。
• 「友情链接」插件未启用时，展示内置的默认链接。
• 页脚 Copyright 年份自动取当前年份。

八、目录结构

plugins/webTool/
├── WebToolPlugin.php          # 插件主类（配置、菜单、路由辅助）
├── plugin.json                # 插件元信息
├── routes.php                 # 前台/后台路由（含前缀与域名绑定）
├── common.php                 # 工具函数库
├── controller/
│   ├── Index.php              # 前台控制器（工具分发、SEO 注入、链接改写）
│   └── admin/
│       ├── Base.php           # 后台基类
│       └── Setting.php        # 工具箱设置（基础/SEO/路由）
├── data/
│   ├── web.php                # 各工具 SEO 配置
│   └── QQWry.dat              # IP 归属地数据库
├── src/Net/                   # IP 解析、ICO 生成类
├── view/                      # 前台模板（header/nav/footer/link + index/*.html）
│   └── admin/setting.html     # 后台设置页模板
└── static/                    # 插件静态资源源文件

九、常见问题

• 保存后前台没有变化：本插件保存时会自动清理页面缓存与模板编译缓存；若仍不生效，检查是否启用了外部缓存层。
• 修改被 include 的模板（如 nav.html）不生效：删除 runtime/temp/ 下的编译缓存后刷新。
• 独立域名访问 404：确认域名已解析、Web 服务器已绑定站点且伪静态规则生效；同时确认后台已填写域名并保存。
• 后台不显示「在线工具箱」菜单：进入插件设置页会自动补注册菜单与权限；也可重装/升级插件。
• 工具页 404：确认插件已启用，且访问的工具标识存在对应模板文件。