Z-Blog 主题开了伪静态，附件路径全部变成 404
换服务器顺手把伪静态打开了，首页和文章页都正常，就是图片全裂。右键看地址，路径是对的，浏览器直接输也能打开——说明问题不在文件本身，在 URL 生成规则上。 折腾了大概两小时，记一下。 先分清…
zblog
聚焦 Z-Blog 建站实战：模板文件修改、插件开发、伪静态与 SEO 配置及常见报错排查。
Z-Blog 主题里读自定义字段，Metas 老是取不到值
主题里想给文章加个「阅读时长」字段，后台填了，前台死活读不出来。我一开始以为是字段没存进去，翻数据库才发现数据好好躺在 metacms 表里。 问题在读取方式上。 先确认 Metas 到底挂在…
Z-Blog 主题的 SEO 基础：canonical、description 与结构化数据
主题层面能做的 SEO 其实不多，但漏掉关键的几项，收录效果会明显变差。一、canonical 标签列表分页、带参数的 URL 容易产生重复内容，需要指定规范地址：
Z-Blog 插件与主题的冲突排查：从白屏到定位的步骤
装了插件之后后台打不开、前台白屏，这类问题的排查有固定路径，慌乱重装是最差的选择。第一步：确认是不是插件引起的把 zb_users/plugin/ 下所有插件目录改名，加个 _bak 后缀。再…
Z-Blog 主题适配移动端：viewport 与模板断点的处理
Z-Blog 默认主题很少做移动端适配。viewport 必须写在 header.php 的 head 里，且不能靠 JS 动态插入；断点应按内容区宽度选择，侧栏顺序和图片尺寸也要一起做响应式…
Z-Blog 主题里的缩略图：Thumbs 取值与常见失效原因
列表页要显示缩略图，用 $article->Thumbs 看起来很简单，但实际跑起来经常是空数组。Thumbs 从哪来它的值是文章内容里所有 的 src 提取结果，在文章保存时生成。所以内容里…
Z-Blog 与 WordPress 插件机制对比：钩子设计的两种思路
两个系统都有钩子，但设计哲学的差异会直接影响插件怎么写、以及迁移时有多痛。命名与定位WP 用 add_action / add_filter 两个函数区分“执行动作”和“过滤数据”。Z-Blo…
Z-Blog 主题自定义字段：给文章加一个「副标题」的完整流程
Z-Blog 的 Metas 机制很灵活，但官方没提供图形化建字段的界面，得靠代码完成。整个链路分四段。一、在主题 include.php 里注册字段（可选）添加/编辑文章页默认就有“自定义字…
Z-Blog 主题设置页：main.php 与 Filter_Plugin_Admin_ThemeMng_SubMenu
主题想给用户留几个开关，不必写插件，主题本身就能带设置页。核心是两个文件一加一个钩子。第一步：在 include.php 挂菜单function theme_setting_menu(){ g…
Z-Blog 插件发布前自查清单：15 个容易翻车的点
插件在本地跑通不等于能发。下面这些点是实际踩过的坑，发布前过一遍。文件名与结构目录名与 plugin.xml 里的 id 必须一致，大小写也要一致include.php 第一行要有 if (!…