• Text Field
• Number Field
• Textarea Field
• Wysiwyg Editor Field
• Image Field

• File Field
• Select Field
• Checkbox Field
• True / False Field
• Radio Field

• Date Picker Field
• Color Picker Field
• Relationship Field
• Page Link Field
• Post Object Field

Text Field は、単一行のテキストを入力できます。

URL や E-mail かをチェックするバリデーション機能はありません。

フィールド定義時のオプション

フィールドの値に HTML を含むときの動作を指定できます。

・無：HTML タグとして認識せず、文字列としてそのまま吐き出します。

・HTML：HTML タグとして認識します。

フィールド入力

フィールド出力

〒<?php the_field('zip_code',$post->ID); ?>

Number Field は、単一行のテキストを入力できます。

数字以外の入力があると、保存時にエラーも出さずに数字以外を無視して保存します。

フィールド入力

右側の▲/▼をクリックすると数値が 1 ずつ増減します。

フィールド出力

<?php
$uriage = get_field('uriage',$post->ID);
echo number_format($uriage);
?>

Textarea Field は、複数行のテキストを入力できます。

フィールド定義のオプション

改行の扱いはフィールド設定時に決めることができます。

フィールド入力

フィールド出力

<!-- 改行指定をしたとき -->
<p><?php the_field('memo',$post->ID); ?></p>
<!-- 改行指定をしなかったとき -->
<p><?php echo nl2br(get_field('memo',$post->ID)); ?></p>

Wysiwyg Editor Field は、TinyMCE でテキストを入力できます。

フィールド定義時のオプション

ツールバーの形態やアップロードボタンの有無を選択できます。

フィールド入力

フィールド出力

<?php the_field('other',$post->ID); ?>

Image Field は、画像をアップロードできるインターフェイスを提供します。

アップロードした画像は、ポストの添付画像として管理されます。

フィールド定義のオプション

カスタムフィールドに保存する値は、画像オブジェクト、画像 URL、画像 ID から選択できます。

フィールド入力

フィールド出力

<!-- 画像オブジェクトを設定した場合 -->
<?php
$attachment_obj = get_field('photo',$post->ID);
echo wp_get_attachment_image( $attachment_obj->ID, "full" );
?>

<!-- 画像 URL を設定した場合 -->
<img src="<?php the_field( 'photo',$post->ID); ?>" alt="" />

<!-- 画像 ID を設定した場合 -->
<?php
$attachment_id = get_field('photo',$post->ID);
echo wp_get_attachment_image( $attachment_id, "full" );
?>

<!-- 画像 ID を設定した場合 -->
<?php
$attachment_id = get_field('photo',$post->ID);
$image_attributes = wp_get_attachment_image_src($attachment_id);
$url = $image_attributes[0];$w = round($image_attributes[1] / 2); // 実寸の半分
$h = round($image_attributes[2] / 2); // 実寸の半分
$alt = get_post_meta($attachment_id, '_wp_attachment_image_alt', true);
?>
<img src="<?php echo $url; ?>" width="<?php echo $w; ?>" height="<?php echo $h; ?>" alt="<?php echo $alt; ?>" />

File Field は、ファイルをアップロードできるインターフェイスを提供します。

フィールド定義時のオプション

カスタムフィールドとして保存する値は、ファイルオブジェクト / ファイルURL / ファイルID から選択できます。

フィールド入力

フィールド出力

<!-- URL を設定した場合 -->
<a href="<?php the_field('file',$post->ID); ?>">ダウンロード</a>

Select Field は、フィールド設定時に登録した項目をドロップダウンリストから選択できます。

フィールド定義時のオプション

選択オプションやデフォルト値の他に、単一選択か複数選択かを選べます。

フィールド入力

フィールド出力

<!-- 単一選択のとき -->
<p>都道府県：<?php the_field('prefecture',$post->ID); ?></p>
<!-- 複数選択のとき -->
<p>都道府県：<?php echo implode(', ', get_field('prefecture',$post->ID)); ?></p>
<p>都道府県：
<?php
$prefectures = get_field('nation',$post->ID);
$n = 0;
foreach ($prefectures as $prefecture) :
   if ($n==0) echo $prefecture;
   else       echo ', '.$prefecture;
    $n++;
endforeach;
?>
</p>

<!-- if 文　単一選択のとき -->
<?php
if(get_field('prefecture',$post->ID) == "東京都") :
    //...
    endif;
    ?>

<!-- if 文　複数選択のとき -->
<?php
if( in_array('北海道',get_field('prefecture',$post->ID))) :
    //...
    endif;
    ?>

Checkbox Field は、フィールド設定時に登録した項目を複数を選択できます。

フィールド定義時のオプション

選択肢を入力します。

フィールド入力

フィールド出力

<!-- 日本にチェックがあるかの判断 -->
<?php if (in_array('日本', get_field('nation',$post->ID))) : ?>
    <p>日本にチェックがあります。</p>
    <?php endif; ?>

<!-- 日本とアメリカ合衆国の両方にチェックがあるかの判断 --><?php
$nations = get_field('nation',$post->ID);
if (in_array('日本', $nations) && in_array('アメリカ合衆国', $nations)) :
?>
    <p>日本とアメリカ合衆国の両方にチェックがあります。</p>
