ブロードキャストメッセージ

GitLabでは、ブロードキャストメッセージを2種類、GitLabインスタンスのユーザーに表示できます:

• バナー
• 通知

ブロードキャストメッセージAPIを使用してブロードキャストメッセージを管理できます。

バナー

バナーはページ上部に表示され、オプションでコマンドラインにGitリモートレスポンスとして表示されます。

$ git push
...
remote:
remote: **Welcome to GitLab** :wave:
remote:
...

複数のバナーが同時にアクティブになっている場合は、作成順にページ上部に表示されます。コマンドラインには、最新のバナーのみが表示されます。

通知

GitLabは、ページの右下に通知を表示します。これらにはプレースホルダーを含めることができ、現在のユーザーの属性に置き換えられます:

{{name}}, would you like to give us feedback?
<a href="example.com">Take our survey!</a>

複数の通知が同時にアクティブになっている場合は、最新のもののみが表示されます。

通知は、次のプレースホルダーをサポートしています:

• {{email}}
• {{name}}
• {{user_id}}
• {{username}}
• {{instance_id}}

ユーザーがサインインしていない場合、ユーザー関連の値は空です。

ブロードキャストメッセージを追加

GitLabインスタンスのユーザーにメッセージを表示するには、ブロードキャストメッセージを追加します。

ブロードキャストメッセージを追加するには:

1. 左側のサイドバーの下部で、管理者を選択します。
2. 左側のサイドバーの下部にあるメッセージを選択します。
3. 右側で、新しいメッセージを追加を選択します。
4. メッセージテキストを追加します:
   • メッセージの内容には、Markdown、絵文字、およびaおよびbr HTMLタグを含めることができます。
   • brタグは改行を挿入します。
   • a HTMLタグは、次のCSSプロパティを持つclassおよびstyle属性を受け入れます:
     • color
     • border
     • background
     • padding
     • margin
     • text-decoration
5. 種類で、bannerまたはnotificationを選択します。
6. テーマを選択します。デフォルトのテーマはindigoです。
7. ユーザーがブロードキャストメッセージを無視できるようにするには、却下可能を選択します。
8. オプション。コマンドラインにGitリモートレスポンスとしてブロードキャストメッセージを表示しないようにするには、Gitリモートレスポンスをクリアします。
9. オプション。メッセージをユーザーのサブセットのみに表示するには、対象のブロードキャストメッセージを選択します:
   • すべてのページのすべてのユーザーに表示します。
   • 特定の一致するページのすべてのユーザーに表示します。
   • グループまたはプロジェクトページで特定のロールを持つユーザーのみに表示します。この設定は、グループ、サブグループ、およびプロジェクトページにメッセージを表示しますが、Gitリモートレスポンスには表示しません。
10. 必要に応じて、ブロードキャストメッセージを表示する対象のロールを選択します。
11. 必要に応じて、そのパスに一致するURLにのみブロードキャストメッセージを表示するように対象のパスを追加します。複数のURLを照合してパスを指定するには、ワイルドカード文字*を使用します。例:
    • グループまたはプロジェクトのマイルストーンインデックスページの場合は*/-/milestones。
    • 個々のマイルストーンページのみの場合は*/-/milestones/*。
    • インデックスおよび個々のマイルストーンページの両方の場合は*/-/milestones*。
12. メッセージの開始日と終了日として日付と時刻（UTC）を選択します。
13. ブロードキャストメッセージを追加を選択します。

ブロードキャストメッセージが期限切れになると、ユーザーインターフェースには表示されなくなりますが、ブロードキャストメッセージのリストには引き続き表示されます。

ブロードキャストメッセージを編集

ブロードキャストメッセージを変更する必要がある場合は、編集できます。

ブロードキャストメッセージを編集するには:

1. 左側のサイドバーの下部で、管理者を選択します。
2. 左側のサイドバーの下部にあるメッセージを選択します。
3. ブロードキャストメッセージのリストから、メッセージの編集ボタンを選択します。
4. 必要な変更を加えたら、ブロードキャストメッセージを更新を選択します。

期限切れのメッセージは、終了日を変更することで再びアクティブにできます。

ブロードキャストメッセージを削除

ブロードキャストメッセージが不要になった場合は、削除できます。ブロードキャストメッセージがアクティブな間に削除できます。

ブロードキャストメッセージを削除するには:

1. 左側のサイドバーの下部で、管理者を選択します。
2. 左側のサイドバーの下部にあるメッセージを選択します。
3. ブロードキャストメッセージのリストから、メッセージの削除ボタンを選択します。

ブロードキャストメッセージを削除すると、ブロードキャストメッセージのリストから削除されます。