WordPressのショートコードでforeach文で配列内のテキストを全て表示する方法

2016.07.032016.08.10

photo credit: The Cars At The Roundabout Go Round and Round… via photopin (license)

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

WordPressのショートコードを使って、数件の新着記事をアイキャッチ画像つきで表示する機能の実装を目指して、WordPressの仕組みそしてPHPプログラミングについて研究をしています。

前回はこちらの記事。

WordPressで引数ありのショートコードを作成する方法をとっても丁寧に説明します

WordPressで引数を指定したショートコードの作り方、またshortcode_atts関数を使って引数が省略されている場合のデフォルト値を指定する方法についてお伝えしていきます。

WordPressで引数を指定したショートコードの作り方についてお伝えしました。

さて、数件の新着記事のリストをショートコードで表示するということは、何らかの方法で数件の投稿されている記事のタイトルを取り出して、その一つ一つについて表示するという処理になりますので、いわゆるループ（繰り返し）の処理が必要になります。

PHPではいくつか繰り返しの構文がありますが、今回は配列内の要素ひとつひとつについて繰り返し処理を行うforeach文について使用をしてみましょう。

ということで、今回の記事ではWordPressのショートコードでforeach文の繰り返しを使って複数のテキストを表示する方法についてお伝えします。

ショートコードの位置で配列内のテキストを一行ずつ表示したい
PHPでのforeach文の使い方
配列内のテキストを表示するショートコード
1. 実行結果
まとめ
連載目次：WordPressのショートコードで新着記事を表示する

ショートコードの位置で配列内のテキストを一行ずつ表示したい

まずこんな配列を用意します。

$arr = array('じゃがいも','ニンジン','玉ねぎ','ブロッコリー');

この配列内のテキストを、WordPressの投稿内に一行ずつ順番に表示する方法を考えてみます。

つまり、ショートコードを記載した位置に

じゃがいも ニンジン 玉ねぎ ブロッコリー

というHTMLを出力できればOKということになります。

PHPでのforeach文の使い方

配列内の全ての要素について繰り返しをしたい場合、PHPではforeach文を使います。

書き方としては

foreach(配列 as 配列値の変数):
//処理
endforeach;

とします。

繰り返しの度に、配列の中の要素が順番に「配列値の変数」に格納されます。

配列内のテキストを表示するショートコード

では配列内のテキストを一行ずつ表示するショートコードを作ってみましょう。

こちらのPHPプログラムになります。

//配列内のテキストを出力するprint_text
function print_text($atts){
  $arr = array('じゃがいも','ニンジン','玉ねぎ','ブロッコリー');
  $retHTML='';
  foreach($arr as $text):
    $retHTML.=$text."
";
  endforeach;
  return $retHTML;
}

add_shortcode('text','print_text');

出力するHTML文を格納する変数を$retHTMLとします。

5～7行目のforeach文で、配列$arr内の要素が繰り返しのたびに順番に$textに格納されます。

foreach文の中の処理である6行目ですが、ここは