Seite 1 von 1

[3.3] [Fork] Simple mentions

Verfasst: 17.08.2026 19:47
von Joe Kolade
Name der Extension: Simple mentions

Autor: Moe (unter Mitwirkung von Joe Kolade)

Version: 3.0.0

Sprachen: de, de_x_sie, en

Beschreibung:
Die Simple mention Erweiterung ermöglicht es, einen Benutzer zu erwähnen, indem man im Eingabefeld für Beiträge mit der Eingabe des @-Zeichens beginnt. Sobald ein Benutzer aus der Auswahlliste ausgewählt ist, wird der [mention]-BBCode eingefügt. Nach dem Absenden des Beitrags erhält der betreffende Benutzer eine Benachrichtigung.

Diese Erweiterung ist ein Fork von Pauls Simple mentions-Erweiterung und fügt phpBB mit @Username ein einfaches Erwähnungssystem hinzu.
Originalerweiterung: https://github.com/paul999/mention

Die Änderungen bzw. Ergänzungen der neuen Version enthalten folgende Features:

- Eigener Bereich in den Erweiterungseinstellungen
- Konfigurierbarer Schriftstil (fett bzw. kursiv)
- Optionale Links von Erwähnungen zu Benutzerprofilen
- Autovervollständigung wird in E-Mail-Adressen nicht mehr ausgelöst
- Aktualisierte Standardwerte: Die Autovervollständigung beginnt nach 2 Zeichen und liefert bis zu 25 Ergebnisse
- Verbesserte Rückmeldung der Autovervollständigung, wenn die Eingabe kürzer als die konfigurierte Mindestlänge ist
- Optionales Überschreiben der E-Mail-Vorlage je Sprache über mention_mail-overwrite.txt
- Überarbeitete deutsche und englische Texte für Berechtigungen und E-Mail-Benachrichtigungen

Hinweise:
Dieser Fork verwendet weiterhin den ursprünglichen Installationspfad paul999/mention.
Die Erweiterung wurde bisher nur auf der eigenen phpBB-Installation getestet.

Screenshots:
Konfigurationsbereich
Simple Mentions - Aufruf
Simple Mentions - Auswahlliste

Voraussetzungen:
phpBB >=v3.3.0
php >= v7.1.x - 8.0.x

Download:
https://github.com/MoeMorox/mention/releases

Installation der Erweiterung:
Nach dem Download die Erweiterung extrahieren und den gesamte Ordner paul999 nach root/ext hochladen ({PHPBB_ROOT}/ext/paul999/mention/).
Im Administrations-Bereich (ACP) unter „Anpassen“ > „Erweiterungen verwalten“ und die Erweiterung „Simple mentions“ aktivieren.
Anschließend im Administrations-Bereich (ACP) unter „Benutzer und Gruppen“ > im Bereich Gruppen „Gruppenrechte“ in den erweiterten Berechtigungen die Rechte für die ausgewählte Benutzergruppe überprüfen. Unter Diverses können die Rechte für „Kann Simple mentions (Erwähnungs-System) nutzen“, „Kann Gruppen bei Simple mentions erwähnen“ und „Kann große Gruppen bei Simple mentions erwähnen“ festgelegt werden.
„Can use the mention system“, „Can mention groups“, and „Can mention large groups where needed“

Hinweis:
Ein Benutzer aus einer freigegebenen Benutzergruppe kann unter „Persönlicher Bereich“ > „Einstellungen“ „Benachrichtigungen einstellen“ angeben, ob er benachrichtigt werden möchte, wenn ihn jemand in einem Beitrag erwähnt hat.

Konfiguration der Erweiterung:
Gehe zum Administrations-Bereich (ACP) unter „Erweiterungen“ > „Simple mentions“.
Hier lassen sich die verschiedenen Einstellungen ändern.

Übersetzungen:

Derzeit sind für diese Version nur die Sprachdateien en, de und de_x_sie verfügbar.

Andere bestehende Sprachen wurden vom ursprünglichen Projekt übernommen und werden in diesem Fork nicht aktiv gepflegt.
Wenn du eine andere Sprache verwendest, überprüfe und aktualisiere die Texte, bevor du sie produktiv einsetzt.

Überschreiben der E-Mail-Vorlage:
Wenn ein Benutzer angegeben hat, dass er per E-Mail über eine Erwähnung benachrichtigt werden möchte, wird standardmäßig die Vorlage „mention_mail.txt“ im Verzeichnis email des jweiligen Sprachverzeichnisses (language/<language>/email/) verwendet.

Um die E-Mail-Vorlage zu überschreiben, ohne die Standarddatei zu ändern, erstellt man folgende Datei für die entsprechende Sprache:

language/<language>/email/mention_mail-overwrite.txt

Für Deutsch zum Beispiel:

language/de/email/mention_mail-overwrite.txt
language/de_x_sie/email/mention_mail-overwrite.txt

Wenn keine Überschreibungsdatei für die Sprache des Empfängers existiert, fällt phpBB auf die Standardversion zurück.
Nachdem du die Sprache oder die Template-Dateien geändert wurde, ist der phpBB-Cache zu löschen!

Verfügbare Vorlagenvariablen:

{AUTHOR_NAME}: Name des Nutzers, der jemanden erwähnt hat
{TOPIC_TITLE}: Titel des Themas
{U_LINK_TO_TOPIC}: Direkter Link zum Beitrag
sowie
{SITENAME}: Standard-phpBB-Variable
{EMAIL_SIG}: Standard-phpBB-Variable

Changelog:
v1.0.0 (11.07.2026)
- Erste Version

Re: [3.3] [Fork] Simple mentions

Verfasst: 17.08.2026 20:50
von LukeWCS
Hallo Joe und Moe

Nur ein kleiner Hinweis aufgrund dem was ich auf GitHub sehe: Ihr habt nur in der composer.json den Fork Autor angegeben, jedoch nicht in den anderen Dateien. Das heisst aus GPL Sicht habt ihr zwar in der "unwichtigsten" Datei den Fork Autor angegeben, aber relevant wären Copyright Informationen in allen Dateien, in denen der Original Autor eingetragen wurde. Die Daten der besagten JSON Datei werden ja lediglich im ExtMgr von phpBB angezeigt, das ist also eine phpBB-spezifische Datei die nicht direkt etwas mit der GPL Lizenz zu tun.

Orientiert euch an Pauls Einträgen und fügt euren darüber ein, z.B. so in der Art:

Code: Alles auswählen

 * @copyright (c) 2026, Joe und Moe, https://github.com/MoeMorox/mention
 * @copyright (c) 2016, paul999, https://www.phpbbextensions.io
Am einfachsten könnt ihr alle Copyrights finden, indem ihr per Volltextsuche nach "@copyright" sucht.

Hintergrund: für die Änderungen am Fork seid ihr zuständig und verantwortlich, nicht Paul. Und es sollte auch in jeder Datei mit Copyright-Infos immer klar sein, wer der aktuelle/letzte Maintainer des Codes ist. Ansonsten passt es was ich bez. Fork und GPL gesehen habe. Dadurch das ihr einen GH Fork gemacht habt, habt ihr z.B. auch automatisch die Nachweispflicht bez. Änderungen erfüllt.

Re: [3.3] [Fork] Simple mentions

Verfasst: 17.08.2026 21:33
von Joe Kolade
Danke für den Hinweis!