ショートコード＋ウィジェットでサイドバーに人気記事を表示させる方法

2015/09/25 2017/03/12

サイドバーに人気記事を表示させる方法

ショートコードで人気記事を編集するソースコード

　
ウィジェットに表示する「人気記事」をショートコードで自由な記事を指定して編集出来る関数を作成しました。
　
ソースコードは、以下の通りです。
　

function getRecommendList ( $arg ) {
  extract ( shortcode_atts ( array (
    'postid' => '2874',
  ), $arg ) ); 

  $postid_array = explode ( ",", $postid );

  $html  = "";
  $html .= '<!-- 最近の読み物 --><div id="kanren">';

  foreach ( $postid_array as $val ) {
    $post_array = get_post ( $val );

    $html .= '<dl class="clearfix">';
    $html .= '<dt><a href="' . $post_array->guid . '">';
    $html .= get_the_post_thumbnail ( $val, 'thumb150' );
    $html .= '</a>';
    $html .= '<div align="center">' . date ( 'Y.m.d', strtotime ( $post_array->post_date ) ) . '</div> </dt>';
    $html .= '<dd><h5><a href="' . $post_array->guid . '">';
    $html .= $post_array->post_title . '</a></h5>';
    $html .= '<div class="smanone">';
    $html .= '<p>' . $post_array->post_excerpt . '</p>';
    $html .= '</div></dd></dl>';

  }
  $html .= '</div><!-- /最近の読み物 -->';

  return $html;
}
add_shortcode('getRecommendList', 'getRecommendList');
add_filter('widget_text', 'do_shortcode' );

function getRecommendList ( $arg ) {

extract ( shortcode_atts ( array (

'postid' => '2874',

), $arg ) );

$postid_array = explode ( ",", $postid );

$html = "";

$html .= '<div id="kanren">';

foreach ( $postid_array as $val ) {

$post_array = get_post ( $val );

$html .= '<dl class="clearfix">';

$html .= '<dt><a href="' . $post_array->guid . '">';

$html .= get_the_post_thumbnail ( $val, 'thumb150' );

$html .= '</a>';

$html .= '<div align="center">' . date ( 'Y.m.d', strtotime ( $post_array->post_date ) ) . '</div> </dt>';

$html .= '<dd><h5><a href="' . $post_array->guid . '">';

$html .= $post_array->post_title . '</a></h5>';

$html .= '<div class="smanone">';

$html .= '<p>' . $post_array->post_excerpt . '</p>';

$html .= '</div></dd></dl>';

}

$html .= '</div>';

return $html;

}

add_shortcode('getRecommendList', 'getRecommendList');

add_filter('widget_text', 'do_shortcode' );

　
このソースコードは、functions.phpに記載します。
ファイルの場所は以下の場所です。
/wp-contents/theme/{テーマのフォルダ}/functions.php
　
functions.phpについては、下記に詳しい記事を書いていますので合わせて参考にしてください。
　「WordPressの functions.phpがある場所」
　
　

ウィジェットに編集するショートコード

　
ウィジェットの「内容」のところに編集するショートコードは以下のような感じです。
投稿は、POST IDで指定をします。複数指定する場合は、「,（カンマ）」で区切ります。数の制限はありません。

[getRecommendList postid=1,2,3]

1	[getRecommendList postid=1,2,3]

イラスト図解式この一冊で全部わかるWeb技術の基本

ウィジェットの見え方

　
編集すると、下記の様に表示されます。
まさに、右側のサイドナビゲーションに表示されている「最近の読み物」です（笑）。
　

　
　

「人気記事」の編集の際の注意点

　
基本的な処理はこのままで問題ありませんが、HTMLを出力する部分は、あなたのサイトのテーマに合わせて改変してください。
このブログは、Stinger5を利用させていただいていますので、同じテーマであればそのままでも大丈夫な場合もあるでしょう。
　
　
また、23行目の「$post_array->post_excerpt」は「抜粋」を出力する設定になっています。ここも違うものにしたい場合が多いのではないかと思いますので、必要に応じて変更してください。
　
組み込む際の項目をどう指定すればいいかについては、「get_post()」関数についての下記オフィシャルサイトが参照になるでしょう。
　https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/get_post
　
　
また、このエス技研ブログではサムネイルは必ずありますので、サムネイルがない場合を想定していませんが、サムネイルの画像がない場合を想定するならば、16行目を下記の処理に変更するといいでしょう。
　

if ( has_post_thumbnail() ) { // サムネイルを持っているときの処理 ?>
  $html .= get_the_post_thumbnail ( $val, 'thumb150' );
} else { // サムネイルを持っていないときの処理 ?>
  $html .= '<img src="' . get_template_directory_uri() . '/images/no-img.png" alt="no image" title="no image" width="100" height="100" />';
}

