FinchUI 多语言网站插件

Z-BlogPHP 多语言插件，为 Z-Blog 网站快速添加国际化多语言支持，安装启用后直接生效，不挑主题。支持 15 种语言的子目录访问或独立访问网址（包含二级域名）设置，也可限制指定链接或路径仅允许默认语言访问。内置 9 种翻译接口与共享翻译缓存、中文简繁体互转、多语言 SEO、各语言独立 XML 网站地图、整站预热和汇率换算。前台悬浮语言切换按钮支持左右位置、偏移、颜色、形状、圆角和三种尺寸配置。

版本 1.0.10 更新 2026-09-01 全部作品 作者 星岚工作室
功能介绍 返回官网 立即购买 切换显示样式
  • 2026 09-01

    v1.0.10

    修复网站地图增量任务状态读取错误

    • 修复 修复保存分类等内容时，网站地图增量任务状态读取不存在的 type_index 字段而触发 PHP 8.2 未定义数组键错误的问题。
    • 变更 网站地图任务状态现在分别从完整任务和增量任务的数据结构读取当前内容类型，并安全处理语言索引。
  • 2026 08-29

    v1.0.9

    完善默认语言访问限制、悬浮切换器与网站地图兼容

    • 新增 新增“仅允许默认语言访问的链接或路径”设置，可将指定页面限制为默认语言访问；非默认语言的 GET、HEAD 请求自动跳转到默认语言网址，其他请求安全返回 404。
    • 变更 默认语言专属路径统一接入链接改写、表单语言参数、SEO、网站地图与缓存预热，支持完整网址、站点子目录、查询参数及编码路径场景。
    • 变更 重设计前台悬浮语言切换按钮，支持左下角或右下角、三方向偏移、背景颜色、圆形或方形、可调圆角及大中小三种尺寸。
    • 新增 悬浮按钮新增白色语言图标和当前语言简称角标；语言菜单根据按钮位置向页面内侧展开，小屏幕自动改为向上展开，并支持点击空白处或按 Esc 关闭。
    • 修复 修复网站地图可能保留空语言分片、索引引用不存在文件、默认语言分片边界错误及完整生成期间并发内容变更丢失的问题。
    • 修复 修复保存悬浮按钮设置或迁移等价的旧格式语言网址时误清理已有网站地图的问题；仅在实际语言路由发生变化时清理过期地图。
  • 2026 08-14

    v1.0.8

    重构缓存管理、整站预热与多语言网站地图

    • 变更 翻译缓存改为按内容片段、源语言和目标语言共享；相同文字在不同页面直接复用已有缓存，不会因页面不同重复调用翻译接口。
    • 新增 新增原子写入、请求内去重与 10 分钟短期失败保护，翻译接口临时失败时避免短时间内反复消耗额度；失败日志可由后台开关控制，且不记录原文。
    • 新增 新增独立“缓存管理”页，集中提供缓存有效期、失败日志、清空缓存、首页预热、可暂停恢复的整站预热和失败页面重试。
    • 变更 整站预热按单页任务持久化推进，支持浏览器关闭或休眠后继续；缓存命中时只复用已有译文，未缓存、过期或内容变化的片段才调用翻译接口。
    • 新增 新增可选缓存统计开关，开启后可查看成功缓存、短期失败保护、空间占用和最近写入时间；统计结果缓存 10 分钟，并设有扫描上限保护服务器性能。
    • 修复 修复缓存读取与预扫描可能创建空哈希目录的问题；修复子目录部署下整站预热地址重复拼接，以及多标签页并发预热覆盖任务进度的问题。
    • 新增 新增独立“网站地图”管理页，可为默认语言、子目录语言及独立访问网址语言生成各自的 sitemap.xml 与全站 sitemap-index.xml。
    • 新增 网站地图按首页、文章、独立页面、分类和标签生成 XML 分片，采用静态缓存、原子替换、持久化任务与暂停恢复机制，适合大规模内容站点。
    • 新增 新增当前语言 head Sitemap 链接、robots.txt 地图链接复制与一键生成功能；仅在网站根目录不存在 robots.txt 时创建 Z-Blog 基础规则，已有文件不会被覆盖。
    • 变更 网站地图生成仅查询公开站内内容，不请求前台页面、不调用翻译接口，也不消耗翻译额度。
    • 新增 新增 sitemap-manifest.json，记录内容分片的稳定 ID 范围；文章、页面、分类和标签保存或删除后自动定位并加入受影响分片的更新队列。
    • 变更 新增待更新分片任务，只重建变更内容所在分片的各语言 XML 文件，避免内容更新后执行全站网站地图重建。
    • 新增 内部清单支持可设置有效期的 APCu 加速；未启用 APCu 时自动回退至磁盘清单，并在网站地图管理页提示服务器配置建议。
  • 2026 08-12

    v1.0.7

    修复语言入口链接与默认语言地址

    • 修复 修复子目录语言页面中主题手工配置的语言入口被统一改写为当前语言地址的问题。
    • 变更 默认语言入口统一使用当前网站根地址，无需单独配置，换域名后自动跟随 Z-Blog 网站地址。
  • 2026 08-11

    v1.0.6

    重整访问入口设置，新增主题模板语言切换器

    • 新增 新增独立“访问入口”配置页，集中设置各语言访问网址、访客自动跳转、前台切换器和缓存预热。
    • 新增 新增按语言设置独立网站：启用后该语言可跳转至指定网址，并关闭本站对该语言的翻译与缓存预热。
    • 新增 新增主题模板语言切换器，可使用 {fui_multilang_switcher_dropdown()} 输出下拉菜单，或使用 {fui_multilang_switcher_links()} 输出语言链接列表。
    • 变更 模板语言切换器的样式和交互脚本按需注入 head，当前语言高亮，且语言名称内置跳过翻译保护。
    • 变更 基础设置按新手使用流程重新排布，并调整翻译接口测试与缓存管理的位置。
  • 2026 06-28

    v1.0.5

    翻译缓存改为平台无关共享，切换翻译接口后旧缓存仍然有效

    • 变更 翻译缓存键不再包含翻译接口标识，同一段原文切换翻译平台后无需重新翻译，直接复用已有缓存，降低多平台混用场景的 API 调用成本。
    • 新增 新增旧平台缓存兼容回退机制：切换翻译接口后，已存在的旧平台缓存文件仍会被识别并命中；命中后自动迁移到新的共享缓存目录，保留原有缓存时间，不会变相延长 TTL。
    • 新增 新增缓存键计算独立函数与旧缓存迁移函数，缓存读取、存在检查、写入逻辑统一调整为平台无关的共享哈希，旧平台缓存回退遍历所有已支持的 9 种翻译服务。
  • 2026 06-26

    v1.0.4

    完善 head 区域 SEO 元信息与结构化数据翻译、JS 弹窗与动态文本翻译

    • 新增 新增 <meta> 标签 content 属性翻译，覆盖 description、keywords、og:title、og:description、og:site_name、twitter:title、twitter:description 等 SEO 元信息。
    • 新增 新增 <script type="application/ld+json"> 结构化数据翻译，递归翻译 JSON-LD 中的 name、description、headline、keywords 等字段。
    • 新增 新增 <script> 块中用户可见文字翻译，覆盖 alert/confirm/prompt 弹窗文字以及 jQuery .text()/.html()/.val()/.append() 等动态插入 DOM 的方法。
    • 变更 简繁转换路径同步支持 meta content 与 JSON-LD 结构化数据转换。
    • 变更 抽取 JS 字符串替换公共逻辑，消除 API 翻译与简繁转换两条路径的重复代码。
  • 2026 06-11

    v1.0.3

    修正默认语言入口、SEO 语言标记、缓存预热与访问体验

    • 修复 默认语言不再强制占用根网址，简体中文留空时会稳定回退到 /zh/，同时前台请求识别会优先匹配显式语言路径。
    • 修复 修复 PHP 8.5 下 curl_close 弃用警告污染缓存预热 JSON 响应的问题，避免预热成功却被前端识别为非 JSON 内容。
    • 新增 新增按浏览器设备语言自动跳转功能，可在插件设置中开启；未获取到设备语言或未匹配到已启用语言网站时，将继续显示默认语言网站。
    • 新增 新增 SEO 语言标记联动，自动改写 html lang、og:locale、content-language 等语言标记，并输出 canonical、hreflang alternate 与 x-default。
    • 变更 将旧的域名绑定相关描述统一调整为“独立访问网址（包含二级域名）”，明确二级域名、独立域名或完整 URL 只要解析并绑定到同一个网站即可使用。
    • 变更 缓存预热失败时会展示端点 HTTP 状态、端点路径、目标 URL、cURL 错误与响应片段，便于定位服务器自请求、PHP 报错或拦截问题。
    • 变更 清理未使用的旧兼容标记、零引用辅助函数和后台配置页未使用变量，减少冗余代码。
  • 2026 06-10

    v1.0.2

    优化默认语言与访问入口逻辑

    • 修复 默认语言不再强制占用根网址，简体中文留空时可回退到 /zh/，并兼容旧站原有根网址配置。
    • 变更 翻译缓存迁移到 zb_users/cache/fui_multilang/，并改为按语言与哈希前缀分层存储，降低大站点海量缓存文件的目录压力。
  • 2026 06-03

    v1.0.1

    修复已知问题

    • 修复 修复已知问题，提升插件稳定性
  • 2026 06-02

    v1.0.0

    首次正式发布，支持多语言切换、正文翻译和货币换算

    • 新增 新增多语言网站功能，支持 15 种语言切换
    • 新增 新增语言子目录访问，如 /en/、/ja/
    • 新增 新增独立访问网址绑定，每种语言可绑定二级域名、独立域名或完整 URL
    • 新增 新增前台悬浮语言切换按钮，可开关控制
    • 新增 新增页面内链和表单地址自动改写
    • 新增 新增 html lang 属性自动补充
    • 新增 新增 9 种翻译服务支持：阿里云、腾讯云、百度、有道、火山引擎、DeepL、Google、Microsoft、LibreTranslate
    • 新增 新增翻译结果智能缓存与缓存天数设置
    • 新增 新增翻译段落数量控制，首页和内页可分别设置
    • 新增 新增翻译接口连通性测试工具
    • 新增 新增跳过翻译区域配置（CSS class 白名单）
    • 新增 新增简体中文 ↔ 繁體中文自动转换，词组级别精确映射
    • 新增 新增翻译缓存一键清空功能
    • 新增 新增 16 种货币支持，按语言自动映射
    • 新增 新增实时汇率拉取与本地缓存
    • 新增 新增自定义汇率接口 URL 和请求头
    • 新增 新增汇率缓存一键清空功能
    • 新增 新增汇率来源署名开关与自定义署名 HTML
    • 新增 新增价格节点换汇功能，按标记自动换算价格显示
    • 新增 新增价格节点标记配置，支持 class 和 data 属性识别
    • 新增 新增自定义网址模式，支持关联独立多语言网站
    • 新增 新增后台配置页独立分页：基础设置、货币与汇率
    • 新增 新增自定义网址模式下各语言预览地址与复制功能