WordPress怎么調(diào)用自定義字段，詳細教程與實用技巧

來自：素雅營銷研究院

方知筆記

2025年08月30日 06:04

什么是WordPress自定義字段

WordPress自定義字段（Custom Fields）是一項強大的功能，允許用戶為文章、頁面或自定義文章類型添加額外的元數(shù)據(jù)。這些字段可以存儲各種類型的信息，如產(chǎn)品價格、作者信息、評分等，大大擴展了WordPress的內(nèi)容管理能力。

自定義字段由鍵（Key）和值（Value）組成，存儲在wp_postmeta表中。通過合理使用自定義字段，開發(fā)者可以創(chuàng)建更復雜的內(nèi)容結構，而不必修改核心代碼或依賴插件。

基本調(diào)用方法

使用get_post_meta()函數(shù)

最常用的調(diào)用自定義字段的方法是使用WordPress核心函數(shù)get_post_meta()：

$value = get_post_meta( $post_id, $key, $single );

參數(shù)說明：

$post_id：文章ID（可選，默認為當前文章）
$key：自定義字段的名稱（鍵）
$single：是否返回單個值（布爾值，true返回單個值，false返回數(shù)組）

示例代碼：

// 獲取當前文章的"price"字段值
$price = get_post_meta( get_the_ID(), 'price', true );
echo '價格：' . $price;

在模板文件中直接調(diào)用

如果你需要在主題模板文件中顯示自定義字段，可以這樣使用：

<?php
$author_name = get_post_meta( get_the_ID(), 'author_name', true );
if( !empty( $author_name ) ) {
echo '<div class="custom-author">作者：' . esc_html( $author_name ) . '</div>';
}
?>

高級調(diào)用技巧

獲取多個自定義字段值

當自定義字段有多個值時（比如復選框選擇的多個選項），可以這樣獲?。?/p>

$features = get_post_meta( get_the_ID(), 'product_features', false );
if( $features ) {
echo '<ul class="features-list">';
foreach( $features as $feature ) {
echo '<li>' . esc_html( $feature ) . '</li>';
}
echo '</ul>';
}

使用短代碼調(diào)用自定義字段

創(chuàng)建一個短代碼來方便地在文章內(nèi)容中調(diào)用自定義字段：

// 注冊短代碼
add_shortcode( 'show_custom_field', 'custom_field_shortcode' );

function custom_field_shortcode( $atts ) {
$atts = shortcode_atts( array(
'field' => '',
'post_id' => get_the_ID(),
'default' => ''
), $atts );

$value = get_post_meta( $atts['post_id'], $atts['field'], true );

return !empty( $value ) ? $value : $atts['default'];
}

使用示例：

[show_custom_field field="price" default="暫無價格"]

在REST API中暴露自定義字段

如果你想通過WordPress REST API訪問自定義字段，需要在functions.php中添加：

add_action( 'rest_api_init', 'register_custom_fields_in_rest' );
function register_custom_fields_in_rest() {
register_rest_field( 'post', 'custom_fields', array(
'get_callback' => function( $post_arr ) {
return get_post_meta( $post_arr['id'] );
},
'schema' => null,
) );
}

常見問題解決方案

自定義字段不顯示的問題排查

檢查字段名稱：確保調(diào)用時使用的字段名稱與保存時完全一致（包括大小寫）
驗證字段是否存在：使用metadata_exists()函數(shù)檢查

if( metadata_exists( 'post', get_the_ID(), 'your_field_name' ) ) {
// 字段存在
}

檢查保存位置：確保自定義字段已正確保存到數(shù)據(jù)庫中

性能優(yōu)化建議

當需要獲取多個自定義字段時，避免在循環(huán)中多次調(diào)用get_post_meta()，這樣會導致大量SQL查詢。替代方案：

// 一次性獲取所有自定義字段
$all_meta = get_post_meta( get_the_ID() );

// 或者使用緩存
$cache_key = 'custom_fields_' . get_the_ID();
$cached_fields = wp_cache_get( $cache_key );

if( false === $cached_fields ) {
$cached_fields = get_post_meta( get_the_ID() );
wp_cache_set( $cache_key, $cached_fields );
}

實際應用案例

創(chuàng)建產(chǎn)品展示模板

假設你有一個產(chǎn)品自定義文章類型，并添加了price、color、size等字段：

<div class="product-details">
<h1><?php the_title(); ?></h1>

<?php
$price = get_post_meta( get_the_ID(), 'price', true );
$color = get_post_meta( get_the_ID(), 'color', true );
$sizes = get_post_meta( get_the_ID(), 'size', false );
?>

<div class="price">價格：<?php echo esc_html( $price ); ?></div>
<div class="color">顏色：<?php echo esc_html( $color ); ?></div>

<?php if( $sizes ) : ?>
<div class="sizes">
<h3>可選尺寸：</h3>
<ul>
<?php foreach( $sizes as $size ) : ?>
<li><?php echo esc_html( $size ); ?></li>
<?php endforeach; ?>
</ul>
</div>
<?php endif; ?>
</div>

在文章列表中顯示自定義字段

在archive.php或category.php中顯示文章列表時添加自定義字段：

while( have_posts() ) : the_post(); ?>
<article>
<h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<?php
$subtitle = get_post_meta( get_the_ID(), 'subtitle', true );
if( $subtitle ) {
echo '<p class="subtitle">' . esc_html( $subtitle ) . '</p>';
}
?>
<div class="excerpt"><?php the_excerpt(); ?></div>
</article>
<?php endwhile;