新着記事一覧表示ショートコードについて

新着記事一覧表示ショートコードについて
2018.06.05

ウィジェットで使用できる「新着記事一覧」と同じ表示をショートコードでも使用することができます。

このページでは新着記事一覧表示ショートコードの各パラメーターについてご紹介致します。

新着記事一覧表示ショートコード

ショートコード

[ys_recent_posts]

必須パラメーター

なし

オプションパラメーター

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

【count】

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

【order】

  • 投稿の並び替えを指定できます。
  • 使えるパラメーター:DESC , ASC
  • 初期値:DESC

【orderby】

  • 並び替えの基準を指定できます。
  • 使えるパラメーター例:
    • date:日付順
    • rand:ランダム
  • 初期値:date

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

【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)
  • 補足:今後タグでの絞り込み機能なども追加の予定です。

【taxonomy】

  • 投稿をカテゴリーやタグ等のタクソノミーで絞り込みできます。
  • 使えるパラメーター:category(カテゴリー)、post_tag(タグ)などのタクソノミー名
  • 初期値:空文字
  • 補足:あわせてterm_slugの指定が必要になります。

【term_slug】

  • タクソノミー絞り込みパラメーター。
  • 使えるパラメーター:タームスラッグ
  • 初期値:空文字
  • 補足:このパラメーターを使う場合、taxonomyの指定も必須になります。

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