WordPress Popular Postsのショートコードで連番で順位表示

この記事は【2022年2月22日】が最後の更新のため、記事の内容が古い可能性があります。

WordPress Popular Postsはサイトに人気記事を表示させる際に便利なプラグイン。ウィジェットなどを使用して表示することができますが、今回は『post_html』利用した表示について。

WordPress Popular Postsについて

人気記事を表示させることができるWordPressのプラグイン。導入するとウィジェットなどから人気記事を表示できるようになります。
導入方法も簡単で、基本的にインストールし有効化すれば使用可能になります。

WordPress Popular Posts

実際に表示してみましょう

今回はpost_htmlを使用した連番（順位）の表示です。
post_htmlで使用できる変数{item_position}を使用することにより表示。

ショートコードでの使用はこんな感じ。
今回は順番表示だけなので余計なのもありますが、30日前までの集計期間の投稿をPV数の順で最大100件サムネイル付き表示って感じで指定しています。　

[wpp range='last30days' order_by='views' post_type='post' limit='100' thumbnail_width='120' thumbnail_height='90' post_html='<li><span class="badge badge-danger">{item_position}</span>{thumb} <a href="{url}">{text_title}</a></li>']

同様の内容をテーマに直接記述するならこのような形になります。

<?php
$args = array(
  'range' => 'last30days',
  'order_by' => 'views',
  'post_type' => 'post',
  'limit' => 100,
  'thumbnail_width' => 120,
  'thumbnail_height' => 90,
  'post_html' => '<li><span class="badge badge-danger">{item_position}</span>{thumb} <a href="{url}">{text_title}</a></li>'
);
wpp_get_mostpopular($args);
?>

上記の内容でこのように表示されます。
数字の部分はBootstrapの.badgeを使用して簡単にやってますが、装飾はお好みに合わせてどうぞ。

ulタグをolに変更して出力させる

wpp_startやwpp_endを使用して、出力される値の先頭や末尾につける文字列を指定も可能。
こっちの方が装飾しやすいかな。

'wpp_start' => '<ol>',
'wpp_end' => '</ol>',

post_htmlで使用できる変数

標準で結構用意してくれています。

{author}：リンクされた著者名を返します。
{thumb}：投稿/ページにリンクされたサムネイルを返します。thumbnail_widthやthumbnail_heightでサイズ指定可能。
{thumb_img}：投稿/ページにリンクされないサムネイル画像を返します。thumbnail_widthやthumbnail_heightでサイズ指定可能。
{thumb_url}：サムネイルのURLを返します。
{title}：リンクされた投稿/ページのタイトルを返します。
{pid}：投稿/ページIDを返します。
{excerpt}（または{summary}）：投稿/ページの抜粋を返します。
{stats}：デフォルトの統計タグを返します。
{rating}：投稿/ページの現在の評価を返します。WP-PostRatingsをインストールして有効にする必要あり。
{score}：投稿/ページの現在の評価を整数として返します。WP-PostRatingsをインストールして有効にする必要あり。
{url}：投稿/ページのURLを返します。
{text_title}：投稿/ページのタイトルテキストを返します。
{author_copy}：リンクされた著者名をコピーとともに返します。
{category}：リンクされたカテゴリ名を返します。
{category_copy}：コピー付きのリンクされたカテゴリ名を返します。
{taxonomy}：リンクされた分類名を返します。
{taxonomy_copy}：リンクされた分類名をコピーとともに返します。
{views}：ビュー数のみを表示。
{views_copy}：コピーでビュー数を返します。
{comments}：コメント数のみを返す。
{comments_copy}：コピーでコメント数を返します。
{date}：投稿/ページの日付を返します。stats_dateの使用が必要。
{date_copy}：投稿/ページの日付をコピーとともに返します。
{total_items}：投稿の数を出力（人気記事に該当するトータル数）。
{item_position}：リスト内の投稿の位置を出力。