記事コンテンツ内に、サイト全体、任意のカテゴリまたは任意のカスタム投稿タイプにおける最も閲覧回数が多い記事の一覧を指定件数分表示できます。
DigiPress専用アドオン「DigiPress Ex – Popular Posts」プラグインがインストールされている場合は、日次、週次、月次別でのページビュー数を元にした人気記事の一覧を表示できます。
オプション未指定の最も簡単な表示例
このショートコード
[mostviewedposts]
週次の人気記事ランキング表示例(サムネイル付き)
このショートコード
[mostviewedposts term="weekly" ranking=1 thumb=1 likes=1 hatebu=1 date=1]
指定可能なパラメータ
- num
- 一覧に表示する記事の表示(取得)件数を指定します。
未指定の場合は、最も閲覧回数が多い記事を最大5件まで表示します。例: num=10
- thumb
- 各記事に投稿サムネイル(アイキャッチ)画像を表示する場合に “1” を指定します。
未指定の場合は “0” (非表示)が設定されます。例 : thumb=1
- titlemax
- 一覧に表示される記事の投稿タイトルの最大文字数を指定します。
未指定の場合は、最大 35 文字までを表示します。例 : titlemax=50
- term (※DigiPress Ex − Popular Posts プラグイン用)
- 人気記事の指標となる閲覧回数の集計期間を「日次」、「週次」、「月次」から選ぶ場合に指定します。
※このパラメータを利用するには専用アドオン「DigiPress Ex – Popular Posts」プラグインが必要です。指定できる値は以下のとおりです。
- daily : 日次
- weekly : 週次(月曜日リセット)
- monthly : 月次(毎月1日リセット)
例 : term=”weekly”
- views
- 各記事の閲覧回数の表示有無を指定します。
未指定の場合は、views=1 が指定され、各記事のタイトルの後に閲覧回数が表示されます。閲覧回数を表示しない場合は、views=0 を指定します。
- cat
- 閲覧回数の多い記事を取得する対象のカテゴリIDを指定します。
未指定の場合は、すべてのカテゴリが対象となります。複数のカテゴリを対象とする場合は、カテゴリIDをカンマ(,)で区切って指定します。
逆に、指定のカテゴリを取得対象から除外したい場合は、カテゴリIDの前に ‘-‘ (ハイフン)を付けます。
例: cat=”2,13,22″ (※2, 13, 22 のカテゴリIDを対象とする場合)
cat=”-4,-8″ (※4, 8 のカテゴリIDを除外する場合)など。 - date
- 記事の投稿日の表示有無を指定します。
未指定の場合は、date=0 が指定され、投稿日は表示しません。記事タイトルの前に投稿日を表示する場合は、date=1 を指定します。
- year
- 閲覧回数の多い記事を取得する対象の年を指定します。
未指定の場合は、すべての期間が対象となります。例: year=2013 (※2013年を対象とする)
- month
- 閲覧回数の多い記事を取得する対象の月を指定します。
未指定の場合は、すべての月が対象となります。このパラメータは、yearパラメータとセットで指定することを推奨します。
例: month=10 (※10月を対象とする)
- likes
- 表示される各記事における Facebookの「いいね！」をされた回数を表示する場合に “1” を指定します。
未指定の場合は “0” (非表示)が設定されます。例 : likes=1
- hatebu
- 表示される各記事が はてなブックマークに登録された回数を表示する場合に “1” を指定します。
未指定の場合は “0” (非表示)が設定されます。例 : hatebu=1
- ranking
- 各記事に順位を表示する場合に “1” を指定します。
未指定の場合は “0” (非表示)が設定されます。例 : ranking=1
- type
- 表示対象を任意の投稿タイプに限定する場合に、その投稿タイプのスラッグを指定します。
未指定の場合は、「記事(post)」が対象となります。例えば、「お知らせ(スラッグ:news)」というカスタム投稿タイプがある場合、新着記事を「お知らせ」カスタム投稿タイプに限定する場合は “news” を指定します。
固定ページを対象とする場合は、”page” を指定します。例 : type=”news”