プラグイン ======================= 設定ファイルについて ----------------------- AsakusaSatellite は、環境変数 FILTER_NAME に指定された名前のファイルを /config/ 配下から読み込み、プラグインの設定を行います。 環境変数 FILTER_NAME が指定されない場合には、filter_intra.yml というファイルが利用されます。 このファイルは、イントラネットで AsakusaSatellite をご利用いただくのに適した設定になっています。 以下ではそのファイルの内容についての説明をします。 v0.8.0 以前 ^^^^^^^^^^^^^^^^^^^^^^^ /plugins/ 配下に置かれたプラグインは、基本的にすべて有効になります。 フィルタは、適用される順序を指定することができます。 フィルタとは、メッセージを加工するためのプラグインで、 AsakusaSatellite::Filter::Base を継承したものです。 設定ファイルの内容は例えば以下のようになります。 .. code-block:: ruby - name: code_highlight_filter - name: quote_it - name: redmine_ticket_link - name: twitter_link - name: emoji_filter 値にはフィルタのクラス名をスネークケースに変換したものを指定します。 メッセージの加工は、上から書かれた順に実行されます。 設定ファイルに書かれなかったフィルタは適用されません。 v0.8.1 以降 ^^^^^^^^^^^^^^^^^^^^^^^ /plugins/ 配下に置かれたプラグインは、置くだけでは有効になりません。 設定ファイルにプラグインを記述することで初めて有効になります。 設定ファイルの内容は例えば以下のようになります。 .. code-block:: ruby info: version: 2 filters: - name: code_highlight_filter - name: auto_link - name: redmine_ticket_link - name: twitter_link - name: emoji_filter plugins: - dir: as_twitterauth_plugin filters には、v0.8.0 以前でも設定したように、フィルタの適用順序を記載します。 plugins には、フィルタではないプラグインの中で有効にしたいプラグインを指定します。 フィルタではないプラグインとは、ビューフックや認証プラグインのことを指します。 プラグインの指定方法は二種類あります。 dir キーを指定した場合には、プラグインのディレクトリ名を指定します。 .. code-block:: ruby plugins: - dir: as_twitterauth_plugin name キーを指定した場合には、フィルタのクラス名をスネークケースに変換したものを指定します。 ただしこの場合、プラグインのディレクトリ名は、 as_<フィルタのクラス名をスネークケースに変換したもの> という名前になっている必要があります。 この規約が守られていない場合も、以下の例のように name と dir を同時に指定することでディレクトリを指定して、フィルタを有効にすることができます。 .. code-block:: ruby filters: - name: auto_link dir: as_autolink なお、v0.8.1 以降でも v0.8.0 の設定ファイルのフォーマットを利用することができます。 その場合は、プラグインの読み込みの挙動は v0.8.0 と同等の動きをします。 デスクトップ通知 ----------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ デスクトップ通知を有効にするプラグインです。 v0.8.1 でプラグインとして切りだされました。 詳細は :ref:`desktopnotification` を参照してください。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml に以下を記述します .. code-block:: ruby - dir: as_desktopnotification また、部屋ごとに通知の有効無効を設定できます。 画面右上のログインユーザのリンクをクリックし、 **Settings for each rooms** で部屋名の右のボタンをクリックしてください。 * **Notification On** と表示されている部屋はデスクトップ通知が有効です。 * **Notification Off** と表示されている部屋はデスクトップ通知が無効です。 .. image:: images/notification_room_config.png Redmine 連携 ----------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ **#数字** を Redmine のチケットへのリンクに変換します。 API アクセスキーが設定されている場合は、チケットの名前を自動で付加します。 また、メッセージの内容を Redmine に投稿するためのリンクを各メッセージに付加します。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml に以下を記述します .. code-block:: ruby - name: redmine_ticket_link また部屋の設定画面からRedmineのルートURL、APIアクセスキー、チケットを作成するプロジェクトを指定できます。 APIアクセスキーはRedmineの"個人設定 > API アクセスキー"から確認できます。 .. image:: images/redmine_config.png .. _graphviz: コードハイライト ----------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ ソースコードをハイライトします。 記法は * １行目に **言語\:\:** * ２行目以降に **ソースコード** を記述します。 例えば, .. code-block:: ruby ruby:: puts "Hello World!" と記述することで、２行目がハイライトして表示されます。 また、Graphviz の dot 記法もサポートしています。 .. code-block:: ruby graphviz:: digraph{A->B->C->A} のように、 **graphviz::** に続けて dot 記法を記述することで 簡単なグラフを描画することができます。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml に以下を記述します .. code-block:: ruby - name: code_highlight_filter 汎用リンク ----------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ http:// https:// で始まるURLをリンクに変換します。また、 以下のサイトは画像として展開します。 * twitpic.com * f.hatena.ne.jp * movapic.com * yflog.com * ow.ly * youtu.be * img.ly * www.nicovideo.jp * plixi.com * dl.dropbox.com * gyazo.com * instagr.am * .jpg, .jpeg, .png, .gif で終わる URL (case insensitive) 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml に以下を記述します .. code-block:: ruby - name: auto_link Twitter リンク ----------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ メッセージ中の **@username** をTwitterアカウントへのリンクに変換します。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml に以下を記述します .. code-block:: ruby - name: twitter_link .. _localauth: QuoteItプラグイン ------------------------------ 機能 ^^^^^^^^^^^^^^^^^^^^^^^ メッセージ中のURLを `QuoteIt `_ を用いて展開します。 各種画像サービス、Twitter、Slideshare等の展開ができます。 展開可能なサイトの一覧は `こちら `_ を参照してください。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml に以下を記述します .. code-block:: ruby - name: quote_it 絵文字プラグイン ----------------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ メッセージ中の :絵文字名: を画像として展開します。 また、メッセージを入力中に ":" を入力すると、利用可能な絵文字をサジェストします。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml に以下を記述します .. code-block:: ruby - name: emoji_filter 利用可能な絵文字の一覧は、 `Emoji cheat sheet `_ をご参照ください。 .. image:: http://www.emoji-cheat-sheet.com/graphics/emojis/smile.png :width: 16px emoticon プラグイン ----------------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ ルールベースでメッセージの変換を定義し、画像として展開します。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ 1. config/filter\_intra.yml の filter 要素の下に以下を記述します。 .. code-block:: ruby - name: emoticon_filter 2. plugins/as_emoticon_filter/rule.yml を編集し、変換ルールを作成します。 3. /public/emoticons に rule.yml で指定したファイル名で emiticon ファイルを保存します。 rule.yml は yaml 形式でキーにメッセージの変換対象、値に変換後に表示するファイル名を記述します。 例えば、rule.yml に .. code-block:: ruby - (test): test.gif と記述した場合は /public/emoticons/test.gif に画像ファイルを保存し、メッセージ中に (test) と記述することで画像が展開されます。 CSS/Javascriptプラグイン ---------------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ すべてのページに指定されたスタイルシート・Javascriptを挿入することで、簡単に機能拡張できるようにします。 設定 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml の plugins 要素の下に以下を記述します .. code-block:: ruby - dir: as_global_js_css 使い方 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 1. 各ページのフッターにある **AsaksuaSatellite** リンクをクリックします。 .. image:: images/about_link.png 2. 全体設定画面が表示されるので、スタイルシート・Javascriptを追加します。 .. image:: images/plugin_css_js.png 拡張例 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 未読件数表示(https://gist.github.com/4189242) faviconにメッセージの未読件数を表示します。 ローカル認証 ----------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ AsakusaSatellite は Twitter の OAuth を用いて認証を行いますが、 本プラグインを有効にすると、ローカルのユーザリストを用いた認証に切り替えます。 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml の plugins 要素の下に以下を記述します .. code-block:: ruby - dir: as_localauth_plugin /config/settings.yml に以下を記述します。 本設定を行うことにより、Twitter の OAuth による認証は無効になり、 ローカル認証が有効になります。 .. code-block:: ruby omniauth: provider: "local" 次に、ユーザリストにユーザを追加します。 ユーザリストは以下のファイルです。 /plugins/as_localauth_plugin/config/users.yml 内容は以下の形式です。 .. code-block:: ruby testuser1: screen_name: Test User1 password: b444ac06613fc8d63795be9ad0beaf55011936ac profile_image_url: http://example.com/test1_user.png ユーザリストは YAML 形式で記述します。 **testuser1 の部分** にはユーザ ID を記述します。 **screen_name** はユーザの表示名を記述します。 **password** にはパスワードの SHA-1 ハッシュを記述します。 SHA-1 ハッシュの生成は、以下のコマンドで行うことができます。 .. code-block:: sh $ ruby /plugins/as_localauth_plugin/script/gen_sha1 **profile_image_url** にはユーザのアイコンの URL を記述します。 データ URI スキームも指定することもできます。 testuser2 の例を参考にしてください。 Redmine API アクセスキー認証 -------------------------------- 機能 ^^^^^^^^^^^^^^^^^^^^^^^ AsakusaSatellite の認証を Redmine の API アクセスキーによる認証に切り替えます。 .. image:: images/as_redmineauth_plugin.png 設定 ^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml の plugins 要素の下に以下を記述します .. code-block:: ruby - dir: as_redminelauth_plugin /config/settings.yml に以下を記述します。 .. code-block:: ruby omniauth: provider: 'redmine' provider_args: - 'Redmine の URL' 使用方法 ^^^^^^^^^^^^^^^^^^^^^^^ 1. 「ログイン」リンクをクリックします。 2. 以下の情報を入力します * RedmineのAPIアクセスキー * AsakusaSatellite で使用するユーザ名 * AsakusaSatellite で使用する画像の URL 3. ログインボタンをクリックします。 private な部屋に追加するときの注意点 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ このプラグインで認証されたユーザは、ユーザ ID として Redmine のユーザの **メールアドレス** が保存されます。 したがって、private に設定された部屋にこのプラグインで認証されたユーザを追加する場合は、Redmine のユーザの **メールアドレス** を指定する必要があります。 .. _watage: Watage プラグイン ------------------------------------------------------ 機能 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ AsakusaSatellite を Heroku にデプロイした場合、 Heroku の制限により、ファイルアップロード機能が利用できません。 そこでストレージサービスの汎用インタフェースである `Watage `_ を利用し、添付ファイルをDropboxなどのクラウドストレージ上に保存するプラグインです。 Watage の詳細については、 `Watage のドキュメント `_ を参照ください。 設定 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ config/filter\_intra.yml の plugins 要素の下にに以下を記述します .. code-block:: ruby - dir: as_watage_plugin token/secret tokenをWatageから取得した上で、config/settings.yml に以下を記述します。 .. code-block:: ruby attachment_policy: watage attachment_path: watage_token: watage_token_secret: