自定义文章类型是 WordPress 从博客系统升级为内容管理框架的核心能力。当你注册了自定义文章类型后,主题需要为它提供专属的模板文件,才能在前端正确展示。

自定义文章类型的模板层级

WordPress 为自定义文章类型提供了两个核心模板文件:归档模板和单页模板。如果你的文章类型名为 product,WordPress 会依次查找 archive-product.php 来展示产品列表页,以及 single-product.php 来展示单个产品详情页。如果主题中没有这些文件,WordPress 会回退到通用的 archive.php 和 single.php,最终回退到 index.php。

创建归档模板的步骤

复制主题中的 archive.php 作为起点,重命名为 archive-product.php。这样你继承了主题的整体 HTML 结构,只需要修改循环部分。在循环中,可以根据产品类型的特点定制展示内容,比如显示产品缩略图、价格、简短描述,而不是默认的文章摘要。

创建单页模板的步骤

同样以 single.php 为起点,重命名为 single-product.php。在产品详情页中,你可能需要显示自定义字段、产品图库、规格参数等。使用 get_post_meta 或 ACF 的 get_field 函数获取这些数据。

在模板中显示自定义分类法

如果产品使用了自定义分类法,使用 the_terms 函数在模板中输出分类链接。对于层级分类法,还可以使用 wp_list_pages 列出产品层级结构。

条件判断的运用

在模板中使用 is_post_type_archive('product') 判断是否为产品归档页,使用 is_singular('product') 判断是否为单个产品页。这些条件标签可以用于加载特定的样式或脚本。