<?php endif; ?>

<!-- カンマ区切りで出力 -->
<p>国：<?php the_field('nation',$post->ID); ?></p>

<!-- カンマ区切り以外で出力 -->
<p>国：<?php echo implode(' ', get_field('nation',$post->ID)); ?></p>
<p>国：
<?php
$nations = get_field('nation',$post->ID);
$n = 0;
foreach ($nations as $nation) :
    if ($n==0) echo $nation;
        else       echo ' '.$nation;
    $n++;
    endforeach;
?>
</p>

True/False Fieldは、一つだけのチェックボックスを作成します。

ON = True , Off = false の値を持つ簡易版チェックボックスフィールドです。

フィールド定義時のオプション

フィールド入力

フィールド出力

<?php
if (get_field('company_info',$post->ID)==true) : // 会社データなし
    echo '<p>この会社の情報は登録されていません。</p>';
else :
    //
    // 会社の情報を表示
    //
endif;

Radio Field は、フィールド設定時に登録た項目を一つだけ選択することができます。

フィールド定義時のオプション

フィールド入力

フィールド出力

<p>色：<?php the_field('color',$post->ID); ?></p>

Date Picker Field は、日付をテキストかカレンダーで入力できるインターフェイスを提供します。

フィールド定義時のオプション

保存と表示のフォーマットを指定します。

フィールド入力

フィールド出力

<p>誕生日：<?php the_field('birthday',$post->ID); ?></p>
<?php
/*
*  Create PHP DateTime object from Date Piker Value
*  this example expects the value to be saved in the format: yy_mm_dd (JS) = Y_m_d (PHP)
*/
$date = DateTime::createFromFormat('Y_m_d', get_field('date_picker',$post->ID));
echo $date->format('d-m-Y');
?>

Color Picker Field は、色をテキストかカラーピッカーで入力できるインターフェイスを提供します。

フィールド定義時のオプション

デフォルト色を設定できます。

フィールド入力

フィールド出力

<div id='box' style="background-color:<?php the_field('b_color',$post->ID); ?>">
    :
    </div>

Relationship Field は、関連するポストをセレクションから複数選択できます。

フィールド定義時のオプション

フィールド入力画面で選択する関係ポストを、投稿タイプやタームで絞り込んでおくことができます。

フィールド入力

選択したポスト（右側のポスト）は Drag & Drop で順序を決めることができます。

フィールド出力

<?php
$my_posts = get_field('relationship',$post->ID);
if( $my_posts ):
  echo '<ul>'.PHP_EOL;
    foreach( $my_posts as $post) :
        setup_postdata($post);
?>
    <li>
      <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
    </li>
<?php
endforeach;
echo '</ul>'.PHP_EOL;
  wp_reset_postdata();
endif;
?>

• select
• checkbox
• radio
• true / false

で指定できます。これらのフィールドの AND 演算 / OR 演算も指定できます。

フィールド定義時のオプション

例えば、「職業」を選択するラジオボタンがあり、
「その他」を選択したときだけ「その他」の Text Field に職業を入力したいことはよくあります。

フィールド入力

Radio で「その他」以外の職業を選択した場合、Text Field「その他」は表示されません。

<?php
the_field($field_name, $post_id);
// $post_id は、ポストの ID とは限りません。
$post_id = null; // current post
$post_id = 1;
$post_id = "option";
$post_id = "options"; // same as above
$post_id = "category_2"; // save to a specific category
$post_id = "event_3"; // save to a specific taxonomy (this tax is called "event")
$post_id = "user_1"; // save to user (user id = 1)
?>

<?php
echo get_field($field_name, $post_id);
// $post_id は、ポストの ID とは限りません。
$post_id = null; // current post
$post_id = 1;
$post_id = "option";
$post_id = "options"; // same as above
$post_id = "category_2"; // save to a specific category
$post_id = "event_3"; // save to a specific taxonomy (this tax is called "event")
$post_id = "user_1"; // save to user (user id = 1)
?>

<?php
if ( get_field('repeater') ):
  while( has_sub_field('repeater') ):
  ?>
      <div>
          <img src="<?php the_sub_field('image'); ?>" alt="<?php the_sub_field('alt'); ?>" />
              <p><?php the_sub_field('content'); ?></p>
    </div>
  <?php endwhile; ?>
  <?php endif;

<?php\
the_sub_field($sub_field_name);
?>

// Field Name で更新
$field_name = "text_field";
$value = "some new string";
update_field( $field_name, $value );
// Field Key で更新
$field_key = "field_5039a99716d1d";
$value = "some new string";
update_field( $field_key, $value );
// 配列で更新
$field_key = "field_5039a9973jsd1d";
$value = array("red", "blue", "yellow");
$post_id = 123;
update_field( $field_key, $value, $post_id );

Array
(
    [key] => field_4fea85f5320da
        [label] => Text Field
    [name] => text_field
        [type] => text
            [instructions] =>
                [required] => 0
                    [default_value] =>
                        [formatting] => html
                            [order_no] => 0
    [value] => Use the option parameter to toggle loading the value
)

<?php
$field_name = "text_field";
$field = get_field_object($field_name);
echo $field['label'] . ': ' . $field['value'];
?>