Extension:CentralNotice/tr

CentralNotice uzantısı, Wikimedia vikilerine duyurular (genellikle banner biçiminde) sunar. Fundraising ekibi tarafından bağış toplamak ve Wikimedia toplulukları ile kullanıcılarını ilgilendiren duyurular için yoğun bir şekilde kullanılmaktadır. CentralNotice duyuruları ülke, dil, proje, cihaz ve oturum açma durumuna göre hedefleyebilir.

Bu sayfada, CentralNotice'i kendi sitelerine kurmak isteyen CentralNotice geliştiricileri ve viki hizmetlileri için bilgiler bulunmaktadır. CentralNotice kampanyalarının nasıl oluşturulacağını ve yapılandırılacağını öğrenmek için lütfen Meta-Wiki üzerinde Help:CentralNotice sayfasına bakın. Wikimedia Vakfı'nın kümesindeki CentralNotice kurulumu hakkında bilgi için, Wikitech üzerinde CentralNotice sayfasına bakın.

CentralNotice, duyuruların merkezi bir vikiden (altyapı viki) birçok wikiye (abone olma viki adı verilir) merkezi olarak dağıtılmasına izin verir. Yalnızca tek bir vikiye mesaj göndermeniz gerekiyorsa, bunun yerine Sitenotice kullanmayı düşünün.

Tüm vikiler için

 * 1) En son anlık görüntüyü indirin ve uzantı dizininize çıkartın.
 * 2)  ile aşağıdakileri ekleyin:
 * 3) Varsayılan olarak, GeoIP araması devre dışı bırakılmıştır. Ancak   çerezi önceden doldurulmuşsa, değeri kullanılacaktır. Yerel geliştirme için, https://freegeoip.net kullanan bir istemci tarafı uygulamasını aşağıdaki gibi etkinleştirebilirsiniz. Daha fazla bilgi için #GeoIP araması bölümüne bakın.

Altyapı vikisi

 * 1) Komut satırından viki köküne gidin ve   komutunu çalıştırın
 * 2) $2 düzenleyin ve ayarlayın...
 * 3)   true
 * , merkezi vikiye abone olacak bir dizi proje olacak. Örneğin
 * 1) Varsayılan olarak   grubu, CentralNotice yönetme yeteneğine sahip tek gruptur. Ek gruplara ihtiyaç duyulursa, bunlara   ve   izinlerini atayın.

Vikilere abone olmak
düzenleyin ve ayarlayın...


 * ,  içinde bir giriş olacak;
 * 1)   protokole (potansiyel olarak tarafsız) ve merkezi vikinin etki alanına. Örneğin  ;
 * 2) Merkezi vikideki Special:BannerLoader URL'sine , örneğin:  ;
 * 3) altyapı viki veritabanının adına   ya da altyapı vikinin API uç noktasına  ; ve
 * 4) Merkezi vikideki Special:RecordImpression URL'sine  . Örneğin:.
 * 1) Merkezi vikideki Special:RecordImpression URL'sine  . Örneğin:.

Hızlı geliştirici kurulumu
Çoğu geliştirme görevi için hem altyapı hem de abone olma rollerinde tek bir viki kullanabilirsiniz. Aşağıda  dahil edilecek örnek satırlar verilmiştir. (Yorumlardaki notlara bakın.)

Sitenin mobil sürümünde çalıştıklarından emin olmak için, viki aboneliklerinde çalışan tüm kodlar ile duman testine tabi tutulmalıdır.

Bağımlılıklar
Bazı CentralNotice özellikleri, ve  dahil olmak üzere başka MediaWiki uzantılarını gerektirir.

Yardım almak
Wikimedia bağış toplama ekibi, CentralNotice'in geliştiricileridir. CentralNotice'in kurulumu, hata raporları veya kullanımıyla ilgili sorular için lütfen [mailto:wikitech-l@lists.wikimedia.org wikitech-l@lists.wikimedia.org] bir e-posta gönderin veya #wikimedia-fundraising kanalında Freenode üzerinden bize katılın.

İzinler

 *   — Kampanyaları ve başlıkları değiştirmek için izin gereklidir. Yalnızca altyapı vikileriyle ilgilidir (ayrıca bakınız 26377).
 * Banner içeriğini düzenlemek için   gereklidir.

