【WordPress】1行10文字のコードで、アーカイブ投稿ごとのタグ一覧を出す方法（the_tags()）

投稿：2024/05/15｜ 更新： 2024/05/15 ｜ 1581文字

今回はWordPressファンクションで、1行10文字のコードで、アーカイブ投稿ごとのタグ一覧を出すというのをやってみます。タグ・タクソノミー取得方法はいっぱいありますが、おそらくこれが一番シンプルです。さっそく確認していきましょうか。

タグ一覧つけたい状況～著作権フリー無料曲サイトで、雰囲気をタグで管理している

管理人の持っているサイト、著作権フリー無料曲サイトSSFです。以前調整したときにアーカイブにカテゴリーはつけていたんですけど、タグはまだついていませんでした。

このサイトは曲の雰囲気みたいなのをタグで管理していて、いろいろな種類があるので、一覧に出せるとユーザーが使いやすいかなという想定です。

一番シンプルなのはこれです。アーカイブ・メインループ内なのでパラメータ渡さなくても大丈夫です。メインループ外であれば投稿idを渡す形になります。

<?php the_tags();?>

そのほか、CSSで成形したければ、要素で囲んで任意のclassをつけます。

アーカイブ一覧に、このようにリンク付きのタグリストを出力できました。リストですけど、htmlマークアップはaタグです。liタグで出したい場合は他に方法があります。

上記の例ではaタグが出力されましたが、『タグの名前だけほしい』ということがあるかもしれません。その場合はget_the_tagsでタグのオブジェクトを取得して、nameにアクセスします。管理人は以下のように書きます。

<?php
　$tagobj = get_the_tags();
foreach ( $tagobj as $value ) {
　echo '<span classs=”tags”>' . $value->name . '</span>'.'   ';
}
?>

タグのオブジェクトで使われがちなのは『term_id（タクソノミid），name（名前），slug（スラッグ），count（記事個数）』あたりでしょうか。タグでは使われませんが、階層構造があるタクソノミーの場合は『parent（親カテ・親タクソノミー）』も使うかもしれません。

まとめると、こんなところでしょうか。似ている名前ですが機能は結構違います。状況に応じて使い分けていきたいと思います。

: 【ユーザーデータ取得】WordPress定義済み関数の『get_userdata()』『wp_get_current_user()』ってどのように違うの？

: 【WordPress】カスタム投稿タイプのカテゴリ/タグ取得ファンクション『get_the_term_list』『get_the_terms』挙動の違い