Dieser Leitfaden erklärt, wie du Emojis auf deiner Discourse-Seite durch auswählbare Emoji-Sets, das Hochladen neuer Emojis, die Konfiguration von Seiteneinstellungen und das Anpassen der Emoji-Größen anpassen kannst.
Erforderliches Benutzerlevel: Administrator
Auswahl eines Emoji-Sets
Discourse unterstützt derzeit fünf Emoji-Sets:
- Fluent UI
- Noto
- OpenMoji
- Twemoji
- Standard (Unicode)
Für einen Überblick, wie die verschiedenen Sets aussehen, kannst du dir diesen Emoji-Set-Vergleich ansehen. Du kannst die Seiteneinstellung emoji_set unter /admin/config/emoji/settings zusammen mit anderen emoji-bezogenen Einstellungen konfigurieren.
Hinzufügen benutzerdefinierter Emojis
Um benutzerdefinierte Emojis hinzuzufügen:
-
Gehe zu Admin → Erscheinungsbild → Emoji unter
/admin/config/emoji -
Klicke auf die Schaltfläche Emoji hinzufügen, um deinen Emoji zu benennen, zu klassifizieren und das Emoji-Bild hochzuladen
Wenn du mehrere Emoji-Dateien hochladen möchtest, kannst du im Dateiauswähler bis zu 10 Bilddateien auswählen, um sie in einem Batch hochzuladen. In diesem Fall werden die Dateinamen der Bilder als Emoji-Namen verwendet.
Massenimport benutzerdefinierter Emojis
Du kannst bis zu 1000 Emojis über eine einzelne ZIP-Datei mit einer emojis.csv-Manifestdatei importieren. Die CSV-Datei muss die folgenden Spalten mit Kopfzeilen enthalten: name, group, filename.
name,group,filename
emoji_a,group_name,image.png
Der Importprozess basiert vollständig auf dem Manifest. Wenn eine Datei oder Zeile fehlt, wird sie übersprungen. Das Feld group kann leer gelassen werden, in diesem Fall wird das benutzerdefinierte Emoji zur Gruppe default hinzugefügt.
Zum Importieren:
-
Gehe zu Admin → Erscheinungsbild → Emoji unter
/admin/config/emoji -
Klicke auf die Schaltfläche Importieren und wähle die ZIP-Datei aus, die deine Emojis enthält.
-
Vorschau des Imports und Bestätigung der Änderungen. Hier kannst du Konflikte lösen, indem du auswählst, welches Emoji beibehalten werden soll. Konflikte können auftreten, wenn ein bestehendes Emoji mit demselben Namen (und anderer Gruppe/Bild) bereits existiert. Um den Import abzuschließen, klicke auf Import bestätigen.
Massenexport benutzerdefinierter Emojis
Benutzerdefinierte Emojis können in einer einzigen ZIP-Datei exportiert werden. Die resultierende ZIP-Datei enthält eine emojis.csv-Manifestdatei, die ohne Änderungen in jede Discourse-Seite importiert werden kann. Diese enthält das Bild, den Namen und die Gruppe jedes Emojis.
Zum Exportieren klicke auf die Schaltfläche Zum Exportieren auswählen und wähle alle Emojis aus, die du exportieren möchtest. Wenn du fertig bist, klicke auf die Schaltfläche Exportieren, und eine ZIP-Datei wird heruntergeladen.
Anheften von Emojis an den oberen Rand des Pickers
Du kannst jede Emoji-Gruppe an den oberen Rand des Emoji-Pickers anheften. Greife auf die Einstellung emoji_picker_pinned_groups über Admin → Erscheinungsbild → Emoji → Einstellungen unter /admin/config/emoji/settings zu. Gib den Namen der Emoji-Gruppe ein, die an den oberen Rand des Pickers angeheftet werden soll.
Sowohl benutzerdefinierte als auch reguläre Emoji-Gruppen können an den oberen Rand angeheftet werden. Wenn du beispielsweise flags eingibst, wird die Emoji-Gruppe für Flaggen an die Spitze über die Smileys verschoben.
Namen der Standard-Emoji-Gruppen:
smileys_&_emotionpeople_&_bodyanimals_&_naturefood_&_drinktravel_&_placesactivitiesobjectssymbolsflags
Emoji-Einstellungen
Du kannst auf Emoji-Einstellungen unter /admin/config/emoji/settings zugreifen, um zu steuern, wie Emojis auf deiner Seite funktionieren.
enable_emoji– Aktiviert die Anzeige und Verwendung von Emojis in deiner Discourse-Instanz. Wenn deaktiviert, werden Emojis nicht gerendert und Benutzer können sie in Textfeldern nicht verwenden.emoji_set– Wähle deinen bevorzugten Emoji-Stil. Verschiedene Emoji-Sets können den auf der Seite angezeigten Emojis einzigartige Aussehen verleihen.max_emojis_in_title– Maximale Anzahl erlaubter Emojis im Themen-Titel (Standard: 1). Wenn der festgelegte Wert null ist, wird die Verwendung von Emojis in Themen-Titeln verhindert.enable_emoji_shortcuts– Häufige Smiley-Texte wie:):p:(werden in Emojis umgewandelt.emoji_autocomplete_min_chars– Mindestanzahl an Zeichen, die erforderlich ist, um das Autovervollständigungs-Emoji-Popup auszulösen (Standard: 0).enable_inline_emoji_translation– Aktiviert die Übersetzung für Inline-Emojis (ohne Leerzeichen oder Interpunktion davor).emoji_deny_list– Diese Emojis sind in Menüs oder Shortcodes nicht verfügbar.emoji_picker_pinned_groups– Diese Emoji-Gruppen sind an den oberen Rand des Emoji-Pickers angeheftet.external_emoji_url– URL eines externen Dienstes für Emoji-Bilder. Leer lassen, um die Standardeinstellung zu verwenden.discourse_reactions_enabled_reactions– Definiert eine Liste der aktivierten Reaktionen, hier sind beliebige Emojis erlaubt. Standardreaktionen: +1, laughing, open_mouth, clap, confetti_ball und hugs.discourse_reactions_excluded_from_like– Reaktionen, die nicht als „Gefällt mir“ zählen. Alle Reaktionen, die nicht auf dieser Liste stehen, zählen als „Gefällt mir“ für Abzeichen, Berichte und andere Zwecke.discourse_reactions_allow_any_emoji– Wenn dies aktiviert ist, wird eine Schaltfläche hinzugefügt, die Benutzern ermöglicht, im Reaktions-Picker beliebige Emojis auszuwählen. Mitgliedern wird es erlaubt, beliebige Emojis, einschließlich benutzerdefinierter Emojis, für Reaktionen auszuwählen. Um die verfügbaren Reaktionen zu begrenzen, verwende die Seiteneinstellungemoji_deny_list.
Größenanpassung benutzerdefinierter Emojis
Standardmäßig werden alle Emojis per CSS auf 20x20 skaliert, dies kann jedoch mit benutzerdefiniertem CSS überschrieben werden. Um das richtige Seitenverhältnis und die native Größe in Beiträgen beizubehalten, füge folgendes CSS hinzu:
/* Emojis in normaler Größe anzeigen (kein quadratisches Format erzwingen) */
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;
}
Um die Größe eines bestimmten Emojis anzupassen, verwende:
img.emoji[title=":youremoji:"] {
height: XXpx;
width: YYpx;
}
Zum Skalieren von Emojis in Chat-Nachrichten und Benutzerstatus in Chats:
div.chat-message-text img.emoji[src*="uploads"],
span.user-status-message img.emoji[src*="uploads"] {
width: auto;
height: auto;
}