WordPressで記事のタグ名を取得するショートコードを作成

WordPressで記事のタグ名を取得するショートコードを作成しました。

目的

WordPressで全記事に共通して表示されるキャッチコピーやマイクロコピー、固定の文言をより具体化したいと考えたため。

例)
Pythonの解説記事、PHPの解説記事、Javaの解説記事といった風に言語ごとに記事のタグが設定されているサイト構造の場合。

[タグ名(PHPなど)]に関して分からないことがありましたらお問い合わせフォームへ。
[タグ名(PHPなど)]で困ったらこちらのプログラミングスクールがおすすめです。

といた風に表記内容を具体化できる。

作成方法

1. タグ名を取得するPHPファイルをテーマ内に作成

まずはタグ名を取得するためのPHPファイルをWordPressテーマ内に作成します。

get_tag_name.php

<?php
//タグが設定されていないときに表示させたい文言
$ctaTagName = "不明";

//WordPressのタグを取得
$tags = get_the_tags();

//タグを取得できた場合の処理
if ($tags) {
  foreach($tags as $tag) {
    $ctaTagName = $tag->name;
  }
}
echo $ctaTagName;
?>

＊タグ名は１つしか取得できません。

2. functions.phpでショートコードを作成する

functions.phpにショートコードを作成するためのPHPコードを書きます。

functions.php

function tag_echo_php( $atts ){
  ob_start();
  get_template_part('get_tag_name'); 
  return ob_get_clean();
}
add_shortcode( 'TAG_NAME', 'tag_echo_php' );

これによって[TAG_NAME]というショートコードを書くことでget_tag_name.phpが呼び出されるtag_echo_php関数が読み込まれます。

3. ショートコードで確認

あとはタグが設定されている適当な投稿画面で[TAG_NAME]というショートコードを書いてタグを呼び出してみましょう。

参考

WordPressのお役立ち情報