阿修羅ワークスプラグイン講座43 オプションを使う ゲット・ツイート・イン05

今度はオプションを使ってみましょう。
ショートコードにはいくつかオプションが用意されています。
そのうちのいくつかを紹介します。

はい、よろしくお願い致します。

前回こういったショートコードを紹介しました。

[getswin keyword="検索ワード"]

この「keyword="検索ワード"」の部分がオプションとなります。
オプションはイコールに続けて二重引用符で「値」を指定します。
複数のオプションを指定する場合は、半角スペースで区切って下さい。

ふむふむ。

ツイート取得のテストでやった「文頭一致ワード」「文中一致ワード」「文末一致ワード」もオプションで指定できますよ。

[getswin keyword="検索ワード" before="文頭一致ワード" middle="文中一致ワード" after="文末一致ワード"]

あーなるほど。こういう風に使うんですね！

他によく使うオプションをまとめて紹介します。

use_title……検索キーワードとして記事タイトルを使う
alt_keyword……検索ワードで検索結果が取得できなかった場合に再検索する代替キーワード
view_num……表示件数
cache_num……キャッシュしておくツイート件数
include_entities……true:画像を表示する false:画像は表示しない

ショートコードに含めるとこんな感じになります。

[getswin keyword="検索ワード" use_title="1" alt_keyword="代替キーワード" view_num="5" cache_num="100" include_entities="true"]

おおーーーーっオプションを色々と変えることで取得できるツイートが変わるわけですね。

はい、その通りです。
特によく使うのは「use_title」と「alt_keyword」オプションでしょうか。

何に使うのですか？

「use_title」オプションは検索ワードが具体的に決まっていない場合に使用します。
例えば、自動投稿系のプラグインと連携させる場合は、予め検索キーワードが決まっていない場合があると思います。
その際、「use_title」オプションを「use_title="1"」にしておくと、投稿タイトルを検索ワードとして使用するようになります。

自動化に便利なオプションですね！

さらに、検索ワードでツイートが見つからなかった場合、「alt_keyword」オプションで汎用的なキーワードを予め決めておくことで、代替キーワードで再検索をしてくれます。
ツイートが取得できなかった、という事態をある程度防ぐことができます。

なるほどー。じゃあこのオプションを2つだけ指定しておけば自動化が可能ですね？

[getswin use_title="1" alt_keyword="代替キーワード"]

その通りです。
最低限、「use_title」と「alt_keyword」オプションを指定しておけば自動化が可能です。

質問なのですが、ゲット・ツイート・インで、ツイートが2件とか3件しか取得できなかった場合はそのままなのでしょうか？

ゲット・ツイート・インではキャッシュ時間というものがあって、一定時間ごとに新しいツイートを自動検索します。
なので、その時点でツイートが2件とか3件しか取得できなくとも、時間とともに新しいツイートがあれば追加されていきます。

さすが！　その辺は考えられているんですね！
時間とともにどんどん増えていくわけですね。

また、「cache_num」オプションでキャッシュしておくツイート件数を指定できます。
「view_num」オプションで表示件数を指定できます。
例えば「cache_num="10"」で「view_num="1"」にすると、10件保存したうちの1件のみを表示することになります。

オプションを使いこなせば色んなことができそうですね！

【宣伝】WordPress魔改造阿修羅ワークスのサークルやってます
https://note.com/asuraworks/circle