ショートコードで簡単解決！WordPress固定ページにカテゴリ一覧を編集する方法

2015/03/18 2015/12/27

プラグインなしでカテゴリ一覧を作成

ショートコードでカテゴリ一覧を作成

　
WordPressをブログとして使う分には関数を作って、ショートコードを作成して、といったことが発生する機会はほぼないワケですが、ブログじゃない見せ方のサイトを作ろうかなぁと思った時にはショートコードは非常に強い味方となってくれる仕組みなのです。
　
というわけで、今回は、ショートコードを利用して、固定ページや特定の投稿に特定のカテゴリの投稿一覧を作成する処理を作ってみましたので、解説しようと思います。
　
　
ショートコードの記載の方法については、「WordPress投稿にPHPを記述するショートコードの使い方add_shortcode」に記事を書いていますので、参考にしてみてください。
　
また、上記の記事内でショートコードをテンプレート内で実装する方法も記載しています。
一度ショートコードを作っておけば、記事内だけではなくてテンプレート内でも使えますので、覚えておいて損はない仕組みですね。
　
　
ただ、そのままではウィジェットでは使えませんので、ウィジェットにも編集したいという場合には「WordPressのウィジェットでショートコードを使う方法add_filter」の記事を読んでみてください。
ちょっとした処理を追加することで対応できるようになります。
　
　

カテゴリ一覧を編集するソース

　
対応する内容は、「functions.php」にプログラムを記述し、それを呼び出すショートコードを固定ページや投稿に記述する、という内容になります。
　
　

functions.phpに関数を追加

　
functions.phpに下記のソースを記載します。
　

// ショートコードで呼び出す関数
function Category_List ( $arg = array () ) {
  extract ( shortcode_atts ( array (
    'category'       => '1',
    'posts_per_page' => '5'
  ), $arg ) );

  $blog_posts = get_posts ( array ( 
    'posts_per_page' => $posts_per_page,
    'category'       => $category
  ));

  $html = Create_Html($blog_posts);
  return $html;
}
add_shortcode('categorylist', 'Category_List');

// HTMLを生成する関数
function Create_Html ( $blog_posts ) {
  $html = '<div>';
  foreach ( $blog_posts as $post ) {
    $html .= '<p>' . get_post_time('Y.m.d') . '</p>';
    $html .= '<p><a href="' . get_permalink($post->ID) . '">' . $post->post_title . '</a></p>';
  }
  $html .= '</div>';
  return $html;
}

// ショートコードで呼び出す関数

function Category_List ( $arg = array () ) {

extract ( shortcode_atts ( array (

'category' => '1',

'posts_per_page' => '5'

), $arg ) );

$blog_posts = get_posts ( array (

'posts_per_page' => $posts_per_page,

'category' => $category

));

$html = Create_Html($blog_posts);

return $html;

}

add_shortcode('categorylist', 'Category_List');

// HTMLを生成する関数

function Create_Html ( $blog_posts ) {

$html = '<div>';

foreach ( $blog_posts as $post ) {

$html .= '<p>' . get_post_time('Y.m.d') . '</p>';

$html .= '<p><a href="' . get_permalink($post->ID) . '">' . $post->post_title . '</a></p>';

}

$html .= '</div>';

return $html;

}

　
　
「functions.phpって何？」っていう方には「WordPressの functions.phpがある場所」という記事を書いていますので、こちらも読んでみてください。
　
　

記事に記載するショートコード

　
実際にカテゴリ一覧を編集する場合には、投稿に下記のソースコードを記載します。
　

[categorylist category='2' posts_per_page='5']

1	[categorylist category='2' posts_per_page='5']

　
「category」は、カテゴリの IDになります。表示したいカテゴリを編集します。
「posts_per_page」は、表示する件数を編集します。
　
この仕組みではページ送りの処理は含まれていませんので、「最新 5件」を表示するといった想定になっています。
　
また、「posts_per_page => -1」の様に「-1」を指定すると、1ページの表示制限をなくすことができます（全件表示になります）。
　
　

本格ビジネスサイトを作りながら学ぶ WordPressの教科書 Ver.4.x対応版

カテゴリ一覧を編集するソースの解説

　
ショートコードの基本的な理解は最初にも書きましたが、「WordPress投稿にPHPを記述するショートコードの使い方add_shortcode」に記載していますので、そちらを読んでください。
　
ショートコードで、「Category_List」という関数を呼び出します。
引数として、「category」「posts_per_page」を受け取ります。
引数がない場合は、「category => 1（未分類）」、「posts_per_page => 5」（5件表示）がデフォルト値として設定されます。
　
7行目の「get_posts()」で、引数で受け取ったカテゴリから件数分の記事を取得します。
それを、12行目の「Create_Html関数」に送って HTMLを生成します。
　
決まりきった HTMLを生成できればいいのならば、「Create_Html関数」は関数化する必要はないのですが、カテゴリごとに編集する HTMLを変えたい場合には、下記のような感じで「Create_Html関数」を分けておく方が便利なんじゃないかな、ということで関数を分けています。
　

  if ( $category == '3' ) {
    $html = Create_Html3($blog_posts);
  } else {
    $html = Create_Html($blog_posts);
  }

