Erweiterung:Echo
There is a stalled attempt to move this functionality into core MediaWiki; for more information, see Benachrichtigungen and Requests for comment/Notifications in core. |
Notifications Freigabestatus: stabil |
|
---|---|
Einbindung | Benachrichtigung |
Beschreibung | Stellt ein wiki-integriertes Benachrichtigungssystem, dass von anderen Erweiterungen verwendet werden kann. |
Autor(en) | |
Letzte Version | Laufende Aktualisierungen |
Kompatibilitätspolitik | Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel. |
Datenbankänderungen | Ja |
Tabellen | echo_email_batch echo_event echo_notification echo_subscription echo_target_page echo_push_provider echo_push_subscription echo_push_topic echo_unread_wikis |
Lizenz | MIT-Lizenz |
Herunterladen | |
|
|
|
|
|
|
Quarterly downloads | 139 (Ranked 41st) |
Public wikis using | 2,698 (Ranked 187th) |
Übersetze die Echo-Erweiterung, wenn sie auf translatewiki.net verfügbar ist | |
Probleme | Offene Aufgaben · Einen Fehler melden |
Die Echo Erweiterung stellt ein Benachrichtigungssystem innerhalb des Wikis zur Verfügung, das von anderen Erweiterungen verwendet werden kann. Thanks und DiscussionTools sind zwei MediaWiki Erweiterungen die Echo nutzen.
Installation
- Den Datenbankbenutzer muss das "REFERENCES" Recht für die Datenbank erhalten haben. How you check this depends on how you set up the database in the first place. For example, if you used a control panel application, then that interface should provide a way to check and change the privileges of the database user (
$wgDBuser
in LocalSettings.php ). - Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens
Echo
im Ordnerextensions/
ablegen.
Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo - Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
wfLoadExtension( 'Echo' );
- Führe das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
- If necessary configure at your convenience
- Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
Um tägliche oder wöchentliche Zusammenfassungsmeldungen per Post zu ermöglichen (für Benutzer, die dies in ihren Präferenzen wählen), muss das folgende Skript im Echo-Erweiterungsverzeichnis täglich ausgeführt werden, das in einem Cron-Job geplant werden kann:
maintenance/processEchoEmailBatch.php
Konfiguration
Es ist möglich conditional user options zu nutzen, um verschiedene Benachrichtigungsvorlagen für neue Benutzer zu setzen, ohne bereits existiernede Benutzer zu beeinflussen.
Siehe Special:DisplayNotificationsConfiguration für lokale Details.
Parameter
Parameter | Standard | Anmerkung |
---|---|---|
$wgEchoEnableEmailBatch
|
true
|
Ob die E-Mail-Batch-Funktion aktiviert wird |
$wgEchoUseJobQueue
|
false
|
|
$wgEchoEmailFooterAddress
|
'' | Die Organisation Adresse (oder der Text, den Sie im Fußboden der E-Mail-Benachrichtigungen angezeigt haben möchten). Sollte in LocalSettings.php definiert sein |
$wgNotificationSender
|
$wgPasswordSender
|
Die E-Mail-Adresse für "von" und "Antwort auf" in E-Mail Benachrichtigungen. Sollte in LocalSettings.php definiert sein |
$wgNotificationSenderName
|
"emailsender" Nachricht (MediaWiki) | Name für "von" in Email-Benachrichtigungen. Sollte in LocalSettings.php definiert sein |
$wgNotificationReplyName
|
No Reply | Name for "reply to" on email notifications. Sollte in LocalSettings.php definiert sein |
$wgEchoCluster
|
false
|
Use the main db if this is set to false, to use a specific external db, just use any key defined in $wgExternalServers |
$wgEchoSharedTrackingDB
|
false
|
Shared database to use for keeping track of cross-wiki unread notifications; false to not keep track of it at all |
$wgEchoSharedTrackingCluster
|
false
|
Cluster the shared tracking database is located on; false if it is on the main one. Must be a key defined in $wgExternalServers |
$wgEchoMaxUpdateCount
|
2000 | Die maximale Anzahl der Benachrichtigungen, die einem Benutzer erlaubt ist, ein Live-Update durchzuführen, ist auch die maximale Anzahl von Benachriffen, die einem Nutzer erlaubten ist. |
$wgEchoMaxMentionsCount
|
50 | Die maximale Anzahl der Hinweismeldungen, die einem Benutzer zugelassen werden können, um sofort zu senden |
$wgEchoMentionStatusNotifications
|
false
|
Erlaubt Erfolg/Niederlagemeldungen |
$wgEchoMentionsOnMultipleSectionEdits
|
true
|
Auslöser-Erwähnung für mehrere Abschnittebearbeitung |
$wgEchoMentionOnChanges
|
true
|
Trigger mentions for edits to existing comments, as long as a signature is added in the same section |
$wgEchoMaxMentionsInEditSummary
|
0 | Höchstzahl der Benutzer, die mitgeteilt werden, dass sie aus einer Bearbeitungsübersicht verlinkt wurden, oder 0 für keine Mitteilungen |
$wgEchoBundleEmailInterval
|
0 | Der Zeitintervall zwischen jedem E-Mail-Bundel in Sekunden; setzen Sie eine kleine Zahl für Test-Wikis. Diese sollte auf 0 gesetzt werden , um das E-Mail-Bündeln zu deaktivieren , wenn keine Verzögerungs-Warteschlange unterstützt wird |
$wgEchoNewMsgAlert
|
true
|
Whether or not to enable a new talk page message alert for logged in users. |
$wgNotifyTypeAvailabilityByCategory
|
[
// Otherwise, a user->user email could trigger an additional redundant notification email.
'emailuser' => [
'web' => true,
'email' => false,
],
'mention-failure' => [
'web' => true,
'email' => false,
],
'mention-success' => [
'web' => true,
'email' => false,
],
]
|
Define which notify types are available for each notification category. If any notify types are omitted, it defaults to $wgDefaultNotifyTypeAvailability. |
$wgEchoNotifiers
|
[
'web' => [ 'EchoNotifier', 'notifyWithNotification' ],
'email' => [ 'EchoNotifier', 'notifyWithEmail' ],
]
|
Definitions of the different types of notification delivery that are possible. Each definition consists of a class name and a function name. Siehe auch die Klasse EchoNotificationController. |
$wgEchoAgentBlacklist
|
[] | List of usernames which will not trigger notifications |
$wgEchoOnWikiBlacklist
|
Echo-blacklist | Page location of community maintained blacklist within NS_MEDIAWIKI containing one username per line which will not trigger notifications. Setze auf null, um zu deaktivieren. |
$wgEchoPerUserWhitelistFormat
|
%s/Echo-whitelist | An sprintf format of the location of the per-user notification agent whitelist within the NS_USER namespace. %s will be replaced with the users name. The whitelists must contain one username per line which will always trigger notifications regardless of their existence in the blacklists. Setze auf null , um zu deaktivieren.
|
$wgEchoCrossWikiNotifications
|
false
|
Whether to enable the cross-wiki notifications feature. To enable this feature you need to:
|
$wgEchoUseCrossWikiBetaFeature
|
false
|
Feature flag for the cross-wiki notifications beta feature
If this is This does not control whether cross-wiki notifications are enabled by default.
Für dies, verwende |
$wgEchoNotificationCategories
|
Siehe extension.json | Define the categories that notifications can belong to. Categories can be assigned the following parameters. Alle Parameter sind optional:
If a notifications type doesn't have a category parameter, it is automatically assigned to the |
$wgEchoNotificationIcons
|
Siehe extension.json | Defines icons, which are 30x30 images. This is passed to BeforeCreateEchoEvent so extensions can define their own icons with the same structure. It is recommended that extensions prefix their icon key. An example is myextension-name. This will help avoid namespace conflicts.
You can use either a path or a url, but not both. The value of 'path' is relative to The value of 'url' should be a URL. You should customize the site icon URL, which is: |
$wgEchoNotifications
|
Siehe extension.json | Define the event types for echo. Event definitions are in the form of 'event-name' => [ ... ].
|
$wgEchoConfig
|
Siehe extension.json | Configuration for EventLogging. Individual schemas can be disabled. |
$wgEchoPerUserBlacklist
|
null
|
Boolean that enabled Per User Blacklist. |
Benutzereinstellungen =
Einstellungen | Standard | Anmerkung |
---|---|---|
$wgDefaultUserOptions['echo-email-frequency']
|
0 | Wie oft E-Mails standardmäßig gesendet werden sollen:
|
$wgDefaultUserOptions['echo-email-format']
|
Depends on $wgAllowHTMLEmail
|
Default user preference for whether to use HTML or text email. Either html or plain-text .
|
$wgDefaultUserOptions["echo-subscriptions-email-{$category}"]
|
false for most categories; depends
|
Default user preference for whether to notify via email for a particular category |
$wgDefaultUserOptions["echo-subscriptions-web-{$category}"]
|
true for most categories; depends
|
Default user preference for whether to notify via web for a particular category |
Architektur
Verwendung
Notification negative list / positive list
There are occasionally specific users, typically bots, which perform maintenance tasks that should not generate notifications. To handle these cases, users can be globally blacklisted from the LocalSettings.php file (or InitialiseSettings.php in the case of WMF wikis):
$wgEchoAgentBlacklist = [ 'SampleBot', 'SampleUser' ];
There is also an on-wiki blacklist that can be maintained by the wiki's community. The location of the global on-wiki blacklist defaults to MediaWiki:Echo-blacklist. Individual users can override the blacklist by creating a whitelist. The whitelist location defaults to Special:MyPage/Echo-whitelist. All on-wiki lists expect to receive one case-specific username per line with no special markup or prefixes. Zum Beispiel:
SampleBot SampleUser
"Mention" option
One of the notification types that this extension allows is: "Notify me when someone links to my user page." It might not be obvious to some users, but this particular notification only works when the person linking to another user's page also signs (~~~~) the post.
After installation of the extension, a new tab "Notifications" is created in a user's Special:Preferences page. Under the section "Notify me about these events", in front of the "Mention" option, the hoverbox states: "Notify me when someone links to my user page." If an administrator feels, that the requirement for signing the post isn't obvious in this help text, it can be modified by changing the text in the Wiki's MediaWiki:Echo-pref-tooltip-mention page.
Begriffe
- notification - Any individual notice that is delivered by Echo
- message - A notification about activity in a Flow discussion
- alert - Any notification other than a message
Siehe auch
- Notifications/API
- Handbuch:Echo - Für Details über die Mention-Anforderungen
- Extension:Echo/Creating a new notification type (aktuell)
- Notifications/Developer_guide (veraltet)
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |