Extension:Echo

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Echo and the translation is 100% complete.
Other languages:
English • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎русский • ‎中文 • ‎日本語 • ‎한국어
MediaWiki manüel uzantıları
OOjs UI icon advanced.svg
Echo
Sürüm durumu: kararlı
Screenshot of Echo notification extension.png
Uygulama Bildirim
Açıklama Diğer uzantılar tarafından kullanılabilecek bir viki içi bildirim sistemi sağlar.
Yazar(lar)
En son sürüm güncellemeler devam etmekte
Uyumluluk politikası sürüm dalları
MediaWiki 1.32+
Veritabanı değişiklikleri Evet
Tablolar echo_email_batch
echo_event
echo_notification
echo_subscription
echo_target_page
Lisans MIT Lisansı
İndir
  • $wgEchoNotificationCategories
  • $wgEchoEventLoggingSchemas
  • $wgEchoMaxMentionsCount
  • $wgEchoPerUserWhitelistFormat
  • $wgEchoPushMaxSubscriptionsPerUser
  • $wgEchoMentionOnChanges
  • $wgEchoPollForUpdates
  • $wgEchoUseJobQueue
  • $wgEchoBundleEmailInterval
  • $wgEchoMentionsOnMultipleSectionEdits
  • $wgDefaultNotifyTypeAvailability
  • $wgEchoSecondaryIcons
  • $wgEchoCacheVersion
  • $wgEchoMaxUpdateCount
  • $wgEchoNotifiers
  • $wgEchoAgentBlacklist
  • $wgEchoSharedTrackingCluster
  • $wgEchoEnablePush
  • $wgEchoPerUserBlacklist
  • $wgEchoEnableEmailBatch
  • $wgEchoWatchlistNotifications
  • $wgNotifyTypeAvailabilityByCategory
  • $wgEchoMaxMentionsInEditSummary
  • $wgEchoNotifications
  • $wgEchoPushServiceBaseUrl
  • $wgEchoCluster
  • $wgEchoWatchlistEmailOncePerPage
  • $wgAllowArticleReminderNotification
  • $wgEchoEventLoggingVersion
  • $wgEchoNotificationIcons
  • $wgEchoSharedTrackingDB
  • $wgEchoOnWikiBlacklist
  • $wgEchoSeenTimeCacheType
  • $wgEchoMentionStatusNotifications
  • $wgEchoCrossWikiNotifications
  • $wgEchoEmailFooterAddress
  • manage-all-push-subscriptions
Translatewiki.net adresinde mevcutsa, Echo uzantısını çevirin
Kullanım ve sürüm matrisini kontrol edin.
Sorunlar Açık görevler · Hata bildir

Echo uzantısı, diğer uzantılar tarafından kullanılabilen bir viki içi bildirim sistemi sağlar. Thanks ve StructuredDiscussions , Echo'dan yararlanan iki MediaWiki uzantısıdır. Bu uzantının ne yaptığına ilişkin tam bir açıklama için $2 sayfasına bakın.

İndir

Uzantı doğrudan Git'ten alınabilir [?]:

  • Kodu göz at
  • Bazı uzantıların kararlı sürümler için etiketleri vardır.
  • Her dal geçmiş bir MediaWiki sürümüyle ilişkilendirilmiştir. Ayrıca en son alfa sürümünü içeren bir "ana" dalı da vardır (MediaWiki'nin alfa sürümünü gerektirebilir).

Anlık görüntüyü ayıklayın ve MediaWiki kurulumunuzun extensions/Echo/ dizinine yerleştirin.

Git'e aşina iseniz ve sunucunuza kabuk erişiminiz varsa, uzantıyı aşağıdaki gibi elde edebilirsiniz:

cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo.git
Bu uzantının ana dalı, yalnızca MediaWiki çekirdeğinin ana dalını destekler (şu anda 1.34+). 1,32–1.33 ile kullanmak için, eşleşen bir dalına geçmeniz gerekir (örneğin, REL1_33 çekirdeğine sahip Echo REL1_33).

Kurulum

  • İndir ve dosyaları extensions/ klasörünüzdeki Echo adlı bir dizine yerleştirin.
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'Echo' );
    
  • Bu uzantının ihtiyaç duyduğu gerekli veritabanı tablolarını otomatik olarak oluşturacak betik güncelleme komutunu çalıştırın.
  • Gerekirse uygun şekilde yapılandırın
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

