|||
|—|—|—|
|:discourse2: | 概要 | Discourse Templates は、コンテンツテンプレートを作成して繰り返し使用できるようにする機能です。テンプレートは特別なカテゴリのトピックとして保存され、必要に応じて編集および議論できます。|
|:open_book: | インストールガイド | このプラグインは Discourse のコアに含まれています。プラグインを個別にインストールする必要はありません。
このプラグインは、Discourse Canned Replies の新しいバージョンにほぼ相当しますが、より柔軟で、テンプレートの保存方法が異なります。
特徴
このプラグインは、テンプレートを保存するために 1 つ以上のカテゴリを使用します。これらのカテゴリ内の各トピックの最初の投稿が、返信のテンプレートとして使用されます。
このアプローチにより、discourse-canned-replies で利用可能だったよりもはるかに多くの機能が提供されます。各テンプレートには編集履歴があり、関連付けられたタグを持つことができ、必要に応じて後続の投稿をテンプレートの内容の議論に使用できます。
表示されているトピックのみがテンプレートとして使用されるため、リストにないトピックやアーカイブされたトピックはリストに表示されません。
プラグインは、カテゴリのセキュリティ設定を活用して、どのユーザーがテンプレートを使用できるかを確認します。ユーザーがカテゴリ内のトピックを読み取ることができる場合、「テンプレートの挿入」オプションがコンポーザーで使用可能になります。ユーザーは、アクセス権のあるカテゴリ内のテンプレート/トピックのみを表示できます。
複数の親カテゴリやサブカテゴリを使用して、異なるユーザーグループに異なるテンプレートセットを提供し、テンプレートを整理できます。
プライベートテンプレート
プラグインはプライベートテンプレートもサポートしています。プライベートテンプレートは、テンプレートとしてタグ付けされたプライベートメッセージです。これらのメッセージは、メッセージの作成者 のみ がテンプレートとして利用できます。
アーカイブされたメッセージはテンプレートとしてリストされません。
すべてのプライベートテンプレートは、次の場所で見つけることができます。
/u/{ユーザー名}/messages/tags/{プライベートテンプレートタグ}
設定:
discourse templates enabled: プラグインをアクティブにします。discourse templates categories: テンプレートを保存するために使用されるカテゴリ。これらのカテゴリとそのサブカテゴリ内の各トピックはテンプレートとして使用され、元のカテゴリでそれらを見ることができるユーザーが利用できます。discourse templates enable private templates: プライベートテンプレートの使用を有効にします。discourse templates groups allowed private templates: プライベートテンプレートの使用が許可されているユーザーグループ。
スタッフメンバーは常に許可されます。
discourse templates private templates tags: プライベートメッセージをテンプレートとしてマークするために使用されるタグ。
使用方法
プラグインをインストールしたら、テンプレートを保存するためのカテゴリを少なくとも 1 つ作成する必要があります。
このカテゴリ内のトピックを読む権限を持つすべてのユーザーが、コンポーザーでプラグイン機能を使用できることに注意してください。
その後、プラグイン設定でカテゴリを指定します。
これで完了です。指定されたカテゴリにいくつかのトピックを作成すると、テンプレートとして利用できるようになります。
必要に応じて、テンプレートをより整理したり、複数のユーザーグループに異なる返信セットを提供したりするためにサブカテゴリを作成できます。
テンプレートを挿入するには、まず返信コンポーザーを開き、追加ボタンをクリックして、「テンプレートの挿入」オプションを選択する必要があります。
目的のテンプレートを選択します。テキストまたはタグで検索し、「貼り付け」アイコンをクリックできます。
キーボードショートカット
PC では Ctrl+Shift+I、Mac では ⌘+Shift+I を使用してテンプレートを挿入できます。
プライベートテンプレート
機能が動作するようにするには、次の Discourse 設定を構成する必要があります。
tagging enabled: 有効にする必要があります。enable personal messages: 非スタッフユーザーが機能を利用できるようにしたい場合は有効にする必要があります。pm tags allowed for groups: プライベートメッセージにタグを付けることを許可するグループを許可する必要があります。
プライベートテンプレートを使用するには、まず設定で有効にし、使用できるユーザーグループを割り当て、PM をテンプレートとしてマークするための少なくとも 1 つのタグを割り当てる必要があります。
個人用テンプレートを作成するには、ユーザーは次の手順を実行する必要があります。
- プラグイン設定で構成されたタグのいずれかでタグ付けされた、自分自身への暗号化されていない個人用メッセージを送信します。メッセージの作成者のみ がそれをプライベートテンプレートとして表示できます。
事前定義された変数
プラグインは、テンプレートで次の変数をサポートしています。
my_usernamemy_nametopic_titletopic_urloriginal_poster_usernameoriginal_poster_namereply_to_usernamereply_to_namelast_poster_usernamereply_to_or_last_poster_username。
上記のすべての変数は、フォールバックテキストをサポートしており、フォールバックが指定されておらず、変数を置き換えることができない場合は、変数が削除されます。
タイトルと本文の両方で変数置換がサポートされています。
例：
Hi %{reply_to_username,fallback:there},
...
Regards,
%{my_name}
reply_to_username が利用できない場合、テンプレートは次のようになります。
Hi there,
...
Regards,
Arpit Jalan
discourse-canned-replies からの移行
既存の定型返信をテンプレートに移行するための rake タスクがあります。
rake "discourse-templates:migrate-from-canned-replies"
Meta で 47 件の定型返信を移行するのに数秒しかかからなかったので、大量の定型返信がない限り、安全に使用できるはずです。
TODO
コンポーザー以外の場所でも機能を利用できるように拡張する
複数の親カテゴリをテンプレートソースとして使用できるようにする
このプラグインは、