マニュアル

はじめに

このプラグインはGet Tweet In(ゲットツイートイン)と呼びます。
Get Tweet Inは阿修羅ワークス代表長岡が開発したオリジナルのワードプレス向けプラグインです。

Twitter APIキーの取得

Get Tweet InはTwitter APIキーが必要です。
また、Twitterアカウントが予め必要となります。ご用意下さい。Twitterアカウントの取得方法については省略させて頂きます。

Twitter APIは2019年8月以降ルールが変更されました。
基本的にはTwitter APIキーを取得するには利用申請手続きが必要となり、審査に合格しないとAPIキーが使えなくなっています。
※2019年8月以前に取得したTwitter APIキーについては一部、利用申請をしなくても良いようです。

Twitter API利用申請の注意点

Twitter API利用申請には注意点があります。
基本的にすべて英語でのやりとりとなります。ですが、翻訳ツールで翻訳すれば大丈夫です。

Twitter API利用申請は機械的ではなく有人目視で審査が行われます。
そのため、担当者によって承認のハードルが変わることがあります。
また、場合によってはいくつかメール(英語)で質問が来る場合があります。
その場合はメールに返信をする必要があります。

他に注意することは、Twitterではアカウントを10件ほど持てると公式でも謳われていますが、実際にはTwitter APIキーを取得できる件数に限りがあるようです。運にもよりますが、5件以上申請すると却下される可能性が高くなります。

審査に落ちてしまう理由

Twitter API利用申請で落ちる理由ですが、必須項目がきちんと記入できていない。
審査担当者から届いたメールに返信をしていない、といった単純なものは再審査を申し込めば合格する可能性があります。

しかし、過去にアカウントの凍結ペナルティを繰り返している場合は、ブラックリストに載って申請が下りない場合もあります。
その際は、新しく携帯電話の番号を用意して、まっさらな状態で審査を申し込むしかないようです。
※携帯電話も新しく用意して、昔のアカウントにはログインしてはいけません。紐付けられてしまいます。

審査に合格するには最新情報をチェックすること

人によってはなかなか審査に合格できない、2つ目のAPIキーが取得できないといった声を聞きます。
Twitter API利用申請の審査はちょくちょく内容が変わるので、こうすれば必ず合格できるといった攻略法は残念ながらありません。
そこで、一番いいのは最新の合格方法を試してみることです。最新のTwitter API利用申請の合格方法は、ネット検索で1年以内に期間を絞り込むことで得られます。

最新のTwitter API利用申請の合格方法を調べる

Get Tweet Inを設定する

ツイッター設定

4つのAPIキーを取得したら、Get Tweet Inの設定画面を開きます。
[ ツイッター設定 ] というタブを開きます。

4つのAPIキーをそれぞれ以下の項目に入力します。

Consumer Key	→	コンシューマキー
Consumer Secret	→	コンシューマシークレット
Access Token	→	アクセストークン
Access Token Secret	→	アクセストークンシークレット

最後に自分のツイッターIDを入力します。

自分のツイッターID

[ 変更を保存 ] ボタンをクリックして保存します。
これでTwitterの設定は終わります。

テンプレート設定

Get Tweet Inではテンプレートのカスタマイズができます。
[ テンプレート設定 ] というタブを開きます。

テンプレートは大きく分けてオフィシャルフォーマットとオリジナルフォーマットがあります。
オフィシャルフォーマットはTwitterが提供するフォーマットで、お馴染みのデザインとなっています。
オリジナルフォーマットではユーザー側で自由にデザインを変更ができます。

ID指定ツイート

ID指定ツイートはショートコード IDが指定されていません。を使用した場合に適用される設定です。
ツイートIDをショートコードで指定して呼び出します。
オフィシャルフォーマットまたはオリジナルフォーマットが選べます。

検索ツイート

検索ツイートはショートコード検索キーワードが指定されていないためデータの取得に失敗しました。 (sがあることに注意)を使用した場合に適用される設定です。
検索キーワードをショートコードで指定して呼び出します。
オフィシャルフォーマットまたはオリジナルフォーマットが選べます。

オフィシャルフォーマット

オフィシャルフォーマットは定型ですので極力いじらないようにしてください。

オリジナルフォーマット

オリジナルフォーマットはツイートのオリジナル表示フォーマットスタイルを変更することでデザインを変えることができます。
プレースホルダは以下のように変換されます。

	ツイートIDに変換されます
	スクリーンネームに変換されます
	ユーザー名に変換されます
	ユーザーアイコンに変換されます
	ユーザー言語に変換されます
	リンク無しツイート本文に変換されます
	リンク有りツイート本文に変換されます
	例　2018年1月1日の日付書式に変換されます
	例　2018年01月01日 23:01:01日付書式に変換されます
	添付画像1に変換されます
	添付画像2に変換されます
	添付画像3に変換されます
	添付画像4に変換されます

検索ツイート用オリジナルフォーマット

検索ツイート用オリジナルフォーマットは基本的には「オリジナルフォーマット」とまったく一緒です。
検索ツイートのショートコード検索キーワードが指定されていないためデータの取得に失敗しました。 (sがあることに注意)を使った時に適用されます。

