2026年 第15回 記事の分類 Part3

カテゴリーを表示しよう

前回追記したカスタムフィールドの<dl><dt><dd>のリストの最後に、次のコードを追記しよう。

<dl>
	<dt>価格:</dt><dd><?php echo post_custom('価格'); ?></dd>
	<dt>カロリー:</dt><dd><?php echo post_custom('カロリー'); ?></dd>
	<dt>アレルゲン:</dt><dd><?php echo post_custom('アレルゲン'); ?></dd>
	<dt>カテゴリー:</dt><dd><?php the_terms( $post->ID, 'menu_category' ); ?></dd>
</dl>

メニューのカテゴリーがリンク付きで表示された。

the_terms 関数は、その記事に紐付けられたタクソノミー/ターム情報を表示するWordPressの関数。
第一引数には記事ID、第二引数にはタクソノミーを指定。
第一引数は $post->ID と書くと現在表示している記事のIDが動的に設定される。第二引数は「メニュー」のカテゴリーのスラッグ「menu_category」を指定。ちなみに第三引数はタームリストの前に表示する語句、第四引数は各タームを区切る文字列(デフォルトは半角カンマ)、第五引数はタームリストの後に表示する語句で、いずれも省略可能。

(WordPressの関数のルールの話)
the_ から始まる関数はechoを付けなくても画面に出力される

WordPressに備わっている関数のうちthe_から始まる関数は、テンプレート内で使用することを想定しているために内部にecho / printコマンドが含まれている。the_title = タイトル、the_content = 本文など、関数名を書いただけで画面に出力される。

これらに限らず、テンプレート上での使用を想定した関数群を、WordPressは「テンプレートタグ」と呼ぶ。

参考)テンプレートタグ
https://codex.wordpress.org/Template_Tags (英語)

実際の現場でよく使われる記述(厳密な書き方)

// 詳細ページ かつ 投稿タイプ「カフェメニュー」の場合のみ、メタ情報を表示
if ( is_single() && 'cafe-menu' === get_post_type() ) {
	?>
		<dl>
			<dt>価格:</dt><dd><?php echo esc_html( get_post_meta( get_the_ID(), '価格', true ) ); ?></dd>
			<dt>カロリー:</dt><dd><?php echo esc_html( get_post_meta( get_the_ID(), 'カロリー', true ) ); ?></dd>
			<dt>アレルゲン:</dt><dd><?php echo esc_html( get_post_meta( get_the_ID(), 'アレルゲン', true ) ); ?></dd>
		</dl>
	<?php
}

is_single 関数は、現在開いているページが詳細ページならtrueを返す「コンディショナルタグ」。
get_post_type 関数は、現在開いているページの投稿タイプを取得する関数。
「&&」は「かつ」「AND」をあらわす論理演算子。
「==」は「等しい」ことをあらわす論理演算子。
「===」は、値の型(int / str / boolean)も含めて評価する論理演算子。
  → 「==」だと、数値の 1 もテキストの “1” も 真偽値の true も同じと判定されてしまう!(バグの温床)
esc_html 関数は、値を無害化するサニタイズ関数(get_post_meta関数が正常/安全な値を返すとは限らないので)。
get_post_meta 関数は、記事のカスタムフィールドを取得する関数。第一引数に取得する記事のID、第二引数にカスタムフィールド名、第三引数は複数の値が登録されているときに1つのみ返すかどうか(falseの場合は複数の値が配列で返されるので、ループで回して出力する必要がある)。
get_the_ID 関数は、記事のIDを取得する関数。

参考)コンディショナルタグ
https://codex.wordpress.org/Conditional_Tags (英語)

グローバルメニュー「Menu」のリンク先を変更

現在、グローバルメニューの「Menu」のリンク先は、当初作成した「Menu」という固定ページになっている。これを、今回作成した「メニュー」投稿タイプのアーカイブページに変更する。

  • 外観 > メニュー をひらく
  • 左ペインの「カスタムリンク」をクリックしてひらき、下記のように入力
  • メニューに追加 をクリック
  • 最後に追加されるので、元々あった「Menu」の上までドラッグして並べ替える
  • 元々あった「Menu」をクリックしてひらき、削除する
  • メニューを保存 ボタンをクリック

以上で、グローバルメニューの「Menu」が新しいメニュー一覧ページへリンクされる。

実際には、さらにメニューの一覧ページ、詳細ページのデザイン調整が必要になるが、省略する。

?>
<dt>出版社:</dt><dd>
<?php 
$publisher = SCF::get( 'publisher' );
if ( $publisher ) {
    foreach ( $publisher as $postid ) {
        $title = get_the_title( $postid );	
        $link  = get_permalink( $postid );
        ?>
            <a href="<?php echo $link; ?>"><?php echo $title; ?></a>
        <?php
    }
}
?>
</dd>
<?php

