人気記事ランキング表示ショートコードについて

人気記事ランキング表示ショートコードについて
2018.06.05

ウィジェットで使用できる「人気記事ランキング」と同じ表示をショートコードを使うことでウィジェット以外でも使用することができます。

このページでは人気記事ランキング表示ショートコードの各パラメーターについてご紹介致します。

人気記事ランキング表示ショートコード

ショートコード

[ys_post_ranking]

必須パラメーター

なし

オプションパラメーター

投稿取得に関するパラメーター

【count】

  • 取得する投稿件数を指定できます。
  • 使えるパラメーター:1以上の整数
  • 初期値:5

表示レイアウトに関するパラメーター

【list_type】

  • 表示タイプを指定できます。
  • 使えるパラメーター:
    • list:画像とタイトルが横に表示されるタイプ。リストタイプ
    • card:画像とタイトルが縦に表示されるタイプ。カードタイプ
    • slide:記事リストが横スライドできるタイプ。
  • 初期値:list

【col】

  • 表示列数を指定できます。モバイル・タブレット・PCをまとめて指定できます。
  • 使えるパラメーター: 1 ~ 6 の数字を指定して下さい。
  • 初期値:1

【col_sp】

  • モバイル表示での表示列数を指定できます。colより優先されます。
  • 使えるパラメーター: 1 ~ 6 の数字を指定して下さい。
  • 初期値:なし(空文字)

【col_tablet】

  • タブレット表示での表示列数を指定できます。colより優先されます。
  • 使えるパラメーター: 1 ~ 6 の数字を指定して下さい。
  • 初期値:なし(空文字)

【col_pc】

  • PC表示での表示列数を指定できます。colより優先されます。
  • 使えるパラメーター: 1 ~ 6 の数字を指定して下さい。
  • 初期値:なし(空文字)

【show_img】

  • サムネイル画像の表示・非表示が指定できます。
  • 使えるパラメーター: true , false
  • 初期値:true

【thumbnail_size】

  • 投稿サムネイルのサイズを指定できます。
  • 使えるパラメーター:
    • thumbnail, medium, large, full など、メディア有効にされているサイズ名を指定して下さい。
  • 初期値:thumbnail
  • おすすめ設定:
    • list タイプの場合は thumbnail
    • card, slide タイプの場合は medium 以上、横長フォーマットの画像サイズを指定します。

【thumbnail_ratio】

  • サムネイル表示の縦横比を指定できます。
  • 使えるパラメーター:4-3, 16-9, 3-1, 2-1, 1-1
  • 初期値:thumbnail_size の指定によって自動で決定されます。
    • thumbnail_size = thumbnail : 1-1
    • thumbnail_size = thumbnail以外 : 16-9

【show_excerpt】

  • 抜粋の表示・非表示が指定できます。
  • 使えるパラメーター: true , false
  • 初期値:false

【excerpt_length】

  • 抜粋の文字数を指定できます。excerpt_length = true のときに有効になるパラメーターです。
  • 使えるパラメーター:1以上の整数
  • 初期値:50

絞り込みに関するパラメーター

【filter】

  • 投稿詳細とカテゴリー一覧で同一カテゴリーのついた記事の絞り込みを有効にできます。
  • 使えるパラメーター:category
  • 初期値:空文字(絞り込みOFF)
  • 補足:今後タグでの絞り込み機能なども追加の予定です。

【ranking_type】

  • ランキングのタイプを指定します。
  • 使えるパラメーター:all(全期間)、d(日別)、w(週別)、m(月別)
  • 初期値:all

※旧ショートコードのパラメーターは次ページに記載しています。