Installation

Configuration

Bu bölüm, yapılandırma ayarlarını kısaca açıklamaya ayrılmıştır. Betiğinin hangi bildirimlerin reddedileceğini nasıl belirlediği hakkında daha fazla ayrıntı için lütfen filtre ve bildirim işleme hakkındaki ayrı bölüme bakın.

Bu betik, kendi yapılandırma ayarlarına sahip olan GetOnSiteNotifications'a bağlıdır. GetOnSiteNotifications yapılandırma ayarları, bu betiğinin bazı yapılandırma ayarları ve/veya bu betiğinin alabileceği veriler için izin verilen değerleri sınırlayarak bu betiğini etkileyebilir. GetOnSiteNotifications'ı yapılandırma yönergeleri için lütfen kendi belgelerindeki yapılandırma bölümüne bakın.

Bu betiğinin yapılandırma seçenekleri, bireylerin bir bildirimin reddedilip reddedilmeyeceğini (yani okundu olarak işaretlenip işaretlenmediğini) belirlemek için kullanılan verileri ve filtreleri (yani ölçütleri) kontrol etmesine olanak tanır. Seçenekler, betiğinin içe aktarılmasının üzerinde aşağıdaki kod satırlarıyla bir kullanıcının kişisel JS'si içinde oluşturulabilen betiğinin yapılandırma nesnesinin özellikleridir.

if (!window.andrewds1021) {
    window.andrewds1021 = {
        ignore_notifications: {}
    };
} else if (!window.andrewds1021.ignore_notifications) {
    window.andrewds1021.ignore_notifications = {};
}

Belirli bir seçeneği ayarlamak için, betiğinin yapılandırma nesnesi ile betiği içe aktarması arasına bir kod satırı yerleştirin. Aşağıdaki biçimi takip etmelidir; burada property, aşağıdaki tabloda listelendiği gibi seçenek adıyla değiştirilir ve value, istenen değerle değiştirilir.

window.andrewds1021.ignore_notifications.property = value;

Bu örnek, no_conversion ögesini true olarak ayarlar. Bu, betiğinin AnnouncementsIgnore için önceden var olan ayarları bir filtreye dönüştürmesini engeller.

window.andrewds1021.ignore_notifications.no_conversion = true;

Vikiler/kullanıcılar, adları veya sayısal kimlikleri kullanılarak filtrelerde belirtilebilir. Bir ad vermek daha kolay olsa da, bir kimlik sağlamak biraz daha etkilidir. Bunun nedeni, vikilerin/kullanıcıların adlarını değiştirebilmeleridir. Bir viki/kullanıcı adını değiştirirse, düzgün çalışmaya devam etmek için filtrelerin yeni adla güncellenmesi gerekir. Ancak, yeniden adlandırma kimliği değiştirmez. Bu nedenle, adlar yerine kimliklerin sağlanması, bir wiki/kullanıcının yeniden adlandırma yapması durumunda filtrelerin güncellenmesi gerekmeyeceği anlamına gelir. Bir vikinin kimliğini bulmanın en kolay yolu Special:Version sayfasına gitmektir. Kimlik "city_id" olarak etiketlenmiştir ve özel sayfanın "Yüklü Yazılım" bölümünde bulunabilir. Aşağıda kırmızı bir kutu ile işaretlenmiş wiki kimliğine sahip bir resim bulunmaktadır.

Bir kullanıcının kimliğini bulmanın en az iki yolu vardır. İlki, Tartışmalar'daki gönderilerin listesini görüntülemektir (örnek). URL'nin sonundaki sayı, kullanıcının kimliğidir. Bir Tartışmalar gönderisindeki avatarlarına veya adlarına tıklayarak bu listeye ulaşabilirsiniz. Bir gönderi bulmakta sorun yaşıyorsanız Special:UserProfileActivity kullanarak bir gönderi bulabilirsiniz. İkinci yöntem api.php kullanmaktır (örnek). Aşağıda, kullanıcı kimliğinin kırmızı bir kutu ile işaretlenmiş olduğu bir resim bulunmaktadır. Kullanıcı yeni bir hesap oluşturursa, o hesabın farklı bir kimliğe sahip olacağını unutmayın.

Example

Bu örnek, betiğini veri alma hatalarını yok sayacak, tam kullanıcı listeleri talep edecek ve Topluluk Merkezi'nden gelen duyuruları hemen engelleyecek şekilde yapılandırır.

window.announcementsIgnore.option = "opt-in-all";
window.announcementsIgnore.exceptWikiIds = [177];
window.andrewds1021.ignore_notifications.ignore_errors = true;
window.andrewds1021.ignore_notifications.all_users = true;