if ( has_post_thumbnail() ) { // サムネイルを持っているときの処理 ?>

$html .= get_the_post_thumbnail ( $val, 'thumb150' );

} else { // サムネイルを持っていないときの処理 ?>

$html .= '<img src="' . get_template_directory_uri() . '/images/no-img.png" alt="no image" title="no image" width="100" height="100" />';

}

　
　
また、一番最後の行の「add_filter(‘widget_text’, ‘do_shortcode’ );」は、ウィジェットにショートコードを編集する際のコマンドですので、テンプレートに組み込む場合などは不要です。
　
ショートコードについては下記に記事を書いていますので参考にしてみてください。
　「WordPress投稿にPHPを記述するショートコードの使い方add_shortcode」
　「WordPressのウィジェットでショートコードを使う方法add_filter」
　
　

「人気記事」のショートコードのプログラムを作った経緯

　
このブログの右ナビゲーションにある「最近の読み物」は、アナログ的に手作業で更新していました。
Google Search Console（旧 Google WebMaster Tool）や Googleアナリティクスを参考に、人気があるコンテンツを中心に掲載をしていました。
　
実際にアクセスが多い記事もあれば、「いいね！」が多い記事もあり、コメントが多い記事、読んで欲しい記事など複合的に判断して掲載していました。
単なるアクセスランキングにはしたくなかったので。
　
　
でも、これ、単純に HTMLのソースを手書きしてウィジェットに貼り付けるという、かなりアナログな方法を採っていましたので更新がかなーり面倒だったのです。
　
そんなわけで、定期的な更新というわけにはいきませんでした。
　
でも、「最近の読み物」というコーナーが最近のものを更新されていないのでは役に立たないので、簡単に更新できる方法を考えたワケです。
　
分かっている方にとっては非常に簡単な内容で、純粋な処理の部分は 10行にも満たないわけですので、「もっと早くに作っておけばよかった」という感じはするのですが、知らないことは作れないわけで、ということですね。
　
カスタムフィールドを管理するプラグインの「Advanced Custom Fields」の使い方を調べているうちに投稿情報を取り出す方法をいろいろ知りまして、「なんだ簡単じゃないか」と思ったわけです。
そんな「Advanced Custom Fields」の使い方については、下記に記事を書いています。
　「カスタムフィールド決定版！Advanced Custom Fields全項目完全解説・管理画面編」
　「Advanced Custom Fieldsの全項目解説・公開側表示編集編」
　
　
ソース自体は大したものではないですが、せっかく作りましたので同じようなことを望まれている方は参考にしてみてください！

- WordPress

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

Message コメントをキャンセル

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

: プラグインが原因で起動しないWordPressを復旧させる方法解説

プラグインが原因で WordPressが起動できなくなった、ログインできなくなった場合の対処方法の解説です。

: Throws SPAM Awayでコメントスパム対策を完璧に。自動削除で運用の手間ゼロ

コメントスパム対策の決定版ともいうべきプラグイン。簡単な設定で自動的にスパムコメントを削除してくれるので煩わしい作業はゼロに。細かな設定も可能。

: WordPressで月極駐車場検索サイトを構築し無料公開・使ったプラグインの紹介も

月極駐車場を検索するシステムをWordPressで構築。そのアナウンスと構築するために利用したプラグインの紹介。構築にどれくらいの期間がかかるのかの紹介。

: wp_mail()関数でWordPressのスパム対策済のメールフォーム作成

WordPressでメール送信フォームを作成するための関数「wp_mail()」の使い方の解説。CC、BCC、添付ファイルも HTMLメールも設定可能。

: EWWW Image Optimizerで画像の圧縮でWordPressを高速化

ページ表示の高速化に使うEWWW Image Optimizerの紹介です。英語で書かれているために取っつきにくいですが設定は3カ所。画像の圧縮もワンクリック。超簡単！

: WordPressのおすすめの確認画面付きお問い合わせフォームプラグイン・MW WP Form

MW WP Formは確認画面が付いているオススメのフォームプラグインです。企業サイトを CMSとして構築する際にも利用できる実力派です。

: Captchaを使って WordPressのコメントスパム対策をする

コメントスパム対策として入力させない対策の一つとしてCAPTCHAという方法がありそれを簡単に実装できるプラグインCaptchaの解説です。

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

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

: Smart Update PingerでWordPressのPing・更新情報サービスを拡張する

WordPressの Ping機能、更新情報サービスのプラグイン Smart Update Pingerの使い方と問題点。

: WP Mail SMTPはPHP5.6、7.0系ではメール送信時にエラーが発生。その対処方法。

PHPのバージョンを5.6（7系含む）にアップデートしたらプラグイン WP Mail SMTPを利用してSMTPサーバ経由して送信していたメールが送信できなくなった。その原因と対処方法を詳細解説。