文章设成「相册」格式,模板目录里也放了 post-format-gallery.php,前台打开的仍是普通文章布局,后台编辑页连格式选择框都没有。碰到这种情况,我一般先确认改动有没有真的生效。
原因不复杂,主题没有声明支持文章格式,编辑器不显示格式面板,post-format-{format}.php 也不会进入模板层级。声明要在 after_setup_theme 里做,晚了就只在部分页面生效。
「文章格式模板不生效」相关的验证我通常做两遍,改完一次、隔天再看一次,确认不是临时生效。别只看报错的最后一行,往上看几行,真正的起因通常在上面。
add_action('after_setup_theme', function () {
add_theme_support('post-formats', ['gallery', 'video']);
});
同类问题如果隔一段时间又出现,多半是某个定时任务或重启流程把改动冲掉了。把这次用到的命令存进笔记,比记住结论有用,换个环境还能照着走。
具体做法是,在 after_setup_theme 回调里加 add_theme_support('post-formats', ['gallery', 'video']);确认模板文件名是 post-format-gallery.php 且放在主题根目录;保存固定链接一次,让模板缓存重建。
最后用这个标准收尾,编辑页出现格式选择框,选中相册后前台加载对应的格式模板。
