背景

メルマガの記事作成のため、WordPress で書かれた記事の中の特定のタグが付いた記事のみを取得したいと思いつき、実際に書いたコードについてメモしておきます。

方法

やり方は非常に簡単で、query_posts() 関数に渡すパラメータを指定するだけです。

ExecPHP などの PHP をページ内で実行できるプラグインを有効にして、次のコードを利用しましょう。

この例では、「WordPress」というタグがついた記事の一覧を表示します。
「記事タイトル」を「the_title()」関数で、「パーマリンク」を「the_permalink()」を関数で表示させています。
※「本文」は「the_content()」関数で表示できますが、コメントアウトしています

if(have_posts()) {
while(have_posts()) {
the_post();
echo the_title() . ‘
‘;
echo the_permalink() . ‘
‘;
//echo the_content() . ‘
‘;
}
}
[/code]

「query_posts()」関数に渡している引数「’tag=WordPress’」がポイントで、「tag」に「WordPress」タグスラッグを指定した事になります。

複数形も指定でき、「query_posts(‘tag=WordPress,tips’)」と書けば、「WordPress」と「tips」タグスラッグを指定した事になります。

他にも、「query_posts(‘tag_id=12,34’)」の様に「タグ ID」を指定できる他、「tag__and」「tag__in」「tag__not_in」「tag_slug__and」「tag_slug__in」などに対して複数の「タグ ID」や「タグスラッグ」を配列で指定することが可能です。

参考：テンプレートタグ

「the_post()」関数を実行しないと、次の記事へループが進まないので注意しましょう。

まとめ

WordPress は PHP でできているので、PHP が使えるかつ WordPress の関数を知る事で、大幅にできる事が増えて楽しいですね。