MediaWiki 1.28 veya önceki bir sürümü çalıştıran kullanıcılara:

Yukarıdaki talimatlar, bu eklentiyi wfLoadExtension() kullanarak kurmanın yeni yolunu açıklar. Bu uzantıyı önceki sürümlerine (MediaWiki 1.28 ve önceki sürümler) yüklemeniz gerekirse, wfLoadExtension( 'Echo' ); yerine kullanmanız gerekir:

require_once "$IP/extensions/Echo/Echo.php";

Yapılandırma

Varsayılan kullanıcı tercihlerini ayarlamaya ek olarak, kayıt sırasında kullanıcı tercihlerini değiştirmek için AddNewAccount kancasını da kullanabilirsiniz. Bu, mevcut kullanıcıları etkilemeden farklı kullanıcı tercihlerinin ayarlanmasına izin verir.

Yerel ayrıntılar için Special:DisplayNotificationsConfiguration sayfasına bakın.

Yapılandırma ayarları (varsayılanlar extension.json olarak tanımlanmıştır)
Parametre Varsayılan Yorum
$wgEchoEnableEmailBatch true E-posta toplu işlevinin açılıp açılmayacağı
$wgEchoUseJobQueue false
  • true: İş kuyruğu üzerinden web ve e-posta bildirim teslimatını erteleyin.
  • false: Bildirimleri hemen teslim edin
$wgEchoEmailFooterAddress '' Kuruluş adresi (veya e-posta bildirimlerinin altbilgisinde görünmesini istediğiniz metin). LocalSettings.php olarak tanımlanmalıdır
$wgNotificationSender $wgPasswordSender E-posta bildirimlerinde hem "gönderen" hem de "yanıtla" için e-posta adresi. LocalSettings.php olarak tanımlanmalıdır
$wgNotificationSenderName "emailsender" mesajı (MediaWiki) E-posta bildirimlerindeki "gönderen" için ad. LocalSettings.php olarak tanımlanmalıdır
$wgNotificationReplyName No Reply E-posta bildirimlerinde "yanıtla" adı. LocalSettings.php olarak tanımlanmalıdır
$wgEchoCluster false Bu, false olarak ayarlanmışsa ana db'yi kullanın, belirli bir harici veritabanı kullanmak için, $wgExternalServers içinde tanımlanan herhangi bir anahtarı kullanın
$wgEchoSharedTrackingDB false Vikiler arası okunmamış bildirimleri takip etmek için kullanılacak paylaşılan veritabanı; hiç takip etmemek için false
$wgEchoSharedTrackingCluster false Paylaşılan izleme veritabanının bulunduğu kümeleme; asıl olanı false. $wgExternalServers ile tanımlanan bir anahtar olmalıdır
$wgEchoMaxUpdateCount 2000 Bir kullanıcının canlı güncelleme yapmasına izin verilen maksimum bildirim sayısı, bu aynı zamanda bir kullanıcının almasına izin verilen maksimum bildirim sayısıdır.
$wgEchoMaxMentionsCount 50 Bir kullanıcının tek seferde göndermesine izin verilen maksimum bahsetme bildirimi sayısı
$wgEchoMentionStatusNotifications false Başarı/Başarısızlık bildirimlerini belirtmeyi etkinleştir
$wgEchoMentionsOnMultipleSectionEdits true Çok bölümlü düzenlemeler için tetikleyici bahseder
$wgEchoMentionOnChanges true Aynı bölüme bir imza eklendiği sürece, mevcut yorumlara yapılan düzenlemeler için tetikleme bahseder
$wgEchoMaxMentionsInEditSummary 0 Maximum number of users that will be notified that they were linked from an edit summary or 0 for no notifications
$wgEchoBundleEmailInterval 0 Her paket e-postası arasındaki saniye cinsinden zaman aralığı; test vikileri için küçük bir sayı ayarlayın. Gecikme kuyruğu desteği yoksa e-posta gruplamayı devre dışı bırakmak için bu 0 olarak ayarlanmalıdır.
$wgEchoNewMsgAlert true Oturum açmış kullanıcılar için yeni bir tartışma sayfası mesajı uyarısının etkinleştirilip etkinleştirilmeyeceği.
$wgEchoShowFooterNotice false Whether or not to show the footer feedback notice in the notifications popup
$wgEchoFooterNoticeURL '' A URL for the survey that appears in the footer feedback notice in the notification popup
$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. See also: EchoNotificationController class.
$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. Set to null to disable.
$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. Set to null to disable.
$wgEchoCrossWikiNotifications false Whether to enable the cross-wiki notifications feature. To enable this feature you need to:
  • have a global user system (e.g. CentralAuth or a shared user table)
  • have $wgMainStash and $wgMainWANCache shared between wikis
  • configure $wgEchoSharedTrackingDB
