乜嘢係 WordPress 自訂文章類型
WordPress 預設提供咗「文章」同「頁面」兩種內容類型，但係喺構建複雜網站嗰陣，呢啲通常都唔夠用。自訂文章類型（Custom Post Type，簡稱 CPT）係 WordPress 嘅一項核心功能，佢容許開發者創建具有獨立數據結構同後台管理介面嘅全新內容類型。你可以將佢理解為一種「內容模板」，用嚟管理特定類型嘅資訊。
例如，一個電影評論網站可以用預設嘅「文章」嚟寫新聞，同時創建一個叫做「電影」嘅自訂文章類型嚟專門管理電影條目，每個電影條目可以包含導演、主演、評分等專屬欄位。一個電商網站可以創建「產品」類型，一個學校網站可以創建「課程」或者「教師」類型。透過使用 CPT，唔同類型嘅內容可以清楚分開，數據管理更加有效率，亦為之後嘅模板定制同功能擴展打下咗堅實基礎。
點樣創建自訂文章類型
喺 WordPress 度創建自定義文章類型主要有兩種方法：用代碼註冊同用插件。對於開發者嚟講，掌握代碼註冊嘅方式好緊要，因為佢提供咗最高嘅靈活性同控制力，而且方便喺主題或者自定義插件度做版本管理。
推薦閱讀 全面掌握 WordPress 自訂文章類型：從創建到高級應用實踐。
透過代碼註冊自定義文章類型
最標準、最推薦嘅方式係喺主題嘅 functions.php 喺文件或者一個獨立嘅功能插件入面，用 register_post_type 函數進行註冊。呢個函數接受兩個參數：自訂文章類型嘅識別符（slug）同一個包含所有參數嘅陣列。
下面係一個創建名為「電影」嘅自訂文章類型嘅基礎示例：
function create_movie_post_type() {
$labels = array(
'name' => '电影',
'singular_name' => '电影',
'menu_name' => '电影管理',
'add_new_item' => '添加新电影',
'edit_item' => '编辑电影',
'view_item' => '查看电影',
);
$args = array(
'labels' => $labels,
'public' => true,
'publicly_queryable' => true,
'show_ui' => true,
'show_in_menu' => true,
'query_var' => true,
'rewrite' => array( 'slug' => 'movie' ),
'capability_type' => 'post',
'has_archive' => true,
'hierarchical' => false,
'menu_position' => 5,
'menu_icon' => 'dashicons-video-alt',
'supports' => array( 'title', 'editor', 'thumbnail', 'excerpt', 'comments' ),
);
register_post_type( 'movie', $args );
}
add_action( 'init', 'create_movie_post_type' );呢段代碼透過 add_action 掛鉤喺 WordPress 初始化嗰陣執行 create_movie_post_type 函數。函數內部定義咗顯示標籤 $labels 同核心參數 $args。關鍵參數包括：public 控制係咪喺後台同前台顯示；rewrite 定義 URL 重寫規則，呢度訪問單篇電影嘅連結會係 yoursite.com/movie/some-movie；has_archive 決定係咪有歸檔頁面（例如 yoursite.com/movie/）；supports 陣列定義咗呢種內容類型支援嘅功能，好似標題、編輯器、特色圖像等等。
使用插件創建自訂文章類型
對於唔熟代碼嘅用家，插件係快速上手嘅絕佳選擇。Custom Post Type UI 同 Toolset Types 係兩款好流行嘅插件。佢哋提供直觀嘅用戶界面，讓你透過剔選同填寫表格嘅方式定義 CPT 嘅各種屬性，例如標籤、公開性、支援嘅功能等。
插件方式創建簡單快捷，但通常會產生額外嘅數據庫查詢，而且其配置依賴於插件本身。將網站搬遷到其他主機或者進行重大更新時，可能需要額外步驟確保自訂文章類型嘅設定得以保留。因此，對於生產環境或者需要長期維護嘅項目，代碼註冊方式通常係更優選擇。
推薦閱讀 WordPress 主題開發指南:從零開始打造高效能自訂主題。
為自訂文章類型添加自訂欄位
自訂文章類型本身只係提供咗一個結構框架，要令佢真係儲存到獨特嘅資訊（例如電影嘅「上映日期」或者「導演」），就需要自訂欄位或者更強大嘅自訂元框。WordPress 本身有內置嘅「自訂欄位」面板，但係佢嘅介面簡單、功能有限，唔太適合內容編輯者使用。
使用高級自訂欄位外掛
Advanced Custom Fields (ACC) 外掛係處理自訂欄位嘅行業標準。佢允許你透過圖形化介面為唔同嘅文章類型（包括你嘅 CPT）創建各種類型嘅欄位組，例如文字、圖片、選擇框、關聯關係等等。
例如，為「電影」“ CPT 創建一個包含「導演」、「主演」同「上映年份」嘅欄位組。安裝並啟用 ACF 插件之後，進入佢嘅設定頁面，新創建一個欄位組，將佢嘅位置規則設定為「文章類型等於電影」。然後，你可以逐一加入「導演」（文字欄位）、「主演」（文字區域欄位）同「上映年份」（數字欄位）。儲存之後，喺後台編輯電影內容嗰陣，就會見到呢啲直觀嘅輸入框。
透過代碼創建自訂元框
如果你希望完全透過代碼控制，可以為你嘅 CPT 開發自訂元框。呢個涉及使用 WordPress 嘅元框 API 同埋保存函式。雖然代碼量比較大，但係提供咗完全嘅自訂自由。
以下係一個簡化嘅示例，展示點樣為「電影」加一個「導演」欄位：
// 1. 添加元框
function add_movie_director_meta_box() {
add_meta_box(
'movie_director_meta_box', // 元框ID
'导演信息', // 元框标题
'render_movie_director_meta_box', // 回调函数，用于输出HTML
'movie', // 目标文章类型
'side', // 位置
'default' // 优先级
);
}
add_action( 'add_meta_boxes', 'add_movie_director_meta_box' );
// 2. 渲染元框内容
function render_movie_director_meta_box( $post ) {
// 获取已保存的值
$director = get_post_meta( $post->ID, '_movie_director', true );
// 添加安全字段
wp_nonce_field( 'movie_director_nonce_action', 'movie_director_nonce' );
// 输出HTML
echo '<label for="movie_director">导演姓名：</label>';
echo '<input type="text" id="movie_director" name="movie_director" value="' . esc_attr( $director ) . '" style="width:100%;" />';
}
// 3. 保存元框数据
function save_movie_director_meta_data( $post_id ) {
// 检查nonce、权限、自动保存等
if ( ! isset( $_POST['movie_director_nonce'] ) || ! wp_verify_nonce( $_POST['movie_director_nonce'], 'movie_director_nonce_action' ) ) {
return;
}
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
if ( ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
// 保存数据
if ( isset( $_POST['movie_director'] ) ) {
update_post_meta( $post_id, '_movie_director', sanitize_text_field( $_POST['movie_director'] ) );
}
}
add_action( 'save_post', 'save_movie_director_meta_data' );呢段代碼創建咗一個喺側邊欄嘅元框，包含一個用嚟輸入導演姓名嘅欄位。注意數據保存時用咗標準嘅 WordPress 安全檢查流程，包括 nonce 驗證、權限檢查同埋防止自動保存時重複處理。保存嘅數據通過 update_post_meta 函數儲存喺 wp_postmeta 表入面。
推薦閱讀 WooCommerce 插件使用教程：由安裝設定到店鋪營運完整指南。
建立自訂文章類型嘅模板檔案
建立咗 CPT 並填充內容之後，需要為佢提供前端展示嘅模板。WordPress 遵循模板層級系統，會自動搵特定嘅模板檔案嚟顯示你嘅內容。
單篇文章類型模板
當用戶瀏覽單篇電影內容（例如 yoursite.com/movie/inception）時，WordPress 會跟以下次序搵模板檔案：
1. single-movie.php （最具體）
2. single.php
3. singular.php
4. index.php
所以，最佳做法係喺你嘅主題資料夾度開一個名為 single-movie.php 嘅文件。喺呢個文件入面，你可以完全自訂電影嘅展示方式，調用之前建立嘅自訂欄位。
<?php get_header(); ?>
<article id="post-<?php the_ID(); ?>" no numeric noise key 1008>
<header class="entry-header">
<h1 class="entry-title"><?php the_title(); ?></h1>
<div class="entry-meta">
<span>导演：</span>
</div>
</header>
<div class="entry-content">
<!-- 显示其他自定义字段，如主演、上映年份 -->
<p><strong>主演：</strong><?php the_field( 'lead_actor' ); ?></p>
<p><strong>上映年份：</strong><?php the_field( 'release_year' ); ?></p>
</div>
</article>
<?php get_footer(); ?>如果使用 ACF 插件，可以用佢提供嘅 the_field() 函數方便噉輸出欄位值。如果使用自訂代碼保存嘅欄位，就用 get_post_meta() 函數。
歸檔頁面模板
當用戶瀏覽電影清單頁（例如 yoursite.com/movie/）嗰陣，WordPress 會搵：
1. archive-movie.php
2. archive.php
3. index.php
創建 archive-movie.php 呢個檔案，你可以喺裏面用 WordPress 循環嚟列出所有電影，仲可以自訂查詢或者用分頁功能。
<?php get_header(); ?>
<h1>電影庫</h1>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<article>
<h2><a href="/yue/</?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<?php the_post_thumbnail( 'medium' ); ?>
<p>导演：</p>
<?php the_excerpt(); ?>
</article>
<?php endwhile; the_posts_navigation(); else : ?>
<p>暫無電影。</p>摘要
掌握 WordPress 自訂文章類型係脫離簡單網誌模式、建立功能豐富同結構清晰嘅現代網站嘅關鍵一步。從使用 register_post_type 函數進行代碼註冊開始，到通過 ACF 插件或者自訂元框添加特色欄位，再跟住模板層級創建專屬嘅 single-{cpt}.php 同埋 archive-{cpt}.php 模板文件，成個過程構成咗一個完整嘅 CPT 開發工作流程。
透過實戰，我哋創建咗一個「電影」內容類型，佢有獨立嘅後台菜單、專屬嘅數據欄位同埋定制嘅前端展示。呢套方法論可以無縫遷移到「產品」、「作品集」、「活動」等等任何內容需求上面。理解同應用呢啲知識，將會大大提升你作為 WordPress 開發者嘅能力，令你可以為用戶打造真正量身定制嘅數碼化體驗。
常見問題
自訂文章類型同自訂分類法有咩分別？
自訂文章類型用嚟定義一種新嘅內容實體，例如「電影」、「產品」。而自訂分類法（例如標籤、分類目錄嘅擴展）就用嚟對內容進行分類同組織。一個自訂文章類型可以關聯多個自訂分類法。例如，「電影」呢個 CPT 可以關聯「類型」（動作、喜劇）同「地區」（華語、荷里活）兩個自訂分類法。
我應該喺主題嘅 functions.php 定係獨立插件度註冊 CPT？
呢個要睇返個項目有幾複雜同埋可移植性嘅要求。對於同特定主題綁得好緊、唔可以重用嘅 CPT，可以擺喺主題嘅 functions.php 入面。但係最佳做法係整一個獨立嘅功能插件，嚟放晒所有自訂文章類型同分類法嘅註冊代碼。咁樣就算你轉主題，呢啲內容類型同佢哋嘅數據都會保留，網站嘅「功能」同「外觀」就分得更加清楚。
點樣修改現有自訂文章類型嘅固定連結結構？
你可以喺註冊 CPT 喺通過 rewrite 參數設定，亦都可以喺註冊之後用 register_post_type_args 過濾器進行修改。修改之後，必須要訪問 WordPress 後台嘅「設定」 -> 「固定連結」頁面，簡單噉點擊一次「儲存變更」，以刷新重寫規則，否則新嘅連結結構可能唔會生效。
點解我喺前台睇唔到我建立嘅自訂文章類型？
呢個通常係因為註冊參數設定唔當造成嘅。請首先檢查註冊函數嘅 $args 陣列入面嘅 'public' 同埋 'publicly_queryable' 參數係唔係都設定為 true。其次，要確保 'show_ui' 同埋 'show_in_nav_menus' 亦都係 true。最後，檢查模板檔案（single-{cpt}.php 或 archive-{cpt}.php）係咪正確創建並位於活動主題嘅根目錄下。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。