このショートコードを使うと、指定した複数のサイトから投稿を取得し、混合した上で日付順に並び替えて表示させることができます。
ショートコードの種類により、以下のリストを作成できます。
- アイキャッチ画像付き（カード形式）のリスト
- アイキャッチ画像なし（単純な形式）のリスト
ショートコードの使い方
アイキャッチ画像付きショートコード
ショートコード
以下のショートコードを使ってアイキャッチ画像付きのリストを表示できます。
[ha-latest-posts-with-thumbnails sites="" number="" order_by="" display_count="" cache_time="" datetext="" des="" offset="" size="" column=""]以下がショートコード内のパラメーターと説明ですので適切に設定してください。
| パラメーター | 説明 | 省略した場合の値 |
|---|---|---|
| sites | 情報を取得するサイトのトップページURLを「,」区切りで指定します ※URL末尾の「/」はなしにしてください | 自サイト |
| number | 各サイトから取得する情報の数を指定します | 5 |
| display_count | 表示させる数を指定します ※サイト数x取得数がこの値よりも大きくなるようにします | 5 |
| order_by | 「公開日(date)」「更新日(modified)」のどちらで並び替えるかを指定します | modified |
| cache_time | 取得した情報を一時保存する期間を秒単位で指定します | 3600 |
| datetext | 日付の接頭辞を文字列(0または空白)にするか、アイコン(1)にするかを指定します | なし(文字列) |
| des | 抜粋を表示する場合は1を指定します | なし(抜粋表示なし) |
| offset | 先頭から〇番目からの情報を表示させたい場合に指定します | なし(すべて) |
| size | カードの形態を指定します 空白または「small」/小画像カード 「large」/大画像カード ※モバイルでは設定に関わらず大画像カードで表示されます | small |
| column | カード表示させる列の数を指定します ※4列表示まで対応しています | 1 |
パラメーターの値を変更しても表示に反映されない場合は「cache_time」を一旦「0」に指定して保存するとキャッシュがクリアされ、更新されます
表示サンプル
大カードで最終更新日を基準に2列表示させた場合の表示サンプルです
小カードで公開日を基準に2件表示させた場合のサンプルです
アイキャッチ画像なしショートコード
ショートコード
以下のショートコードを使ってアイキャッチ画像なしのリストを表示できます。
[ha-latest-posts-simple sites="" number="" order_by="" display_count="" cache_time="" datetext="" des="" offset=""]以下がショートコード内のパラメーターと説明ですので適切に設定してください。
| パラメーター | 説明 | 省略した場合の値 |
|---|---|---|
| sites | 情報を取得するサイトのトップページURLを「,」区切りで指定します ※URL末尾の「/」はなしにしてください | 自サイト |
| number | 各サイトから取得する情報の数を指定します | 5 |
| display_count | 表示させる数を指定します ※サイト数x取得数がこの値よりも大きくなるようにします | 5 |
| order_by | 「公開日(date)」「更新日(modified)」のどちらで並び替えるかを指定します | modified |
| cache_time | 取得した情報を一時保存する期間を秒単位で指定します | 3600 |
| datetext | 日付の接頭辞を文字列(0または空白)にするか、アイコン(1)にするかを指定します | なし(文字列) |
| des | 抜粋を表示する場合は1を指定します | なし(抜粋表示なし) |
| offset | 先頭から〇番目からの情報を表示させたい場合に指定します | なし(すべて) |
パラメーターの値を変更しても表示に反映されない場合は「cache_time」を一旦「0」に指定して保存するとキャッシュがクリアされ、更新されます
表示サンプル
ショートコード使用時の注意事項
本ショートコードを使用する上での注意点です。
REST APIに制限のかかっているサイトからの情報は取得できません
このショートコードでは、REST APIというWordPressの情報共有機能を利用して、サイトの投稿データを取得します。
従って、何等かの方法（セキュリティ系のプラグインやカスタムコード）によってREST APIを通じた情報の取得を遮断しているサイトでは利用できません。
ショートコードを挿入し、適切に設定を行ってもリストが表示されない（またはエラーが吐き出される）場合には、取得元のサイトでREST APIが遮断されていないかを確認ください（よく分からない場合はこのショートコードを使用しないでください）。
エラーや不具合等が発生する可能性について
本機能およびHima Art Utilityプラグイン全般に言えることですが、あくまでも私の管理するサイトでテストしたものであり、サイトの状態（作り方）により情報が取得できない場合にはエラーが出る可能性があります。
一応以下のようにエラー回避をするようにはしています。
- sitesパラメーターが空の場合は自サイトのホームURLが取得されるようにしています
- 一部のパラメーターがショートコード上になくてもデフォルト値がセットされるようにしています
- 大カード時にアイキャッチ画像を取得する際には、まず「large」サイズの画像を取得するようにし、そのサイズの画像が存在しない場合には「medium」サイズの画像が取得されるようにしています
- スタイルが調整しにくいことと、普通に考えてあまり多くの列数に対応させる必要はないと判断し、列数の指定は4までとし、5以上の数が指定された場合には1列として表示させるようにしています
スタイルについては、ブロックテーマであるTwenty Twenty Threeテーマ、およびそれをフォークしたテーマで本文幅をいくつか変えてチェックをしていますが、同一テーマや別のテーマ（特にクラシックテーマ）では、うまく表示されない場合があります。
データベースキャッシュについて
REST APIではこのショートコードが含まれたページを表示する度に、指定されたサイトから指定数分の情報を取得します。
これにより、ショートコードに指定したサイトの数分だけこの作業が繰り返され、取得元および表示するサイトの状態（サーバーの状態や性能など）によっては表示までに時間がかかったり、エラーとして処理がストップしてしまうことがあります。
本ショートコードでは、一度取得したデータをある程度の期間データベース内に保存し、期間内は保存したデータを元に表示させるようにすることで、表示時間の短縮を図っています（何も指定しなければ3600秒 = 60分）。
表示速度を犠牲にしてまで最新の情報を常時取得したいというケースは少ないとは思いますが、「cache_time」パラメーターをより少ない数字（または0でキャッシュなし）にすることで、より最新に近いデータを取得して表示させることができます。
ただし、前述したようにキャッシュ期間を減らすことで、表示させる側、取得される側のサーバーに負荷がかかることは間違いないのでご注意ください。