$wgEchoUseCrossWikiBetaFeature false Feature flag for the cross-wiki notifications beta feature

If this is true, the cross-wiki notifications preference will appear in the BetaFeatures section; if this is false, it'll appear in the Notifications section instead.

This does not control whether cross-wiki notifications are enabled by default. For that, use $wgDefaultUserOptions['echo-cross-wiki-notifications'] = true;

$wgEchoNotificationCategories See extension.json Define the categories that notifications can belong to. Categories can be assigned the following parameters. All parameters are optional:
  • priority: Controls the order in which notifications are displayed in preferences and batch emails. Priority ranges from 1 to 10. If the priority is not specified, it defaults to 10, which is the lowest.
  • no-dismiss: disables the dismissability of notifications in the category. It can either be set to an array of output formats (see $wgEchoNotifiers) or an array containing 'all'.
  • usergroups: Specifies an array of usergroups eligible to receive the notifications in the category. If no usergroups parameter is specified, all groups are eligible.

If a notifications type doesn't have a category parameter, it is automatically assigned to the other category which is lowest priority and has no preferences or dismissibility.

$wgEchoNotificationIcons See 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 $wgExtensionAssetsPath.

The value of 'url' should be a URL.

You should customize the site icon URL, which is: $wgEchoNotificationIcons['site']['url']

$wgEchoNotifications See extension.json Define the event types for echo. Event definitions are in the form of 'event-name' => [ ... ].
  • category: Defines the category the event belongs to. Defaults to 'other'.
  • group: Defaults to 'neutral'.
  • bundle: Define which output formats are available for bundling.
  • presentation-model: Define which class is used to render notification messages and links for notification panels, special page and emails. It must extend EchoEventPresentationModel.
$wgDefaultUserOptions['echo-show-alert'] true Default user preference for showing the special talk page alert bar
$wgDefaultUserOptions['echo-email-frequency'] 0 How often to send emails, by default. By default, send emails for each notification as they come in
$wgDefaultUserOptions['echo-dismiss-feedback-alert'] 0 Ensures the feedback alert is visible by default. Do not change; to disable, use $wgEchoShowFooterNotice.
$wgDefaultUserOptions['echo-email-format'] Depends on $wgAllowHTMLEmail Default user preference for whether to use HTML or text email
$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
$wgEchoConfig See extension.json Configuration for EventLogging. Individual schemas can be disabled.
$wgEchoPerUserBlacklist null Boolean that enabled Per User Blacklist.

Mimari

Özellik sayfasının mimari bölümüne bakın.

Kullanım

Notification blacklist/whitelist

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 = [ 'GonzoBot', 'CrazyGuy' ];

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. For example:

GonzoBot
CrazyGuy
"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.

(Tested on MediaWiki v1.26.2 on March 15, 2016)

Terminoloji

  • bildirim - Echo tarafından gönderilen herhangi bir bireysel bildirim
  • mesaj - Bir Flow tartışmasındaki etkinlik hakkında bir bildirim
  • uyarı - Mesaj dışındaki herhangi bir bildirim

Ayrıca bakınız