2024年06月14日

WP関数:get_post_meta()


この関数の説明

WP関数の get_post_meta() は、投稿や固定ページの下段にあるカスタムフィールドのデータを取得する関数です。

 


関数

get_post_meta$post_id, $key, $single

 


パラメータ

$post_id (整数)(必須)

カスタムフィールド値を取得したい投稿のIDを指定します。

初期値: なし

 

$key(文字列)(必須)

取得したいカスタムフィールドの名称(キー)を指定します。

初期値: ''

 

$single (真偽値) (オプション)

false  :カスタムフィールドの値を配列で返します。(デフォルト)

 配列と言っても[0]に総てのデータが入るだけなのであまり意味がない。

true   :カスタムフィールドの値を文字列で返します。※お勧め

 


戻り値

指定したカスタムフィールドのキーの値を返します。

 


事例

カスタムフィールドに下記のデータが登録されているとします。

 

①カスタムフィールドのデータを取得する。

<?php 
	$price = get_post_meta(get_the_ID(),'price',true);// priceデータの取得
	echo '$price='.$price.'<br>';
	$size = get_post_meta(get_the_ID(),'size',true);  // sizeデータの取得
	$separator = '/[\s]+/';
	$size_array = preg_split($separator, $size);      // 配列に変換
?>	
<pre>
   <?php print_r($size_array);?>
</pre>

■2~3行目:priceデータを文字列で取得して表示しています。

■4行目:複数値を持つsizeデータを文字列として取得しています。

■5~6行目:空白(デリミタ)で分割して配列に変換しています。

■結果は下記の様になります。

$price=100

   Array
(
    [0] => 80
    [1] => 84
    [2] => 86
)

 


関連情報

関連関数は カスタムフィールド関連関数 を参照してください

またカスタムフィールドを文書更新時にデフォルト設定を行いたい場合は アクションフック:save_post を参照してください。

 


関数一覧
  • 1.WPのエスケープ処理
  • 2.WPプログラムの基本
  • 3.ヘッダ/フッタ/サイドバで使われる関数
  • 4.DBからの読込関数
  • 5.一般テンプレートの中で使われる関数
  • 6.その他のWP関数
  • add_shortcode()
  • bloginfo()
  • body_class()
  • date_i18n()
  • dynamic_sidebar()
  • edit_post_link()
  • esc_attr()
  • esc_html_e()
  • esc_html()
  • esc_url()
  • get_ancestors()
  • get_cat_ID()
  • get_cat_name()
  • get_category_link()
  • get_category_parents()
  • get_category()
  • get_footer()
  • get_header()
  • get_home_url()
  • get_post_format()
  • get_post_meta()
  • get_post_thumbnail_id()
  • get_query_var()
  • get_search_query()
  • get_sidebar()
  • get_site_url()
  • get_stylesheet_directory_uri()
  • get_stylesheet_uri()
  • get_template_directory_uri()
  • get_template_part()
  • get_the_category()
  • get_the_content()
  • get_the_date()
  • get_the_excerpt()
  • get_the_ID()
  • get_the_modified_date()
  • get_the_modified_time()
  • get_the_permalink()
  • get_the_post_thumbnail()
  • get_the_tags()
  • get_the_time()
  • get_the_title()
  • get_uploaded_header_images()
  • get_year_link()
  • has_category()
  • has_custom_logo()
  • has_header_image()
  • has_header_video()
  • has_nav_menu()
  • has_post_thumbnail()
  • has_tag()
  • header_image()
  • home_url()
  • is_admin()
  • is_category()
  • is_date()
  • is_front_page()
  • is_home()
  • is_main_query()
  • is_page()
  • is_search()
  • is_single()
  • language_attributes()
  • the_category()
  • the_content()
  • the_custom_header_markup()
  • the_custom_logo()
  • the_date()
  • the_excerpt()
  • the_ID()
  • the_modified_date()
  • the_modified_time()
  • the_permalink()
  • the_post_thumbnail()
  • the_search_query()
  • the_tags()
  • the_time()
  • the_title()
  • update_post_meta()
  • wp_get_attachment_image_src()
  • wp_nav_menu()
  • WP_Query()