Handbuch:Erweiterung/NotifyMe/Email layout: Unterschied zwischen den Versionen

K ((Benutzername entfernt) (Logbucheinzelheiten entfernt))
K ((Benutzername entfernt) (Logbucheinzelheiten entfernt))
 

Aktuelle Version vom 4. September 2024, 12:49 Uhr


Ab BlueSpice 4.5 können Sie die Email-Vorlagen für Benachrichtigungen direkt im Wiki anpassen.

Anpassen der Benachrichtigungs-E-Mails[Bearbeiten | Quelltext bearbeiten]

Für die Emails werden drei Vorlagen verwendet:

  • MediaWiki:Wrapper.mail: Wie der Name schon sagt, umschließt diese Vorlage den eigentlichen Email-Text. Hier können Sie das Logo ändern.
  • MediaWiki:SingleNotification.mail: Inhalt für die Sofortbenachrichtigungen.
  • MediaWiki:DigestNotification.mail: Inhalt für die täglichen oder wöchentlichen Sammelbenachrichtigungen.
Vorlagenausgabe mit äußerem Wrapper und innerer Inhaltsvorlage
Benachrichtigungsmail-Vorlage (Benutzersprache Englisch)

Da die Anpassungen im Quelltextbearbeitungsmodus vorgenommen werden müssen, sind Kenntnisse in Wikitext, HTML und CSS erforderlich.

MediaWiki:Wrapper.mail[Bearbeiten | Quelltext bearbeiten]

Der Mail-Wrapper enthält das allgemeine Styling der Email. Hier können Sie das Logo festlegen, welches in den Emails verwendet wird. Standardmäßig wir das Logo angezeigt, das in FlexiSkin definiert ist.

Das Wiki zeigt eine Vorschau des aktuellen Email-Layouts. Sie können diese Seite nun im Quelltext-Bearbeitungsmodus bearbeiten. Das Layout wird durch eine Kombination von HTML-Container-Elementen generiert, die den Parameter „Inhalt“ umschließen. Wie bei jeder Wiki-Seite erstellen Sie einen Versionsverlauf Ihrer Änderungen und können bei Bedarf problemlos zum ursprünglichen Layout zurückkehren.

Das HTML-Tag „head“ definiert einige Metainformationen und muss nicht geändert werden.

Im „body“-Tag werden die Hintergrundfarbe und der Inhaltsabstand festgelegt. Wenn Sie FlexiSkin nicht verwenden oder eine benutzerdefinierte Vorlage auf dem Server definiert haben, ist der Hintergrund weiß.

Der erste div-Container umschließt das Logo und enthält einige Stile, die im Skin des Wikis vordefiniert sind. Dies können hier überschrieben werden. Da die Textfarbe normalerweise schwarz oder dunkelgrau ist, können Sie meistens die Einstellungen so belassen, wie sie sind.

Logo ändern[Bearbeiten | Quelltext bearbeiten]

Um ein Logo zu verwenden, das Sie in das Wiki hochgeladen haben, fügen Sie dessen Pfad als Bildquelle hinzu. Beispiel:

<img src="/w/nsfr_img_auth.php/c/c9/mycompany-logo.jpeg" width="150px" alt="MyCompany logo"/>

Wenn Sie diese Seite bearbeiten, achten Sie darauf, den Inhaltsplatzhalter nicht zu entfernen. Dieser Platzhalter wird benötigt, um den eigentlichen Email-Text aus der Vorlage für Einzel- oder Sammelbenachrichtigungen hinzuzufügen und sieht folgendermaßen aus:

{{{content}}}

Wechseln wir zu den Inhaltsvorlagen.

MediaWiki:SingleNotification.mail[Bearbeiten | Quelltext bearbeiten]

Die Vorlage für eine einzelne Benachrichtigung versendet eine Email unmittelbar nach einem auslösenden Ereignis. Da diese Vorlage für alle Arten von Benachrichtigungen verwendet wird, sollten Sie den Standardinhalt in den meisten Fällen unverändert lassen. Sie können jedoch beispielsweise zusätzlichen Inhalt hinzufügen.

Hier füge ich die Kontakt- und Email-Informationen des Wiki-Administrators für den Fall hinzu, dass Fragen zu den Benachrichtigungs-E-Mails auftreten, Hierzu eignet sich der Platz direkt zwischen den beiden div-Containern. Dadurch wird der neue Inhalt über dem grauen Fußzeilenfeld platziert:

{{{content}}}
Quellansicht der Vorlage für eine einzelne Benachrichtigung mit hinzugefügtem benutzerdefiniertem Text.
Benutzerdefinierter Text für eine einzelne Benachrichtigung

Sie können diesen neuen Inhalt auch als Systemnachricht einbetten, wenn Sie wissen, wie Systemnachrichten funktionieren. Dadurch wird sichergestellt, dass Benutzer diesen Text in der Sprache sehen, die sie in ihren Einstellungen definiert haben.

Nach dem Speichern der Änderungen wird die aktualisierte Vorlage angezeigt. Bitte beachten Sie, dass das Klicken auf diesen Email-Link einen Sicherheitsfehler im Wiki verursacht, jedoch nicht in der tatsächlich gesendeten Email.

E-Mail-Vorlagenvorschau mit hervorgehobener Anpassung
Ausgabe nach Anpassung (Benutzersprache Englisch)

Testen der Vorlagen[Bearbeiten | Quelltext bearbeiten]

Um Änderungen an der einzelnen Benachrichtigungsvorlage zu testen, können Wiki-Administratoren die Seite Special:NotificationTester verwenden und den Anweisungen auf der Seite folgen.




Feedback zur Dokumentation ist im Community-Forum möglich.