AutoTweet2プラグイン(自動ツイート)
概要
ページに変更があった場合に、Twitter APIを通してツイートします。
Autotweet(1)プラグインが長い事サポートされていないようなので、一から作りました。
このプラグインを作る際、こちらのサイト(日本語)に大変助けられました。
導入
お使いのWikiにただプラグインをインストールするだけでは、オートツイートが有効になりません。こちらの節を最後までお読み下さい。
お使いのWikiにプラグインをインストール
プラグインマネージャーと上記URLを利用して、プラグインの最新版をインストールします。手動でインストールする方法はこちらに記載されています。
追加の操作
Twitter APIを使うには、Twitter Developer Platformへの登録が必要となります。
申し訳ありませんが、プラットフォームへの登録やAPI取得について解説する気力が無いので、各自でググって下さい。
Twitterに承認されるまで数日掛かるのでご注意下さい。
Twitter APIの取得後は…
Consumer KeyとConsumer Secret、Access Token、Access Token Secretを、プラグインに登録します。管理画面からサイト設定を選択し、Autotweet2の所までスクロールして下さい。そして、画像の通り、入力欄を埋めて下さい(ここでついでに他の設定も変更出来ます)。
画面は https://apps.twitter.com のものです。このウェブサイト経由でのAPI取得は不可能になりました。
Consumer SecretとAccess Token Secretは外部に漏れてはいけません。お使いのWikiのconfディレクトリが保護されているかご確認下さい(詳細)。
これで、準備が整いました(おつかれさんです)。
使い方
お使いのWikiのページに変更があったら、そのURLと共にTwitterアプリが通知してくれます(ツイート投稿)。
設定系統
サイト設定から以下の設定を変更出来ます。
オプション | 説明 | 値のタイプ | デフォルト値 |
---|---|---|---|
apiKey , apiSecret , accessToken , and accessTokenSecret | 上の説明をご参照下さい。 | string | 1) |
subjectOfTweet | オートツイートの対象(編集、復元、作成、削除、編集〔小変更〕から選ぶ) | edit 、revert 、create 、delete 、minor からの複数選択 | edit,revert,create,delete |
template | メッセージのテンプレート 置換される文字列: ###WIKITITLE###→このWikiのタイトル ###PAGETITLE###→編集したページのタイトル ###TYPE###→編集のタイプ(「編集」「復元」「作成」「削除」「編集(小変更)」のいずれかが表示されます) ###SUMMARY###→編集の概要 ###EDITOR###→Wikiに変更を加えた人(設定項目「showuseras」に従います) ###PAGEURL###→編集したページにアクセスするURL(###PAGEURL### が無い場合は、テンプレートの末尾にURLが自動付加されます) | textarea | [###WIKITITLE### - ###TYPE### by ###EDITOR###] ###PAGETITLE###: ###SUMMARY### ###PAGEURL### |
guestIP | 変更者が非ログインユーザーだった際に、テンプレートの「###EDITOR###」部分を何で置き換えるか | 0 (IPアドレスも何も表示しない)、alt (代替テキストで置き換える(Hidingipプラグインが必要です。))、show (IPアドレスを表示する)からのプルダウン選択 | 0 |
blacklist | ツイート対象外とするページ(バーティカルバー | で区切って下さい) 記入例:「playground:playground|start|wiki:syntax」 | string | 2) |
debug | 編集者がマネージャーである場合、プラグイン実行時に、デバッグデータ(ボディ(JSON)とレスポンスヘッダー)を表示する(プラグインの動作に不具合が起こった際に、その原因を調査するのにご利用下さい) | boolean | 0 |
開発
変更履歴
- 2018-07-02
- 最初のリリース
- 2018-08-29
- アットマーク(半角・全角両方)
@ @
の後に半角スペースを挿入するようにしました(「自動化された@ツイート」を禁止するTwitterルールに違反しないように) - オプション“debug”の追加
- 2018-10-30
- Wikiの変更者をツイートに記載する機能を追加
既知のバグや問題
現在は無し
やる事リスト
もし何か物足りない点があるのであれば言って下さい。なるべく頑張ります。
お問い合わせ
もし何かあればGitHubのページにトピックを作成出来ます。それ以外の件については、以下の連絡先を使えます。