WordPress自定义文章类型
WordPress默认的文章和页面只能满足基础内容需求。当你要展示产品、案例、团队、下载资源等结构化内容时，就需要通过**自定义文章类型**来扩展网站内容模型。本文从零开始，教你用代码注册自定义文章类型，并配置固定链接和后台菜单，最后验证数据是否正常保存和展示。
## 适用场景与准备条件
自定义文章类型适合内容有独立字段、独立分类或独立展示逻辑的场景。例如：
- 企业官网的产品展示
- 作品集网站的案例库
- 资源站的下载文件列表
- 活动页面的日程安排
操作前请确认：
- 已安装并启用WordPress，版本建议5.0以上，具体以官方文档为准。
- 拥有主题文件夹的编辑权限，或使用代码片段插件。
- 建议在本地或测试环境先操作，避免影响线上站点。
## 用代码注册自定义文章类型
最直接的方式是在主题的 `functions.php` 中添加注册函数，或者创建一个小型插件。推荐用插件方式，便于切换主题时不丢失功能。
**步骤1：创建插件文件**
在 `/wp-content/plugins/` 下新建文件夹 `my-custom-post-type`，里面创建 `my-custom-post-type.php`，内容如下：
```php
array(
'name' => '产品',
'singular_name' => '产品',
),
'public' => true,
'has_archive' => true,
'menu_position' => 5,
'supports' => array('title', 'editor', 'thumbnail', 'custom-fields'),
'rewrite' => array('slug' => 'products'),
'show_in_rest' => true, // 启用古腾堡编辑器和REST API
);
register_post_type('product', $args);
}
add_action('init', 'mcp_register_product_cpt');
```
**步骤2：启用插件**
登录WordPress后台，进入“插件”列表，找到“My Custom Post Type”，点击“启用”。启用后，左侧菜单会出现“产品”选项。
**步骤3：刷新固定链接**
进入“设置” -> “固定链接”，直接点击“保存更改”按钮。这一步会刷新重写规则，使自定义文章类型的链接生效。
**验证方式**：在后台点击“产品” -> “新建产品”，如果能正常编辑并发布，说明注册成功。前台访问 `你的域名/products/`，应能看到产品归档页。
## 关键参数调整与避坑
注册参数决定自定义文章类型的行为，几个容易踩坑的点：
- `public` 设为 `true` 才会在前台可见。
- `has_archive` 设为 `true` 才有归档列表页。
- `rewrite` 的 `slug` 不要与现有页面或文章别名冲突，否则会导致404。
- `show_in_rest` 设为 `true` 才能使用古腾堡编辑器和REST API，否则只能使用经典编辑器。
- 如果注册后前台404，先检查固定链接是否刷新，再检查 `slug` 是否重复。
**常见报错**：启用插件后白屏，多半是PHP语法错误。检查 `functions.php` 或插件文件是否有多余空格或缺少分号。
## 用插件替代代码方案
如果你不想写代码，可以使用 **Custom Post Type UI** 插件。安装启用后，进入“CPT UI” -> “Add/Edit Post Types”，填写别名、标签，勾选“Public”和“Has Archive”，保存即可。插件方式适合快速测试，但代码方式更利于版本控制和性能优化。
## 效果验证与扩展思路
完成注册后，从三个层面验证：
1. **后台功能**：能新建、编辑、删除产品，能设置特色图像和自定义字段。
2. **前台展示**：访问 `/products/` 看到归档页，点击进入详情页正常显示内容。
3. **数据调用**：在主题模板中使用 `WP_Query` 或 `get_posts` 调用产品数据，例如：
```php
$products = new WP_Query(array('post_type' => 'product', 'posts_per_page' => 6));
if ($products->have_posts()) {
while ($products->have_posts()) {
$products->the_post();
the_title('
