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. You can configure CentralNotice to use a custom data source client-side through the  configuration variable. This variable expects the name of a ResourceLoader module that exports a function. The function will be called without parameters and should return a Promise that resolves with an object containing the following properties:
 * country: string - Two-letter country code.
 * region: string - Implementation specific.
 * city: string - City name.
 * lat: number.
 * lon: number.

Usage
Full usage instructions can be found at meta:Help:CentralNotice.

New Banner

 * 1) Load Special:CentralNoticeBanners
 * 2) Click on the add banner link at the bottom of the page (must be logged in as an admin).
 * 3) Enter in a name and the raw HTML for the given banner.
 * 4) If this banner is going to be translated then enclose any text to be translated with triple parens -.
 * 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.)