Bu örnek, öncekiyle aynı şeyi yapar ancak AnnouncementsIgnore'daki ayarların otomatik olarak dönüştürülmesini kullanmaz.

window.andrewds1021.ignore_notifications.ignore_errors = true;
window.andrewds1021.ignore_notifications.all_users = true;
window.andrewds1021.ignore_notifications.filters = {
    types: "announcement-target",
    wiki_ids: 177
};

Bu örnek, Topluluk Merkezi'nden gelenler dışındaki tüm duyuruları engeller.

window.andrewds1021.ignore_notifications.filters = {
    types: "announcement-target",
    not: {wiki_ids: 177}
};

Bu örnek, olumlu oylar dışında tüm bildirimleri engeller. Ayrıca, Topluluk Merkezi'nden olmayan Andrewds1021 kullanıcıdan gelen yükseltmeleri de engeller.

window.andrewds1021.ignore_notifications.whitelist = true;
window.andrewds1021.ignore_notifications.filters = {
    types: "discussion-upvote",
    not: {
        user_ids: 9605025,
        not: {wiki_ids: 177}
    }
};

Yalnızca eğlence için, işte önceki örneği yazmanın başka bir yolu.

window.andrewds1021.ignore_notifications.whitelist = true;
window.andrewds1021.ignore_notifications.filters = [
    {
        types: "discussion-upvote",
        not: {user_ids: 9605025}
    },
    {
        types: "discussion-upvote",
        user_ids: 9605025,
        wiki_ids: 177
    }
];

İşte aynı sonucu elde etmenin başka bir yolu. Bununla birlikte, bu biraz daha fazla yazma gerektiriyor.

window.andrewds1021.ignore_notifications.filters = [
    {
        types: [
            "announcement-target",
            "article-comment-at-mention",
            "article-comment-reply",
            "article-comment-reply-at-mention",
            "discussion-post",
            "message-wall-post",
            "message-wall-thread",
            "post-at-mention",
            "talk-page-message",
            "thread-at-mention"
        ]
    },
    {
        types: "discussion-upvote",
        user_ids: 9605025,
        not: {wiki_ids: 177}
    }
];

Filtre ve bildirim süreci

Başlangıçta, betik kullanıcı tarafından sağlanan filtreleri kopyalayacak ve temizleyecektir. Listedeki her filtre için wiki_ids, wiki_names, user_ids, user_names ve types kontrol edecek ve filtreleyecektir dize veya sayı olmayan tüm değerleri çıkarır. Ardından age ayrıştırılacak ve not kopyalanacak ve sterilize edilecektir. Betik bir filtre dalında ilerlerken, o daldaki ataları takip eder. değil bir üst ögeye kaynak içeriyorsa, üst öge not öğesinden kaldırılır ve o dal bağlamında daha fazla işlenmez. Bu, filtre döngülerini önlemek için yapılır.

Betik, mevcut verilere dayanarak işten çıkarma kararları verir. Eksik veriler varsa, yanlış bir karar verebilir. Eksik verilerin iki ana olası nedeni, GetOnSiteNotifications yapılandırması tarafından belirlenen kısıtlamalar ve veri alımı sırasında karşılaşılan hatalardır.

Betiğinin, bir bildirimin reddedilmesini otomatik olarak önleyecek kontrol ettiği bazı koşulları vardır.

1. delay belirtildi ve en son olay belirtilen yaştan daha genç
2. bildirim için alınan veriler tam bir kullanıcı listesi içermiyor
3. bildirimi reddetmek, saklanması gereken başka bir bildirimi de reddeder

   Bildirim sisteminin şu anda çalışma şekli, yalnızca tek bir bildirimi reddetmek her zaman mümkün değildir. Örneğin, bir kullanıcı başlattığınız bir konuya olumlu oy verir ve yanıt verirse, iki bildirim alırsınız; biri olumlu oy için, diğeri yanıt için. Bu durumda tebligat sistemi iki tebligattan yalnızca birinin reddine izin vermemektedir.

Yukarıdaki kriterlerden hiçbirinin karşılanmadığını varsayarsak, betik, filtre moduna (kara listeye karşı beyaz listeye) ve bir bildirimin filtrelerle eşleşip eşleşmediğine bağlı olarak işten çıkarma kararları alacaktır. Bildirim, kara listedeki filtrelerle eşleşirse veya beyaz listedeki filtrelerle eşleşmezse reddedilir. Bildirim, listedeki filtrelerden en az biriyle eşleşiyorsa, bir filtre listesiyle eşleşir. Bildirimin tek bir filtreyle eşleşip eşleşmediğini belirlerken 5 kriter vardır: viki, kullanıcı, bildirim türü, yaş ve istisnalar.

