このページでは、WordPressテーマ『SWELL』で投稿リストを簡単に呼び出せるショートコードの使い方を解説していきます。
カテゴリーやタグ・表示件数・レイアウトなどを指定することが可能で、このショートコードを活用することで柔軟にトップページを構築することも可能になります。
トップページでのショートコード活用例
目次
基本となるショートコードの呼び出し方
投稿リストは、ショートコード名post_list
で呼び出すことが可能です。
属性値を何も指定しない方法であれば、以下のようにするだけで最新の投稿が5件、シンプルなレイアウトで表示可能です。
[post_list]
実際に上記のコードを使用してみます。
こんな感じです
使用できる属性値について
現状、次の3種類が使用可能です。
post_type="投稿タイプ"
- 初期値:
'post'
- 初期値:
count="表示件数"
- 初期値:
5
- 初期値:
type="投稿リストのレイアウト"
- 初期値:
'simple'
- 初期値:
order="並び順"
- 初期値:
'DESC'
- 初期値:
orderby="ソートの基準"
- 初期値:
'date'
- 初期値:
excerpt="抜粋文を表示するかどうか"
- 初期値:
'off'
('on'
にすると抜粋文が表示されます)
- 初期値:
col="最大カラム数"
col_sp="最大カラム数(SP)"
more="MOREボタンの表示テキスト"
more_url="MOREボタンの遷移先URLスラッグ"
cat_id="カテゴリーID"
tag_id="タグID"
各属性の追加説明
type
には'simple','card','list','thumb'
が指定できます。post_type / order / orderby
はWP_Queryに指定できるパラメータと同じものが使用できます。orderby='pv'
にすると、SWELLでカウント中のPV数を基準にしてソートできます。excerpt="on"
の時の抜粋文の長さは、カスタマイザーでの設定値を引き継ぎます。col
/col_sp
は typeの指定が'card'
または'thumb'
の時のみ有効です。(指定しない場合はカスタマイザーの投稿リストの設定値を引き継ぎます。)more
が指定されている時のみ、その指定されたテキストで投稿リストの下にMOREボタンが表示されます。more_url
はホームURLの後のスラッグ部分を指定してください。(例:/news/
)- カテゴリーとタグを両方指定した場合、「カテゴリーとタグを両方持つ投稿」が呼び出されます。
- MOREボタンのリンク先は基本的に自動で指定されたカテゴリーアーカイブページなどが設定されますが、人気記事一覧ページなどは直接指定してください。
使用例
何パターンか、使用例を紹介します。
例1
最新記事を3件、説明文あり、カード型レイアウトで最大3カラム、スマホでは1カラムで表示する
[post_list type="card" count="3" col="3" col_sp="1" excerpt="on"]
実際に呼び出すと
-
【SWELL – ver. 2.13 アップデート情報】
主なアップデート内容 WP 6.7への対応を行いました。 ※ ただし、WordPress v.6.7 では翻訳関連のバグがコア側で発生しています。そのため、SWELLを英語設定で使った時、... -
【SWELL – ver. 2.12 アップデート情報】
主なアップデート内容 関連記事ブロックで画像を手動で設定できるようになりました。 「投稿者」権限でタブブロックが使用できない不具合を修正しました。 「投稿者」権... -
【SWELL – ver. 2.11 アップデート情報】
主なアップデート内容 WordPress 6.6 へ対応しました。 関連記事ブロックを "/related"で呼び出せるように調整しました。 投稿一覧の抜粋文に含まれるh2タグ内テキスト...
例2
人気記事を上位3件、リスト型レイアウトで表示し、人気記事一覧ページへのリンクを「もっと見る」と表示させる。
(人気記事一覧ページのURLが https://example.com/popular-posts/ の場合)
[post_list type="list" count="3" orderby="pv" more="もっと見る" more_url="/popular-posts/"]
実際に呼び出すと
例3
ID3のカテゴリーを持つ記事を5件、シンプルに表示し、カテゴリーアーカイブページへのリンクを「MORE」として表示する
人気記事を上位3件、リスト型レイアウトで表示し、人気記事一覧ページへのリンクを「もっと見る」と表示させる。
(人気記事一覧ページのURLが https://example.com/popular-posts/ の場合)
[post_list cat_id="2" more="MORE"]
実際に呼び出すと