ショートコードの使い方

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

ショートコードの使い方

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

EASELでは、プラグイン「Classic Editor」をお使いの場合、ビジュアルエディタの上部「EASELタグ」プルダウンからあらかじめ用意されたショートコードを呼び出すことができます。

ショートコードの呼び出し

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

 

更新履歴一覧

デフォルトでは [new_list count=5] というコードが呼び出されますが、以下の変数により表示内容を制御できます。

デフォルトの値 指定できる値
最大表示件数 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]で次のように表示されます。

 

イラスト一覧

デフォルトでは [new_illust count=-1 work_type=illust] が呼び出されます。使える変数は以下の通りです。

デフォルトの値 指定できる値
最大表示件数 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] です。

小説一覧

デフォルトは [new_text count=-1 work_type=text] です。使える変数はイラスト一覧と同じですが、表示順がデフォルトで昇順(古いもの→新しいもの)になっています。

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

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

  • パスワード付き記事のテスト

    この作品を見るにはパスワードの入力が必要です。

  • こころ

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

  • サーカスの怪人

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

  • ドグラ・マグラ

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

  • 人間失格

    太宰治の名作です。

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

  • 山月記

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

  • 学問のすすめ

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

  • 人間失格

    太宰治の名作です。

  • ドグラ・マグラ

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

  • サーカスの怪人

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