Bildirim istisnalar listesiyle eşleşiyorsa, filtreyle eşleşmez. Bir filtrenin istisnalar listesi, filtrenin karşıt liste türü olarak değerlendirilir. Başka bir deyişle, kara liste filtresinin istisnaları beyaz liste filtreleri olarak, beyaz liste filtresinin istisnaları ise kara liste filtreleri olarak kabul edilir. Herhangi bir istisna listelenmemişse, bildirim istisnalar listesiyle eşleşmez.

Bildirimin geldiği vikiyi kontrol ederken, wiki_ids ve wiki_names hangi vikilerin aranacağını açıklayan tek bir listede etkin bir şekilde birleştirilir. Kimliği veya adı listeleniyorsa veya hiçbir wiki listelenmemişse, bildirimin vikinin eşleştiği kabul edilir.

Bir bildirimin kullanıcı listesini kontrol ederken, user_ids ve user_names benzer şekilde birleştirilir ve filtrede hiçbir kullanıcı listelenmemişse bildirim listesinin eşleştiği kabul edilir. Kullanıcılar filtrede listeleniyorsa, eşleştirme kriterleri filtre moduna bağlıdır. Kara liste filtresi için, bildirim listesindeki tüm kullanıcıların da filtre listesinde olması gerekir. Beyaz liste filtresi için bildirim kullanıcılarından en az birinin filtre listesinde olması gerekir.

Bildirim türünü kontrol etmek basittir. Bildirimin türü, filtrenin tür listesindeyse veya filtrede herhangi bir tür listelenmemişse eşleşir. Bildirimin wiki'si, kullanıcı listesi ve türü filtreyle eşleşiyorsa ve bildirim filtrenin istisnalar listesiyle eşleşmiyorsa, bildirim filtreyle eşleşir.

Bir bildirimin en son olayının yaşı, age ile kontrol edilir. Bildirim verisi isteğinin başlangıç zamanı, 0 yaşı olarak kabul edilir. Bir kara liste için, en son olay belirtilen yaştan daha eskiyse bildirim yaş kriterleriyle eşleşir. Beyaz liste için, en son olay belirtilen yaştan daha gençse bildirim yaş kriterleriyle eşleşir. Yaş belirtilmemişse, eşleşme olarak kabul edilir.

Bağımlılıklar

NOT: Bu betik tüm bağımlılıkların içe aktarılmasını yönetir.

• GetOnSiteNotifications

Geriye dönük uyumlu olmayan değişiklikler

• 3 Haziran 2021: FandomDesktop görünümü ile ilk uyumluluk eklemesi tamamlandı. Ancak, FandomDesktop'taki bildirimlerin mevcut durumu nedeniyle, Duyuru bildirimlerinin benzersiz olarak tanımlanamayacağı bir köşe durumu vardır. Bu, aynı hedef URL ile iki veya daha fazla farklı bildirim yayınlandığında meydana gelir. Bu, aşağıdaki kriterlerin tümü karşılandığında sorunlara neden olacaktır.

• Aynı hedef URL'ye sahip birden fazla okunmamış duyuru var
• En az biri bu betik tarafından okundu olarak işaretlenmelidir
• En az biri bu betik tarafından okundu olarak işaretlenmemelidir

Neden olan sorun, okundu olarak işaretlenmemesi gereken yüklenen bildirimlerin ekranda okundu olarak işaretlenmesidir. Ancak, veritabanında okunmamış olarak kalacaklar ve sonraki sayfa yüklendiğinde olduğu gibi görüntülenmelidirler.

• 2 Haziran 2021: Eski platform (MediaWiki 1.19.24) için uyumluluk kaldırıldı. Bu, artık kullanıcılara yönelik eski wiki kalmadığı için yapıldı.
• 1 Nisan 2021: Gerekli API uç noktasının güvenilir olmaması nedeniyle engellenemeyen kullanıcılar listesi kaldırıldı. Bu betiğinin kullanıcıları bunun farkında olmalı ve bu betik Fandom Personeli, Yardımcılar, SOAP ve Viki Yöneticileri/Temsilcileri gibi küresel kullanıcı gruplarının üyelerinden gelen iletişimleri okumamak veya yanıtlamamak için bir bahane olarak kullanmamalıdır.