WordPressには、投稿画面に任意のフィールドを追加する、
カスタムフィールドという仕組みがある。
このカスタムフィールドの使い方や便利なプラグインの使い方を学習しましょう。
WordPressの投稿画面に、任意のフィールドを追加することができる。
フィールドを表示するには、get_post_meta() 関数で取得し表示することができる。
get_post_meta()関数 ・・・ 特定の投稿の特定のキーからカスタムフィールドの値を取得する関数get_post_meta(投稿ID, カスタムフィールドのキー, 単一のカスタムフィールドの値を取得するか？)
省略可
単一のカスタムフィールドの値を取得するか？ : true（する） / false（複数のカスタムフィールドの配列を取得）【初期値】引数の詳細はWordPress Codex 日本語版を参照
<h1 class="p-article__title -detail"><?php the_title(); ?></h1>
<p class="p-article__text">閲覧数：<?php echo esc_html(get_post_meta($post->ID , 'post_views' ,true) ); ?></p>
<?php if ( has_post_thumbnail()) : ?>
<figure class="p-article__eyecatch">
<?php the_post_thumbnail(); ?>
</figure>
<?php endif; ?>
カスタムフィールドを活用すれば、記事の閲覧数をカウントすることができる。
カスタムフィールドの値を自動的に更新する場合は、update_post_meta()という関数を使えばいい。
また、この閲覧数は、ユーザーが編集する必要は特にないので、カスタムフィールドのキーは「_(アンダースコア)」から始める。
update_post_meta()関数 ・・・ 指定した投稿に存在するカスタムフィールドの値を更新する関数update_post_meta(投稿ID, カスタムフィールドのキー, 更新する値, 更新前の値（同じキーをもつ他のカスタムフィールドと区別するため）)
省略可引数の詳細はWordPress Codex 日本語版を参照
記事の閲覧数は記事を表示するたびにカウントすればいいので、「functions.php」に「get_post_status()」を使って、公開されている記事かを確認して、さらに「is_single()」を使って、記事個別ページの時のみ、現在の閲覧数に「1」を足した数字にカスタムフィールドを更新すればよい。
/*======================================
閲覧数のカウント
======================================*/
function update_post_views() {
global $post; // $post にアクセスできるようにする
// 公開されている記事でかつ、個別投稿ページの場合
if ('publish' === get_post_status($post) && is_single()) {
// 現在の閲覧数を整数値で取得
$views = intval(get_post_meta($post->ID, '_post_views', true));
// 現在の閲覧数に「1」を加えた値で更新
update_post_meta($post->ID, '_post_views', ($views + 1));
}
}
add_action('wp_head', 'update_post_views');<p class="p-article__text">閲覧数：<?php echo esc_html(get_post_meta($post->ID , '_post_views' ,true) ); ?></p>
サイトの規模が大きるなると、独自のカスタムフィールドを使いたくなることがある。
テキストフィールドなどの簡単なカスタムフィールドであれば、add_meta_box()という関数を使えば、比較的容易に実装できる。
だが、画像のアップロード機能など複雑なカスタムフィールドになれば、少々高度な開発になる。
あまりプラグインを多用したくない派の僕だが、複雑なカスタムフィールドを作る際は、「Advanced Custom Field」というプラグインが便利。
| 項目 | 設定 |
|---|---|
| フィールドラベル | クライアント名 |
| フィールド名 | client |
| フィールドタイプ | テキスト |
| 説明 | クライアントの名前 |
Advanced Custom Fieldで入力された値を表示する際は、
それ用のテンプレートタグがある。
画面に表示する場合は the_field() を使い、取得する場合はget_field()を使う。
| 項目 | テンプレートタグ |
|---|---|
| 値を表示する | the_field( 'フィールド名' ) |
| 値を取得する | get_field( 'フィールド名' ) |
詳細はthe_field() や、get_field()を参照
<dl class="p-article__metaList">
<?php if( get_field('client') ): ?>
<dt>クライアント</dt>
<dd>
<?php the_field('client'); ?>
</dd>
<?php endif; ?>
<dt>作成日</dt>
<dd>
<time datetime="<?php the_time( DATE_W3C ); ?>" class="p-article__time">
<?php the_time( get_option( 'date_format' ) ); ?>
</time>
</dd>the_field()、get_field()の第2引数に、カテゴリーなら「category_」の後ろにカテゴリーIDを、カスタムタクソノミーなら、term_」の後ろに、タームのIDを指定する必要がある。
<?php the_field('field_name', 'category_123'); ?>the_field()で簡単に出力できる。print_r()などで、確認してから出力するほうがよい。
print_r( get_field('image') );サイドバーに閲覧数が多い順に記事を5件並べてみよう。
<aside class="p-widget -light">
<h2 class="p-widget__title">人気の記事</h2>
<ul>
<li><a href="single.html">記事のタイトル</a> <small class="post-date">5 Views</small></li>
<li><a href="single.html">記事のタイトル</a> <small class="post-date">5 Views</small></li>
<li><a href="single.html">記事のタイトル</a> <small class="post-date">5 Views</small></li>
<li><a href="single.html">記事のタイトル</a> <small class="post-date">5 Views</small></li>
<li><a href="single.html">記事のタイトル</a> <small class="post-date">5 Views</small></li>
</ul>
</aside>| 項目 | 内容 |
|---|---|
| 1ページあたりの表示件数 | 5件 |
| 公開状況 （ post_status）
|
公開された投稿 |
| カスタムフィールドのキー | _post_views |
| 並び変えるパラメータ | 数値として並び替える |
| 並び順 | 昇順 |
<?php
$args = [
'posts_per_page' => 5,
'post_status' => 'publish',
'orderby' => 'meta_value_num',
'meta_key' => '_post_views',
'order' => 'DESC'
];
$the_query = new WP_Query( $args );
?>
<?php if ( $the_query->have_posts() ) : ?>
<aside class="p-widget -light">
<h2 class="p-widget__title">人気の記事</h2>
<ul>
<?php while ( $the_query->have_posts() ) : $the_query->the_post(); ?>
<li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a> <small class="post-date"><?php echo esc_html(get_post_meta($post->ID , '_post_views' ,true) ); ?> Views</small></li>
<?php endwhile; ?>
</ul>
</aside>
<?php endif; wp_reset_postdata(); ?>解答例は全問題のチェックボックスが on になるとご覧いただけます。
商品ページなどブログではないコンテンツを投稿する時に便利な、
任意の項目を作成できる機能がカスタムフィールド。
get_post_meta()で取得できるupdate_post_meta()で更新できる