Tasarım kavramları
Kullanıcıya dönük bir bakış açısından, yüksek seviyeli CentralNotice nesneleri campaigns (bildirimler olarak bilinir) ve banners (şablonlar olarak bilinir). Bunlar, selectors ve allocation arka uç kavramlarından etkilenir.


 * Banner — sayfaların başında görüntülenecek tek bir çevrilebilir html/wikitext/css/javascript bloğu. Kullanıcı durumu, cihaz türü, UI dili selectors başlıklara uygulanır.
 * Banner'lar category olarak gruplandırılabilir. Bir kategorideki tüm başlıklar, kullanıcı bir başlık kapat düğmesini tıkladığında ayarlanan gizleme çerezi gibi kullanıcı tarafı çerezlerini paylaşır.
 * Campaign — banner koleksiyonu. Proje, ülke ve içerik dili seçicileri kampanya düzeyinde geçerlidir. Sistem, aktif bir kampanyadaki her bir banner için dinamik olarak allocation hesaplamak istediğiniz kadar aynı anda birçok aktif kampanyaya izin verir. Merkezi viki zamanı, kampanya başlangıç ​​zamanından büyükse, kampanya bitiş zamanından azsa ve kampanya etkin olarak işaretlenirse, kampanyalar etkin olarak tanımlanır.
 * Bir kampanyadaki banner'lara bucket ve weight atanır. Paketler yine başka bir seçicidir ve ağırlık, bir kampanya içindeki banner'ların göreceli dağılımını etkiler.
 * CentralNotice'de dört adet öncelik seviyesi vardır. Daha yüksek öncelikli kampanyalar, daha fazla sayfa görüntüleme tahsisi alacaktır.
 * Kampanyalar, kampanyanın düzenlenmesini ve silinmesini engelleyecek kilitli olabilir; ancak bir kampanyanın içindeki pankartlar değil.
 * Selector — tahsis amaçları doğrultusunda filtrelenebilecek herhangi bir özellik. Bu, örneğin, Arjantin'de Vikipedi'ye İngilizce göz atan oturum açmış kullanıcılara karşı oturum açmış kullanıcılara farklı banner'ların gösterilmesine olanak tanır.
 * Bir seçim vektörü, bir kullanıcının bir başlık talep ederken merkezi vikiye sunduğu seçiciler kümesinin tamamıdır.
 * Allocation — Bir banner'ın belirli bir seçim vektörü altında bir kullanıcıya gösterilme şansı.

Tasarım belgeleri

 * Tasarım Araştırma Projesi 2017
 * Banner ayırma algoritması
 * Veritabanı şeması / tablo düzeni

GeoIP araması
Varsayılan olarak, CentralNotice'in yapılandırılmış istemci tarafı GeoIP arama hizmeti yoktur. Bu, Varnish'in sunucu tarafından  çerezi doldurduğu Wikimedia Vakfı üretim yapılandırması için optimize edilmiştir. CentralNotice'i  yapılandırma değişkeni aracılığıyla istemci tarafı özel bir veri kaynağı kullanacak şekilde yapılandırabilirsiniz. Bu değişken, bir işlevi dışa aktaran bir ResourceLoader modülünün adını bekler. İşlev parametresiz çağrılır ve aşağıdaki özellikleri içeren bir nesneyle çözümlenen bir Promise döndürmelidir:
 * country: string - İki harfli ülke kodu.
 * region: string - Uygulamaya özel.
 * city: string - Şehir adı.
 * lat: sayı.
 * lon: sayı.

Kullanım
Tam kullanım talimatları meta:Help:CentralNotice sayfasında bulunabilir.

Yeni Banner

 * 1) Special:CentralNoticeBanners yükle
 * 2) Sayfanın altındaki banner ekle bağlantısına tıklayın (hizmetli olarak oturum açmalısınız).
 * 3) Verilen banner için bir ad ve ham HTML girin.
 * 4) Bu banner çevrilecekse, çevrilecek herhangi bir metni üç parantez  içine alın.
 * 5) Submit

(TODO: move and expand this snippet)
 * Each banner has its banner definition stored in MediaWiki:Centralnotice-template-&lt;name>
 * All of its messages are stored below the banner defined in MediaWiki:Centralnotice-template-&lt;name>-&lt;message>/&lt;language_code>

New Campaign

 * 1) Load Special:CentralNotice
 * 2) Add a campaign with a given start time at the bottom portion of the page, leave a comment, and click submit.
 * 3) If this campaign is only run on a specific wiki and or language then select it from the pull downs.
 * 4) Click on the new campaign and add the banners you want within this running campaign and their respective weights.
 * 5) If all looks well then set this campaign to enabled and it will show at the corresponding time.

Overriding selection
Add any of the following URL parameters to preview a specific banner, defeat "diet" schemes, or debug pseudorandom banner selection.


 * banner
 * You can test a banner directly on any wiki by adding  to the end of the URL.


 * randomcampaign
 * A decimal number between 0 and 1, to be used as the "random" seed for choosing a campaign.


 * randombanner
 * A decimal number between 0 and 1, to be used as the "random" seed for choosing a banner among banners available in the chosen campaign.


 * country
 * Override the country code, before filtering to geotargeted campaigns. Accepts two-character ISO 3166-1 codes.


 * uselang
 * Its usual meaning in MediaWiki, this determines which banners you may be shown. Beware of content language vs. user language.


 * force
 * Override any banner hiding code, show the banner.


 * reset
 * Zero out any cookies being used to customize banner display (e.g. delivered impression count).

For example,


 * https://en.wikipedia.org/wiki/Special:Random?banner=B18WMDE_authors_02_180801_2&uselang=en&force=1
 * https://it.wikisource.org/wiki/Speciale:RandomRootpage?randomcampaign=0.142

Limitations
Banners do not display on pages in the  namespace, as well as edit pages and diff pages.

API
CentralNotice adds two API modules,  and. (The API module centralnoticeallocations was deprecated and removed in MediaWiki 1.25.)