XinTheme Cache 使用文档

后台设置说明

启用插件后,可以在后台进入“设置 -> 静态缓存”进行配置。

缓存过期时间

启用后,缓存页面会在创建指定小时数后过期,由定时任务自动清理刷新缓存。

设置项说明建议
启用缓存过期缓存文件超过指定时间后失效,自动重新生成缓存。内容更新频繁的网站建议开启。
缓存过期小时数例如 24 表示缓存 24 小时后过期。博客可设置 12 到 24 小时,企业站可设置更长。

自动清理策略

插件默认会在文章、评论、分类、用户、插件变化时清理相关页面缓存。如果你希望这些事件发生时清理整个站点缓存,可以在后台开启对应选项。

  • 文章发布、更新或移入回收站时清理站点缓存。
  • 评论发布、更新、标记垃圾评论或移入回收站时清理站点缓存。
  • 术语新增、更新或删除时清理站点缓存。
  • 用户新增、更新或删除时清理站点缓存。
  • 插件启用或停用时清理站点缓存。

移动端独立缓存

开启后,插件会为移动设备生成独立缓存文件。适合移动端 HTML 与桌面端明显不同的网站。

如果网站使用响应式设计,并且移动端和桌面端 HTML 基本一致,可以不启用。

Brotli/Gzip 预压缩缓存

开启后,插件会按浏览器支持情况生成压缩缓存文件,例如 .gz 或 .br,这可以减少 HTML 传输体积。

HTML 压缩

开启后,插件会在写入缓存文件前压缩 HTML。可选是否同时压缩内联 CSS 和 JavaScript。

缓存排除规则

排除项用途示例未设置时默认值
文章 ID指定文章或页面不缓存。2,43,65
页面路径使用正则排除指定路径。/^(\/cart\/|\/checkout\/)$/
查询字符串匹配特定查询参数时不缓存。/^nocache$//^(?!(fbclid|ref|mc_(cid|eid)|utm_(source|medium|campaign|term|content|expid)|gclid|fb_(action_ids|action_types|source)|age-verified|usqp|cn-reloaded|_ga|_ke)).+$/
Cookie访客带有特定 Cookie 时不缓存。/^(woocommerce_items_in_cart|wp_woocommerce_session)_?//^(wp-postpass|wordpress_logged_in|comment_author)_/

查询字符串默认规则的含义是:允许常见统计参数继续使用缓存,例如 utm_sourcegclidfbclid 等;其他查询字符串默认绕过缓存,避免动态页面内容被错误缓存。

这页内容对你有帮助吗?