このガイドでは、選択可能な絵文字セット、新しい絵文字のアップロード、サイト設定の構成、および絵文字のサイズ調整を通じて、Discourse サイトの絵文字をカスタマイズする方法を説明します。
必要なユーザーレベル: 管理者
絵文字セットの選択
Discourseは現在、5つの絵文字セットをサポートしています。
- Fluent UI
- Noto
- OpenMoji
- Twemoji
- Standard (Unicode)
異なるセットの見た目について概要を知りたい場合は、この絵文字セット比較をご覧ください。emoji_setサイト設定は、他の絵文字関連設定とともに /admin/config/emoji/settings で構成できます。
カスタム絵文字の追加
カスタム絵文字を追加するには:
-
/admin/config/emojiの Admin → Appearance → Emoji に移動します。 -
Add emoji ボタンをクリックして、絵文字に名前を付け、分類し、絵文字の画像をアップロードします。
複数の絵文字ファイルをアップロードする場合は、ファイルピッカーで最大10個の画像ファイルを選択して一括アップロードできます。この場合、画像のファイル名が絵文字の名前として使用されます。
カスタム絵文字の一括インポート
emojis.csv マニフェストを含む単一のZIPファイルを介して、最大1000個の絵文字をインポートできます。CSVファイルには、次の列とヘッダーが必要です: name、group、filename。
name,group,filename
emoji_a,group_name,image.png
インポートプロセスは完全にマニフェストに依存します。ファイルまたは行が欠落している場合、それはスキップされます。group フィールドは空にすることもでき、その場合、カスタム絵文字は default グループに追加されます。
インポートするには:
-
/admin/config/emojiの Admin → Appearance → Emoji に移動します。 -
Import ボタンをクリックし、絵文字を含むZIPファイルを選択します。
-
インポートをプレビューし、変更を確認します。ここで、保持する絵文字を選択して競合を解決できます。同じ名前（および異なるグループ/画像）を持つ既存の絵文字がすでに存在する場合、競合が発生する可能性があります。インポートを完了するには、Confirm import をクリックします。
カスタム絵文字の一括エクスポート
カスタム絵文字は単一のZIPファイルでエクスポートできます。生成されるZIPファイルには、修正なしで任意のDiscourseサイトにインポートできる emojis.csv マニフェストが含まれます。これには、各絵文字の画像、名前、グループが含まれます。
エクスポートするには、Select to export ボタンをクリックし、エクスポートするすべての絵文字を選択します。準備ができたら、Export ボタンをクリックし、ZIPファイルがダウンロードされます。
絵文字ピッカーの上部に絵文字をピン留めする
絵文字ピッカーの上部に任意の絵文字グループをピン留めできます。/admin/config/emoji/settings の Admin → Appearance → Emoji → Settings を介して emoji_picker_pinned_groups 設定にアクセスします。ピッカーの上部にピン留めする絵文字グループの名前を入力します。
カスタム絵文字グループと通常の絵文字グループの両方を上部にピン留めできます。例えば、flags と入力すると、旗の絵文字グループがスマイリーの上部に移動します。
デフォルトの絵文字グループ名:
smileys_&_emotionpeople_&_bodyanimals_&_naturefood_&_drinktravel_&_placesactivitiesobjectssymbolsflags
絵文字設定
/admin/config/emoji/settings で絵文字設定にアクセスし、サイトでの絵文字の動作をカスタマイズできます。
enable_emoji- Discourseインスタンスでの絵文字の表示と使用を有効にします。無効にすると、絵文字はレンダリングされず、ユーザーはテキストフィールドでそれらにアクセスしたり使用したりできなくなります。emoji_set- 好む絵文字のスタイルを選択します。異なる絵文字セットは、サイトに表示される絵文字に独特の外観を提供できます。max_emojis_in_title- トピックタイトルで許可される最大絵文字数（デフォルト: 1）。設定値が0の場合、トピックタイトルでの絵文字の使用が禁止されます。enable_emoji_shortcuts-:):p:(などの一般的なスマイリーテキストが絵文字に変換されます。emoji_autocomplete_min_chars- 絵文字の自動補完ポップアップをトリガーするために必要な最小文字数（デフォルト: 0）。enable_inline_emoji_translation- インライン絵文字（前にスペースや句読点がない）の翻訳を有効にします。emoji_deny_list- これらの絵文字はメニューやショートコードで使用できません。emoji_picker_pinned_groups- これらの絵文字グループは絵文字ピッカーの上部にピン留めされます。external_emoji_url- 絵文字画像の外部サービスのURL。デフォルトを使用する場合は空白のままにします。discourse_reactions_enabled_reactions- 有効なリアクションのリストを定義します。ここでは任意の絵文字が許可されます。デフォルトのリアクション: +1, laughing, open_mouth, clap, confetti_ball, hugs。discourse_reactions_excluded_from_like- Likeとしてカウントされないリアクション。このリストにないリアクションは、バッジ、レポート、その他の目的のためにLikeとしてカウントされます。discourse_reactions_allow_any_emoji- これが有効になると、ユーザーがリアクションピッカーで任意の絵文字を選択できるようにするボタンが追加されます。メンバーは、カスタム絵文字を含む任意の絵文字をリアクションとして選択できるようになります。利用可能なリアクションを制限するには、emoji_deny_listサイト設定を使用します。
カスタム絵文字のサイズ調整
デフォルトでは、すべての絵文字はCSSによって20x20にリサイズされますが、これはカスタムCSSで上書きできます。投稿内の正しいアスペクト比とネイティブサイズを維持するには、次のCSSを追加します:
/* 絵文字を通常サイズにする（正方形に強制しない） */
div.topic-post img.emoji[src*="uploads"],
div.d-editor-preview img.emoji[src*="uploads"],
div.emoji-modal img.emoji[src*="uploads"],
div.d-editor-textarea-wrapper img.emoji[src*="uploads"],
div.title-wrapper img.emoji[src*="uploads"],
td.main-link img.emoji[src*="uploads"] {
width: auto;
height: auto;
}
特定の絵文字のサイズをカスタマイズするには、次を使用します:
img.emoji[title=":youremoji:"] {
height: XXpx;
width: YYpx;
}
チャットメッセージとチャットのユーザーステータス内の絵文字のサイズ調整には:
div.chat-message-text img.emoji[src*="uploads"],
span.user-status-message img.emoji[src*="uploads"] {
width: auto;
height: auto;
}