ついでに、PHPの基本のおさらい

PHPの記述例: <?php the_meta(); ?>

  • 開始タグ:<?php
  • 終了タグ: ?>
  • 一連のコードの最後はセミコロン「;」で終わる。
  • 関数は、後ろに丸括弧「()」が付いていることで判別できる。関数とは、一連のよく使う処理をひとかたまりのコードにしたパッケージ。電子レンジや洗濯機のコース設定のようなもの。”おまかせ”にせず条件を指定したい場合は丸括弧内に条件を書く。これらの条件または関数が処理する材料のことを引数という。その関数がどんな引数を受け入れるかは関数次第なので、関数の仕様を確認する必要がある。
  • 複数の引数を受け付けることも多く、その場合はそれぞれ半角カンマで区切る。それぞれを第一引数、第二引数、第三引数…と呼ぶ。
  • post_custom( '著者' ) の場合はカスタムフィールドの値を取り出す関数に対して、第一引数に「著者」という条件を与えたことで、登録されたカスタムフィールドのうち「著者」の値のみ取り出すことができた。
  • 変数はドル記号「$」で始める。変数は値を一時的に格納する入れ物。その後の処理へ渡すために使う。
  • 変数や関数は、それ自体を書くだけでは基本的には画面に表示されない(関数内部にechoやprintが含まれていれば表示される)。なぜなら、多くの変数や関数は他の処理と組み合わせて前処理/後処理をし、最終的に画面出力するという流れが前提なので、意図的に「画面に表示する」というコマンド = echo / print を書かないと画面には出力されない。その点、HTMLは画面に出力することが目的のため、何もコマンドを書かずとも画面に出力される。

関数、変数、それらを組み合わせたシンプルな条件分岐の記述例

<?php
$price = post_custom( '価格' ); // 「価格」カスタムフィールドの値を取り出して変数に一時的に格納
if ( $price ) {
    echo $price;
} else {
    echo '情報がありません';
}
?>

実際にコードを試してみよう

上記のコードをコピーし、Visual Studio Codeで content.php をひらき、一番最後の行の最後で改行し、ペースト、保存する。実際の商品ページをひらくと、下の方に価格が単独で表示されているのが確認できる。

ここで、その商品の編集画面をひらき、カスタムフィールド「価格」の値を削除して空欄にしてみよう。

再度、商品ページを再読み込みしてみると「情報がありません」と表示されるはず。

コードの解説

  • if〜else〜endifという書式で、ifの丸括弧に書いた条件に応じた出し分けができる。これを条件分岐と呼ぶ。分岐したそれぞれで処理内容は波括弧 {} で囲むことで複数行に渡る内容もまとめて処理できる。
  • PHPの内部で文字列を扱う場合はシングルクォート「’」またはダブルクォート「”」で囲む。
  • 数字はクォートで囲まない場合は数値として扱われ、囲む場合は文字列として扱われる。
  • スラッシュ2つ「//」を付けるとそれ以降はコメント=メモとして機能には影響せず、コードの意図などをメモしておくことができる。

PHPはhtmlと混ぜこぜで書けるので気軽で便利であり、一方でソースコードが複雑になるので可読性が悪くなりがち(htmlとjavascriptとcssとphpが同居…カオス。。。。)そんなときも、Visual Studio Codeなどのエディターを使うと自動で色分けしてくれるので便利。

PHPの印象として、他の言語と比較して文字列の加工が便利な印象がある。文章の何文字目から何文字目を抜き出す(mb_substr)、全角→半角に変換(mb_convert)なども便利な関数があらかじめ用意されている。WordPressには専用の関数がたくさんある上に、それらPHP自体の便利な関数で自由に加工し、その値をJavaScriptに渡したり、HTMLやCSSと混ぜこぜに書くことができるので、Webにはとても都合のよい便利な言語、という印象がある。

ちなみにここ十数年ぐらいのWebサービスに使われる人気の言語/環境の組み合わせをあらわす「LAMP」という言葉が存在する。

  • L = linux(サーバーOS)
  • A = apache(Webサーバー)
  • M = MySQL(データベース)
  • P = PHP(スクリプト言語)

そのぐらい、PHPはWeb関連に使用する言語としてポピュラーな言語といえる。ただし、近年はJavaScriptやそこから派生した言語(Node.js、TypeScriptなど)や、それらを使いやすくするライブラリ・フレームワーク(React.js、Next.js、Veu.jsなど)が人気になりつつあり、現にWordPressの最新テーマの開発にはReact.jsが用いられている。時代とともにトレンドも変わる。

以上


ミニテスト

Subscribe
Notify of
guest
0 Comments
Oldest
Newest Most Voted
0
Would love your thoughts, please comment.x
()
x