if ( $category == '3' ) {

$html = Create_Html3($blog_posts);

} else {

$html = Create_Html($blog_posts);

}

　
まぁ、ショートコードの引数に HTMLの区分を追加して、その区分で「Create_Html関数」を振り分けるようにしておく方が使い勝手はよさそうですね。
　
　
また、投稿から取得する値として、「タイトル」を「$post->post_title」として取得していますが、同様にいろいろな値が取得可能です。
下記のサイトが参考になりましたので、併せて紹介しておきます。
　http://weble.org/2012/04/23/wordpress-post-data
　
　

「query_posts」ではなく「get_posts」関数を使おう

　
最初に参考にしたサイトでは、投稿情報を取得する際に「query_posts」が使われていました。
　
ですが、下記の様に「query_posts」関数は推奨されていない関数ですので、「get_posts」関数を使いましょう。
　http://notnil-creative.com/blog/archives/1688
　
実際に「query_posts」のままでは想定した動きになりませんでしたからね。
　
　
この記事では一覧表示をすることを主眼に解説しましたが、カスタムフィールドも利用した抽出条件、ソート条件を設定する方法を含めた解説記事を「ショートコードで簡単解決！カスタムフィールドでソート、抽出条件設定方法」に書きましたのであわせて参考にしてください。
（2015.05.25　追記）

- WordPressのプラグイン

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: Rich ReviewsでWordPressに口コミサイトを簡単に構築する方法

口コミサイトに必要なレビュー投稿機能を提供するプラグインです。独自のフォームをショートコードで編集する自由度が高い設計で、平均点の表示も用意されています。

: カスタム投稿をCustom Post Type UIで設定し編集する方法解説

カスタム投稿を追加、管理するプラグインCustom Post Type UIの使い方の解説です。プラグインの解説ではあるものの、カスタム投稿の仕様の解説でもあります。

: Advanced Custom Fields（ACF）のアドオン・ギャラリーの使い方解説

Advanced Custom Fieldsのアドオン・ギャラリーの解説記事。複数の画像を入力できる優れもので、画像のサイズ、容量などでの制限ができ、より厳密な管理が可能。

: WordPress・Contact Form7、MW WP Form共通　細かなデザイン調整方法

お問い合わせフォームプラグインの Contact Form7、MW WP Formにおけるラジオボタン、チェックボックスなどの見た目を調整する小技を紹介。

: SEO効果絶大！PVもアップするWordPressの高速化プラグイン元祖Lazy Load

Lazy Loadは、画像を最初にまとめて読み込むことで発生するスピードの遅延を防ぎ、必要な画像から順番に読み込むことでページの表示スピードを向上させるプラグインです。

: カテゴリ・タクソノミーのタームの順番を自由に並び替えるプラグイン・Category Order and Taxonomy Terms Order

標準機能では行えないカテゴリやタクソノミーの並び替えを行うプラグインCategory Order and Taxonomy Terms Orderの紹介です。

: SEO効果絶大！PVもアップするWordPressの高速化プラグインBJ Lazy Load

Lazy Load系の処理を使い画像だけでなくiframe等表示スピードに影響があるものを総合的に対策。入れるだけで高速化するので使わない手はない！

: シンタックスハイライトの5システム比較のまとめ・WordPressでも使える

シンタックスハイライト5種の比較検討のまとめ記事。WordPressで使う目的だがプラグインの比較検討ではないのでどのサイトでも導入可能。

: WP Reviewを使ってWordPressのレビューサイトを構築

レビューサイトを構築するプラグインです。複数の評価者による評価点投稿やページごとに配色を変更する機能、機能満載なウィジェットなどレビューサイト構築に最適です。

: WP-PostRatingsでWordPressに自由度が高い口コミサイトを構築

口コミの評価点を投稿する機能に特化したプラグインで、多様なイメージと投稿方法が用意されていてサイトにあったイメージを選択できます。

PREV: WordPressのデータベース管理プラグインの決定版！Adminer
NEXT: SEO効果絶大！PVもアップするWordPressの高速化プラグインBJ Lazy Load

日	月	火	水	木	金	土
					1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28	29	30

ショートコードで簡単解決！WordPress固定ページにカテゴリ一覧を編集する方法

プラグインなしでカテゴリ一覧を作成

ショートコードでカテゴリ一覧を作成

カテゴリ一覧を編集するソース

functions.phpに関数を追加

記事に記載するショートコード

カテゴリ一覧を編集するソースの解説

「query_posts」ではなく「get_posts」関数を使おう

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

Rich ReviewsでWordPressに口コミサイトを簡単に構築する方法

カスタム投稿をCustom Post Type UIで設定し編集する方法解説

Advanced Custom Fields（ACF）のアドオン・ギャラリーの使い方解説

WordPress・Contact Form7、MW WP Form共通　細かなデザイン調整方法

SEO効果絶大！PVもアップするWordPressの高速化プラグイン元祖Lazy Load

カテゴリ・タクソノミーのタームの順番を自由に並び替えるプラグイン・Category Order and Taxonomy Terms Order

SEO効果絶大！PVもアップするWordPressの高速化プラグインBJ Lazy Load

シンタックスハイライトの5システム比較のまとめ・WordPressでも使える

WP Reviewを使ってWordPressのレビューサイトを構築

WP-PostRatingsでWordPressに自由度が高い口コミサイトを構築

カスタムフィールド決定版！Advanced Custom Fields全項目完全解説・管理画面編

Advanced Custom Fieldsの全項目解説・公開側表示編集編

WordPressプラグイン開発・ショートコード内でincludeするときにはob_start、ob_get_contents

超簡単！Custom Field Templateでカスタムフィールドをフル活用

BackWPupでバックアップ・リストア（復元）の具体的手順