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

2015/03/18 2016/03/26

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

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

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

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

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

functions.phpに関数を追加

　
functions.phpに下記のソースを記載します。（2016.03.26　修正）
　

// ショートコードで呼び出す関数
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>' . date ( 'Y.m.d', strtotime ( $post->post_date ) ) . '</p>';
    // 更新日の場合
    $html .= '<p>' . date ( 'Y.m.d', strtotime ( $post->post_modified ) ) . '</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 .= '' . date ( 'Y.m.d', strtotime ( $post->post_date ) ) . '';

// 更新日の場合

$html .= '' . date ( 'Y.m.d', strtotime ( $post->post_modified ) ) . '';

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

}

$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

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

Comment

あっきーより:

2016年3月21日 1:51 PM

大変参考にさせて頂いております。
ソースをそのまま使ってみたのですが
投稿した日付けが全て一緒になります。

何か私の設定が間違っているのでしょうか？

返信

エス技研より:

2016年3月23日 10:23 PM

あっきーさん、ご連絡ありがとうございます。

ご連絡の件ですが、私が間違えていますね。失礼いたしました。
「get_post_time()」関数は表示しているページの投稿日時を取得しますので、表示している固定ページの投稿日が表示されていると思われます。

22行目を下記の様に書き換えてください。

投稿日の場合
$html .= '<p>' . date ( 'Y.m.d', strtotime ( $post->post_date ) ) . '</p>';
更新日の場合
$html .= '<p>' . date ( 'Y.m.d', strtotime ( $post->post_modified ) ) . '</p>';

投稿日の場合

$html .= '' . date ( 'Y.m.d', strtotime ( $post->post_date ) ) . '';

更新日の場合

$html .= '' . date ( 'Y.m.d', strtotime ( $post->post_modified ) ) . '';

返信

あっきーより:

2016年3月24日 12:37 PM

エス技研様

変更したところ無事表示されました！
ワードプレスを扱い始めたばかりで少しずつ勉強しておりますが
いつも参考にさせて頂いております。
すぐに対応頂き有難う御座いました

返信
- エス技研より:
  
  2016年3月26日 8:16 AM
  
  あっきーさん、ご連絡ありがとうございます。
  無事に対応できたとのことで安心しました。
  ご指摘いただいていた箇所の記事は修正させていただきました。
  
  でも、まぁ、このブログにも質問をくださる方も少なからずいらっしゃいますが、お礼まで書き込んでくださる方は限りなく少ないので、対応した甲斐があったと嬉しくなりますね。＾＾
  
  返信

Message コメントをキャンセル

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

: Export to Textで WordPressを csv出力

WordPressのデータを csv出力する Export to Textの使い方を解説しています。

: WordPressのログイン画面 URLを変更する　管理画面に Basic認証を設定する

ログインURLは誰でも知っています。そのまま使うとリスクが高まりますのでログインURLを変更し Basic認証で二重チェックをする方法を解説。

: Advanced Custom Fields（ACF）のアドオン・繰り返しフィールドの使い方解説

Advanced Custom Fieldsのアドオン・繰り返しフィールドについて解説。繰り返しフィールドは投稿者が入力フィールドを追加しながら情報を入力できるフィールドを提供。

: WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

WordPressの投稿ページで PHPの処理を行うには add_shortcode関数を使ったショートコードという機能を利用します。

: WordPressのPing・更新情報サービス設定方法とPingサーバ

WordPressのPing機能、更新情報サービスの設定方法の解説と Pingサーバのリストを提供しています。

: WordPressのテーマ管理方法とテーマのHTML編集のポイント解説

テーマ変更で無限の可能性！テーマの選び方と設定方法、デザイン修正のためのHTML修正のポイントを解説。

: 30分でWordPressを引越し・他のサーバに引越しや開発環境の構築手順

WordPressを他のサーバに引っ越しするとき、テスト環境を作るときなどの作業手順をまとめました。プラグインを使う方法もありますが手作業でも簡単です。

: Category OrderでWordPressのカテゴリを並替えよう

Category Orderは基本機能では並び替えができないカテゴリを並び替える機能を提供するプラグインです。ドラッグ＆ドロップで並び替えができる簡単インターフェイスです。

: Edit Author Slugで WordPressの不正ログイン・不正アクセスを回避

WordPressのセキュリティ強化に Edit Author Slugを使う理由と設定方法の解説をしています。

: WordPressのスラッグとは？

WordPressのスラッグって何？それを解説している記事です。なんとなく分かっている気になっているものを改めてしっかり確認をしてみませんか？

PREV: ECCUBEの商品一覧ページのSEO対策！rel="next"　rel="prev"を設定
NEXT: BJ Lazy LoadでWordPressを高速化！SEO効果絶大でPVもアップ！

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

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

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

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

functions.phpに関数を追加

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

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

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

GoogleAdwords

GoogleAdwords

Comment

Message コメントをキャンセル

関連記事

Export to Textで WordPressを csv出力

WordPressのログイン画面 URLを変更する　管理画面に Basic認証を設定する

Advanced Custom Fields（ACF）のアドオン・繰り返しフィールドの使い方解説

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

WordPressのPing・更新情報サービス設定方法とPingサーバ

WordPressのテーマ管理方法とテーマのHTML編集のポイント解説

30分でWordPressを引越し・他のサーバに引越しや開発環境の構築手順

Category OrderでWordPressのカテゴリを並替えよう

Edit Author Slugで WordPressの不正ログイン・不正アクセスを回避

WordPressのスラッグとは？

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

コピーコンテンツ対策.htaccessで直リンク禁止しリダイレクトで対応

評価点投票プラグイン10個を比較！WordPressで口コミサイトを構築

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

コンパクトキーボード・KEK-EA9AU・FKB1420の魅力

2025年11月
日	月	火	水	木	金	土
						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