ショートコードの使い方

EASELで使えるショートコードについて詳しく解説します。

ショートコードの使い方

ショートコードとは、WordPressで使える機能です。定型文やPHP複雑な処理を、半角カッコ[ ]で囲われたコードに紐づけることで、短いコードで置き換えて呼び出すというものです。

EASELでは、プラグイン「Classic Editor」をお使いの場合、テキストエディタの上の「作品リスト挿入」ボタンから、作品リストを生成するショートコードを挿入することができます。

ショートコード生成ボタンの使い方

ボタンをクリックすると、次のようなウインドウが表示されます。

ショートコード生成ボタンの使い方

挿入したい作品リストの条件を入力し、ウインドウ下部の「挿入」ボタンを押すことで、ショートコードが挿入されます。エディタ上はただの英数記号の配列ですが、記事をプレビューもしくは更新すると、作品のリストが表示されます。

ショートコード生成ボタンの使い方

EASELのショートコードはより拡張性を高めるため、変数を指定することで表示件数を変えたり、表示順を自由に並べ替えたりすることができます。

更新履歴一覧のショートコード変数

デフォルトの値 指定できる値
最大表示件数 count=5 正の整数
全て表示する場合は「-1」
作品タイプ work_type=update 作品タイプもしくは子タイプのスラッグ
update以外の親タイプも指定可能
表示の順番 orderby=post_date
(日付順)
ID(ID順)
title(投稿タイトル順)
rand(ランダム)
詳しくはWordPress Codex
昇順か降順か order=DESC
(降順)
ASC(昇順)
DESC(降順)
クラス追加 class=null(なし) 英数文字列
これを指定すると指定されたclassが
ulに追加されます。
自由にデザインしたい人用

例えば「更新履歴を古い順に5件」なら [new_list count=5 order=ASC] で次のように

「作品タイプ『文章>小説』の投稿作品を3件、新しい順に表示」なら [new_list count=3 work_type=novels]で次のように表示されます。

イラスト一覧のショートコード変数

デフォルトの値 指定できる値
最大表示件数 count=-1 正の整数
全て表示する場合は「-1」
作品タイプ work_type=illust 作品タイプもしくは子タイプのスラッグ
illust以外の親タイプも指定可能だが
アイキャッチ画像を持つか、本文中に画像がないと
表示がおかしくなります
サムネイルサイズ type=default default(標準)
small(小さめ)
表示の順番 orderby=post_date
(日付順)
ID(ID順)
title(投稿タイトル順)
rand(ランダム)
詳しくはWordPress Codex
昇順か降順か order=DESC
(降順)
ASC(昇順)
DESC(降順)
クラス追加 class=null(なし) 英数文字列
これを指定すると指定されたclassが
ulに追加されます。
自由にデザインしたい人用

例えばランダムに3件表示する場合は [new_illust count=3 orderby=rand] になります。ランダム表示なので、ページをリロードするたびに表示される作品が入れ替わります。

作品タイプ「イラスト」の子タイプ「猫の写真(スラッグはcat)」だけをすべて表示する場合は [new_illust count=-1 work_type=cat] です。

サムネイルを小さくしたい場合は[new_illust type=small] です。

小説一覧のショートコード変数

デフォルトの値 指定できる値
最大表示件数 count=-1 正の整数
全て表示する場合は「-1」
表示タイプ type=default default(2行タイプ)
list1(1行タイプ)
noexcerpt(抜粋文非表示)
作品タイプ work_type=text 作品タイプもしくは子タイプのスラッグ
text以外の親タイプも指定可能
表示の順番 orderby=post_date
(日付順)
ID(ID順)
title(投稿タイトル順)
rand(ランダム)
詳しくはWordPress Codex
昇順か降順か order=ASC
(昇順)
ASC(昇順)
DESC(降順)
クラス追加 class=null(なし) 英数文字列
これを指定すると指定されたclassが
ulに追加されます。
自由にデザインしたい人用
バッジ表示 なし showtag=true(作品タグをバッジ表示)
showtype=true(作品タイプをバッジ表示)

降順(新しいもの→古いもの)で「小説(スラッグはnovel)」を5件表示する場合は [new_text count=5 order=DESC work_type=novels] です。

  • こころ

    この記事はパスワードによる閲覧制限がかかっています。パスワード「password」を入力すると本文が見られます。

  • サーカスの怪人

    ある夕がた、少年探偵団の名コンビ井上一郎いのうえいちろう君とノロちゃんとが、世田谷せたがや区のさびしいやしきまちを歩いていました。きょうは井上君のほうが、ノロちゃんのおうちへ遊びにいったので、ノロちゃんが井上君を送っていくところです。

  • ドグラ・マグラ

    胎児よ 胎児よ 何故躍る 母親の心がわかって おそろしいのか

  • 人間失格

    太宰治の名作です。

  • 学問のすすめ

    本文とは別に「抜粋」を入力することで、作品一覧に表示させる文章を設定できます。

また、1行ですっきりしたリストにしたい場合はtype=line1を指定します。

  • 山月記

    「その声は、我が友、李徴子ではないか?」

  • 学問のすすめ

    本文とは別に「抜粋」を入力することで、作品一覧に表示させる文章を設定できます。

  • 人間失格

    太宰治の名作です。

  • ドグラ・マグラ

    胎児よ 胎児よ 何故躍る 母親の心がわかって おそろしいのか

  • サーカスの怪人

    ある夕がた、少年探偵団の名コンビ井上一郎いのうえいちろう君とノロちゃんとが、世田谷せたがや区のさびしいやしきまちを歩いていました。きょうは井上君のほうが、ノロちゃんのおうちへ遊びにいったので、ノロちゃんが井上君を送っていくところです。