単純なフォーマット例

初期設定ではTwitterの様々なギミックが付いてて、Twitterとひと目で分かります。シンプルにツイートだけにして、Twitter臭さを消すには以下のようにします。

このフォーマットではユーザー名とユーザーのツイート(リンク無し)が表示されます。
使用しているテーマに合わせてデザインの変更にチャレンジしてみてください。

テスト方法

実際に使用する前にテストをしておきましょう。

ツイート取得テスト

「ツイート取得テスト」はツイートIDを指定して表示するためのものです。
ツイートIDが分かっている場合に使用できます。
ツイートIDは「タイムライン取得テスト」で調べることができます。
ピンポイントで誰かのツイートを引用したい場合に利用します。

「ツイートショートコードを表示する」にチェックを入れるとショートコードが出力されます。

タイムライン取得テスト

「タイムライン取得テスト」は特定または不特定のユーザーのタイムラインを表示します。
取得したいユーザーのIDを指定しない場合は、現在Twitterで投稿されている最新のツイートを取得します。

「ツイートショートコードを表示する」にチェックを入れるとショートコードが出力されます。

ツイート検索テスト

「ツイート検索テスト」は「検索したいキーワード」を入力すると、そのキーワードに応じたツイートを取得します。
検索するキーワードはTwitterの検索方法に準じます。例えばキーワードに「-(マイナス記号)」を付けると否定検索ができます。

文章にあるキーワードを含むツイートに絞りたい場合は、「文頭一致ワード」「文中一致ワード」「文末一致ワード」を指定してフィルタリングができます。

文頭一致ワード　文章の最初に一致するワード
文中一致ワード　文章の中間に一致するワード
文末一致ワード　文章の最後に一致するワード(。は除く)

例えば、最後が「楽しいね」で終わるツイートに絞り込みたい場合は「検索したいキーワード」に「ディズニーランド楽しいね」と入力して「文末一致ワード」に「楽しいね」と入力して検索します。
なお、ツイートが存在せず取得できない場合は表示されません。ツイートは過去1週間以内までを検索できます。

ショートコードの使い方

ショートコードは2種類あります。

IDが指定されていません。　ツイートID指定ショートコード
検索キーワードが指定されていないためデータの取得に失敗しました。　ツイート検索ショートコード

ツイートID指定ショートコード

ツイートID指定ショートコードは記事中に以下のように指定します。idには取得したいツイートIDを指定します。

取得に失敗しました。

テーマテンプレート内やサイドバーウィジェットで表示する場合は「do_shortcode()関数」を使って以下のようにします。

do_shortcode( '取得に失敗しました。' )

コードの呼び出す位置に応じてechoやセミコロンで閉じて下さい。

ショートコードの使い方

ツイート検索ショートコード

検索ツイートショートコードは記事中に以下のように指定します。

【Getwin取得処理中】負荷分散処理のためリアルタイムでは取得されません。スケジュールの順番が来るまでしばらくお待ち下さい。

keywordプロパティは必須です。その他は必要なければ省略可能です。

keyword	検索ワード
alt_keyword	検索ワードで検索結果が取得できなかった場合に再検索する代替キーワード
use_title	検索キーワードとして記事タイトルを使う使う:1 使わない:0
use_search_type	検索キーワードとして記事タイトルを使う場合の条件 AND検索:AND OR検索:OR(初期設定ではAND検索)
before	文頭一致ワード
middle	文中一致ワード
after	文末一致ワード
cache_time	キャッシュ時間(秒数)省略で半永久
view_num	表示件数
cache_num	キャッシュしておくツイート件数
meta_key	同一ページで複数のショートコードを使う場合のメタキー名
word_cnt	タイトルをキーワードとして使用する場合の単語の最低文字数
similar_del_func	1:類似ツイートを削除する 0:削除しない
limit_score	類似ツイートを削除する判定スコア
expression_fix	1:辞書を使って置き換える 0:置き換えない
include_entities	true:画像を表示する false:画像は表示しない

テーマテンプレート内やサイドバーウィジェットで表示する場合は「do_shortcode()関数」を使って以下のようにします。

do_shortcode( '【Getwin取得処理中】負荷分散処理のためリアルタイムでは取得されません。スケジュールの順番が来るまでしばらくお待ち下さい。' )

コードの呼び出す位置に応じてechoやセミコロンで閉じて下さい。

ショートコードの使い方

ショートコードの自動化と応用

ショートコードは他のプラグインと連携ができます。自動投稿系のプラグインでテンプレートをいじれるのなら、そのテンプレート内にショートコードを挿入することで自動投稿と同時にツイートが取得できます。ただし、検索ワードは必ず指定しなければならないので、検索ワードを指定して下さい。

【Getwin取得処理中】負荷分散処理のためリアルタイムでは取得されません。スケジュールの順番が来るまでしばらくお待ち下さい。

検索ワードが取得できない場合は、「use_title」プロパティを有効化しておくと、投稿タイトルを検索キーワードとして検索します。