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.
MediaWiki manüel uzantıları
OOjs UI icon advanced-invert.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ı MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil.
MediaWiki 1.32+
Veritabanı değişiklikleri Evet
Tablolar echo_email_batch
echo_event
echo_notification
echo_subscription
echo_target_page
echo_push_provider
echo_push_subscription
echo_push_topic
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 Bildirimler 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.37+). 1.32–1.36 ile kullanmak için, eşleşen bir dalına geçmeniz gerekir (örneğin, REL1_36 çekirdeğine sahip Echo REL1_36).

Kurulum

  • The database user must have been granted the "REFERENCES" right for the database.
  • Dosyaları indirin ve extensions/ klasörünüzdeki Echo adlı 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.

Parametreler

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 Bir düzenleme özetinden bağlandıkları konusunda bilgilendirilecek maksimum kullanıcı sayısı veya bildirim olmaması durumunda 0
$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 Bildirimler açılır penceresinde alt bilgi geri bildirim bildiriminin gösterilip gösterilmeyeceği
$wgEchoFooterNoticeURL '' Bildirim açılır penceresindeki altbilgi geri bildirim bildiriminde görünen anketin URL'si
$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,
	],
]
Her bir bildirim kategorisi için hangi bildirim türlerinin mevcut olduğunu tanımlayın. Herhangi bir bildirim türü atlanırsa, varsayılan olarak $wgDefaultNotifyTypeAvailability olur.
$wgEchoNotifiers
[
	'web' => [ 'EchoNotifier', 'notifyWithNotification' ],
	'email' => [ 'EchoNotifier', 'notifyWithEmail' ],
]
Mümkün olan farklı bildirim teslimi türlerinin tanımları. Her tanım, bir sınıf adı ve bir işlev adından oluşur. Ayrıca EchoNotificationController sınıfa bakın.
$wgEchoAgentBlacklist [] Bildirimleri tetiklemeyen kullanıcı adlarının listesi
$wgEchoOnWikiBlacklist Echo-blacklist Topluluk tarafından tutulan kara listenin sayfa konumu, her satırda bir kullanıcı adı içeren ve bildirimleri tetiklemeyen NS_MEDIAWIKI içinde. Devre dışı bırakmak için null olarak ayarlayın.
$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 Vikiler arası bildirimler özelliğinin etkinleştirilip etkinleştirilmeyeceğini. Bu özelliği etkinleştirmek için yapmanız gerekenler:
  • küresel bir kullanıcı sistemine sahip olmak (ör. CentralAuth veya paylaşılan bir kullanıcı tablosu)
  • vikiler arasında paylaşılan $wgMainStash ve $wgMainWANCache sahip olmak
  • $wgEchoSharedTrackingDB yapılandırın
$wgEchoUseCrossWikiBetaFeature false Vikiler arası bildirimler beta özelliği için özellik işareti

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.

Bu, vikiler arası bildirimlerin varsayılan olarak etkinleştirilip etkinleştirilmediğini kontrol etmez. Bunun için $wgDefaultUserOptions['echo-cross-wiki-notifications'] = true; kullanın

$wgEchoNotificationCategories See extension.json Bildirimlerin ait olabileceği kategorileri tanımlayın. Kategorilere aşağıdaki parametreler atanabilir. Tüm parametreler isteğe bağlıdır:
  • priority - Tercihlerde ve toplu e-postalarda bildirimlerin görüntülenme sırasını kontrol eder. Öncelik 1 ile 10 arasında değişmektedir. Öncelik belirtilmemişse, varsayılan olarak en düşük olan 10'a ayarlanır.
  • no-dismiss - kategorideki bildirimlerin kapatılabilirliğini devre dışı bırakır. Bir dizi çıkış biçimine ($wgEchoNotifiers sayfasına bakın) veya 'all' içeren bir diziye ayarlanabilir.
  • 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 30x30 resim olan simgeleri tanımlar. Bu, BeforeCreateEchoEvent ile iletilir, böylece uzantılar aynı yapı ile kendi simgelerini tanımlayabilir. Uzantıların simge anahtarının önüne eklenmesi önerilir. Bir örnek, myextension-name'dir. Bu, ad alanı çakışmalarını önlemeye yardımcı olacaktır.

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 - Paketleme için hangi çıkış biçimlerinin kullanılabileceğini tanımlayın.
  • presentation-model - Bildirim mesajları ve bildirim panelleri, özel sayfa ve e-postalar için bağlantılar oluşturmak için hangi sınıfın kullanıldığını tanımlayın. EchoEventPresentationModel genişletilmelidir.
$wgEchoConfig See extension.json Configuration for EventLogging. Individual schemas can be disabled.
$wgEchoPerUserBlacklist null Kullanıcı Başına Kara Listeyi etkinleştiren boole.

Kullanıcı tercihleri

Tercih ayarları (varsayılanlar extension.json olarak tanımlanmıştır)
Tercih Varsayılan Yorum
$wgDefaultUserOptions['echo-show-alert'] true Özel tartışma sayfası uyarı çubuğunu göstermek için varsayılan kullanıcı tercihi
$wgDefaultUserOptions['echo-email-frequency'] 0 Varsayılan olarak e-postaların ne sıklıkla gönderileceği. Varsayılan olarak, her bildirim için geldikçe e-posta gönderin
$wgDefaultUserOptions['echo-dismiss-feedback-alert'] 0 Geri bildirim uyarısının varsayılan olarak görünür olmasını sağlar. Değiştirmeyin; devre dışı bırakmak için $wgEchoShowFooterNotice kullanın.
$wgDefaultUserOptions['echo-email-format'] Depends on $wgAllowHTMLEmail HTML mi yoksa metin e-posta mı kullanılacağına ilişkin varsayılan kullanıcı tercihi
$wgDefaultUserOptions["echo-subscriptions-email-{$category}"] false for most categories; depends Belirli bir kategori için e-posta yoluyla bildirim yapılıp yapılmayacağına ilişkin varsayılan kullanıcı tercihi
$wgDefaultUserOptions["echo-subscriptions-web-{$category}"] true for most categories; depends Belirli bir kategori için web üzerinden bildirim yapılıp yapılmayacağına ilişkin varsayılan kullanıcı tercihi

Mimari

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

Kullanım

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 = [ '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.

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