WebBlocks Polls ile Anket Oluşturun ve Yönetin

Kurulum için bir test sitesi ve Super admin hesabı hazırlayın. Yayımlanan Polls paketi PHP ^8.3, CMS ^1.106.5 ve Laravel ^13.0 uyumluluğu bildirir. CMS sürümünüz daha yeni PHP isteyebilir; bu rehber PHP 8.4 üzerinde çalışır. Gerçek sunucunuzun uyumluluk sonucunu resmî Polls kataloğunda inceleyin.

Düzenleyip yayımlayabileceğiniz bir sayfa ve anket yönetme izni de gerekir. Ana gösterim sitemiz Northstar Studio. Örnek sayfalarımız /workshop-vote adresindeki Choose our next workshop ve /workshop-options adresindeki What would you like to learn? sayfalarıdır.

Anketler sitelere aittir. 0.1.6 sürümünde normal Polls listesinde ve formunda site seçici bulunmaz; açık bir Polls site bağlamı verilmedikçe erişilebilir ana site kullanılır. Pages ekranındaki site seçimini değiştirmek, anketin sahipliğini doğrulamanın yerini tutmaz. Çok siteli entegrasyon için Polls API başvurusundaki açık site bağlamını kullanın. Sayfanın Poll bloğu yalnızca o sayfanın sitesine ait anketleri listeler.

Yanıtların ne için kullanılacağını, toplamları kimin okuyacağını ve oylamanın ne zaman biteceğini belirleyin. Soruyu kısa, seçenekleri birbirinden farklı tutun ve herkese açık ankette bulunmaması gereken bilgileri toplamayın. Polls basit geri bildirimler için uygundur; ziyaretçi parmak izi, her oyun doğrulanmış ayrı bir kişiden geldiğini kanıtlamaz.

1. Super admin olarak System → Plugins bölümünü açın.
2. Browse Plugin Catalog ile WebBlocks Polls eklentisini bulun.
3. Install from Catalog öncesinde sürümü, uyumluluğu ve sürüm notlarını inceleyin.
4. Yöneticiniz güvenilir yayımlanmış arşivi veriyorsa Plugin ZIP altında seçip Upload Plugin ZIP düğmesini kullanın.
5. Kurulan paketi inceleyip etkinleştirin.

Örneğimiz resmî yayımlanmış ZIP'i kurar. Yeni kurulan eklenti, siz etkinleştirene kadar devre dışıdır.

Ayrıntıları açıp Enable Plugin seçin. Güncel CMS, kurulum ve etkinleştirme sırasında eklenti veritabanı değişikliklerini uygular. Oy toplamadan önce Enabled durumunu, sağlıklı sonucu ve hazır anket tablolarını doğrulayın. Önce uyumluluk veya migrasyon uyarılarını çözün.

Yan menüde artık Polls grubu ve içinde Polls bağlantısı bulunur. Açın. Yeni kurulumda No polls have been created yet. mesajı ve Add poll işlemi görünür.

Polls; görüntüleme, yönetme ve dışa aktarmayı ayırır:

Editöre ihtiyaç duyduğu görüntüleme ve yönetme izinlerini verin. Dışa aktarma iznini bilinçli olarak ekleyin. Site erişimi ayrı bir sınırdır: eklenti izinleri her sitenin anketlerine erişim sağlamaz. Paylaşılan rolü değiştirmeden önce Roller ve İzinler rehberini inceleyin.

Sayfa editörünün Poll bloğunu yerleştirmek için normal sayfa ve blok izinlerine de ihtiyacı vardır. Anket oluşturmak ve onu içeren sayfayı düzenlemek ayrı işlerdir.

Add poll seçin. İlk kart, anketin kimliğini ve kullanılabilirliğini yönetir:

Handle sayfa adresi değildir. Blok, anketini bulmak için bu tanımlayıcıyı saklar; yerleştirdikten sonra değiştirmeyin. Adı ekip için anlaşılır, handle değerini sabit tutun.

Poll copy bölümüne kaydırıp şunları girin:

Soru, isteğe bağlı açıklama ve seçenek etiketleri ziyaretçilere gösterilen metinlerdir. 0.1.6 sürümündeki normal form dört seçenek satırı sunar; bu editörde Add choice kontrolü yoktur. En az iki etiket doldurulmalıdır. Entegrasyon sözleşmesi yirmi seçenek satırına kadar kabul edebilir; bu, formda yirmi satır bulunduğu anlamına gelmez.

Save poll seçip Poll saved. mesajını doğrulayın. Listeye dönerek handle değerini, Draft durumunu ve sıfır oyu kontrol edin.

Ad ve soru en fazla 255, handle 100, isteğe bağlı açıklama 2,000 ve her seçenek etiketi 255 karakter kabul eder. Kısa soru ve öz etiketler mobilde daha kolay okunur.

Next Northstar workshop anketini yeniden açın. Locale, sonraki kaydın hangi dil kopyasına yazılacağını belirler; yönetim arayüzünün dil seçicisi değildir. Başka kod yazmak o dildeki mevcut metni yüklemez.

Türkçe örneği eklemek için:

1. Locale değerini en yerine tr yapın.
2. Soruyu Bir sonraki atölyemiz hangisi olsun? olarak değiştirin.
3. Açıklamayı ve karşılık gelen seçenek satırlarını çevirin: Fotoğrafçılık, Seramik, İllüstrasyon.
4. Her seçeneği aynı satırda tutup isteğe bağlı dördüncü satırı boş bırakın.
5. Ortak ad, handle, mod ve kullanılabilirlik ayarlarını koruyup Save poll seçin.

Çeviri kaydı, formdaki ortak işletim alanlarını da gönderir. Kaydetmeden önce bunları kontrol edin; metin eklerken anketi yanlışlıkla yayımlamayın veya yeniden zamanlamayın. Kaydedilmiş düzenleme adresi ?locale=tr değerini korur. Türkçe düzenlerken bu dil görünümüne dönün; normal liste bağlantısı panelin varsayılan dil görünümünü açar.

İngilizce soru ve seçenek etiketleri saklanmaya devam eder. Herkese açık Poll bloğu; soru, açıklama, seçenekler, oy kontrolleri ve geri bildirim için sayfanın istenen dilini kullanır. Eksik anket metninde yapılandırılmış yedek dil, ardından mevcut ilk kopya kullanılır. Yayımlayacağınız her dil için soruyu ve karşılık gelen tüm seçenekleri çevirin.

Aşağıdaki adımlarda anket ve sayfa yayımlandığında İngilizce rotayla birlikte çevrilmiş ziyaretçi rotasını da kontrol edin. Anketin herkese açık dilini değiştirmek operatörün yönetim dilinden bağımsızdır. Site dillerini açmak ve çevreleyen sayfayı çevirmek için Siteye Dil Ekleme rehberine bakın.

Show results, Poll bloğunun gösterdiğini değiştirir. Saklanan toplamları silmez ve operatör izinlerinin yerini almaz.

Ziyaretçi zaten oy vermiş ve seçilen politika sonuçları gizliyorsa ya da başlangıç zamanı gelmemişse de This poll is closed. bilgi mesajı görünebilir. Bu genel mesaj tek başına operatörün Status → Closed seçtiğini kanıtlamaz. Durumu, tarihleri ve sonuç politikasını birlikte inceleyin.

İlk alıştırmada After voting kullanın. İlk gönderimden önce oy formu, sonrasında görünür sonuç sağlar.

Kaydedilmiş İngilizce anketi açıp Status değerini Published yapın ve Save poll seçin. Bu ilk testte iki tarih alanını da boş bırakın. Listeye dönüp next-workshop yanında Published durumunu doğrulayın.

Anketi yayımlamak onu sayfanın blok seçicisine uygun hale getirir. Sayfa oluşturmaz, blok eklemez veya sayfayı yayımlamaz. Anket yalnızca Published durumundaysa ve ayarlanmış başlangıç/bitiş koşulları izin veriyorsa oy kabul eder.

Pages bölümünde hedef sayfayı açın, Main alanında Edit Blocks seçip anketin yerleşeceği kapsayıcıyı bulun. Sayfamızda başlık ve kısa giriş hazırdır. Sıfırdan başlıyorsanız Sayfa, Yerleşim, Alan, Blok ve Sayfa Oluşturma rehberlerini kullanın.

1. Kapsayıcıda Add child block veya uygun bir yerde Add Block kullanın.
2. Blok kataloğunda Poll arayın.
3. Places a published poll on a page. açıklamasına sahip Poll bloğunu seçin.

Block Fields bölümündeki Poll seçicisinden Next Northstar workshop seçin. Save New Block düğmesini kullanın.

Seçici, sayfanın sitesindeki Published anketleri listeler. Beklediğiniz anket yoksa önce durumunu ve ait olduğu siteyi kontrol edin. Gelecekteki başlangıç zamanı Published anketi seçiciden kaldırmaz; herkese açık formun ne zaman oy kabul edeceğini yönetmeye devam eder.

Blok, soru ve seçenekleri sayfaya kopyalamak yerine asıl ankete başvurur. Sonraki düzenlemeler aynı handle değerini kullanan her sayfayı etkileyebilir. Mevcut oyları olan eski anketi farklı amaçla kullanmak yerine yeni kampanya için yeni anket oluşturun.

Sayfanın kaydedilmiş Preview görünümünü açın. Soruyu, açıklamayı, doğru radyo düğmelerini ve sonuç politikasını doğrulayın. Poll bloğunun ve üst bloklarının yayın için etkin olduğunu kontrol edin.

Yayımlanmış canlı bir anket içeren önizlemeyi etkileşimli anket olarak değerlendirin. Buradaki test gönderiminin simülasyon olduğunu varsaymayın; gerçek bir oy kaydedebilir. Bu rehberde önizlemeyi inceliyor, yalnızca yerel yayımlanmış sayfadan oy gönderiyoruz.

Sayfa hazır olduğunda Sayfa Yayımlama rehberini izleyin. Sayfanın Overview bölümünde rolünüz izin veriyorsa Publish kullanın veya ekibinizin inceleme akışını izleyin. Sonra View Page ile gerçek ziyaretçi rotasını deneyin.

Yayımlanmış sayfamızda Photography seçin. Aynı anda yalnızca bir radyo düğmesi seçilebilir.

Bir kez Vote seçin. Thank you. Your vote was recorded. mesajını doğrulayın. After voting ile geçerli oturumda formun yerini toplu sonuçlar alır.

Tek test oyumuz Photography için 100% (1 votes), diğer seçenekler için sıfır üretir. Yatay barı tüm yolu doldurur; sıfır değerli seçenek boş bir yol bırakır. Her bar aynı 0–100% ölçeğini kullanır. Seçenek adı, yüzde ve oy sayısı üstünde okunabilir kalır. Örnek iş akışını gösterir; ziyaretçi tercihleri hakkında gerçek sonuç çıkarmaya yeterli veri değildir.

Sayfayı yenileyin. Aynı oturumda sonuç görünmeye devam eder ve oy formu tekrar sunulmaz. Oy sonrası sonuç görünürlüğü oturum durumuna bağlıdır; oturum değiştikten sonra dönen tarayıcı aynı görünümü görmeyebilir. Sonuçlara kalıcı kişisel erişim sözü vermeyin.

Önceden kaydettiğiniz metni kontrol etmek için sayfanın Türkçe çevirisini açın. Oy vermemiş ziyaretçi aşağıdaki gibi Bir sonraki atölyemiz hangisi olsun? sorusunu, çevrilmiş seçenekleri ve Oy ver düğmesini görür. Oy vermiş oturum, After voting altında Türkçe sonuç metnini görür. İki rota aynı ankete başvurur; sayfa dilini değiştirmek başka oy oluşturmaz.

Ayrı görsel karşılaştırma için aşağıdaki örnek, sentetik 20 oylu bir anket kullanır: Photography 12, Ceramics 6 ve Illustration 2 seçim alır. Yatay barlar aynı ölçekte %60, %30 ve %10 gösterir. Bu veri kümesi tek oylu anlatımdan ayrıdır; gerçek izleyici araştırması değildir ve diğer örneklerin sayımlarını değiştirmez.

Barlar, ortak WebBlocks UI primitive'iyle biçimlendirilmiş yerel HTML meter öğeleri kullanır. Değerleri göstermek için grafik kütüphanesi veya JavaScript gerekmez. Sonuçları incelerken görünür metni koruyun; renk ve bar uzunluğu destekleyici ipuçlarıdır.

Yönetim panelinde Polls bölümüne dönün. Votes sütunu kaydedilmiş oy pusulalarını sayar. Tekli seçim anketimiz artık bir gösterir.

Seçenek toplamları için kaydedilmiş anketi açıp seçeneklerin altına kaydırın. Save poll yanındaki Export CSV işlemini seçin. Dışa aktarma, Export poll results izni ve anketin sitesine erişim gerektirir.

Dışa aktarılan veri topludur: seçenek etiketi ve seçilme sayısı. Tek tek oy verenlerin listesi veya IP adresi dökümü değildir. İngilizce tekli seçim örneği şunu üretir:

Normal 0.1.6 editörü seçenek bazında ayrı bir sonuç panosu sunmaz. Listenin kullanılan oy sayısını, seçenek toplamları için CSV'yi veya Polls API başvurusundaki yetkili toplu sonuç uç noktasını kullanın. Herkese açık Show results ayarı yetkili dışa aktarmayı kaldırmaz.

İlk anketin anlamını ve oylarını korumak için başka anket oluşturun. İkinci örneğimiz şunları kullanır:

What would you like to learn? sayfasına Poll bloğu yerleştirin, ikinci anketi seçin, önizleyip sayfayı yayımlayın. Herkese açık form artık onay kutuları kullanır. Photography ve Illustration seçin.

Vote seçin. Tek kullanılan oy iki seçimi de kaydeder.

Her seçeneğin yüzdesinin paydasında kullanılan oy pusulası sayısı bulunur. Burada bir oyun biri Photography ve bir oyun biri Illustration seçtiği için ikisi de tam genişlikte barlarla %100 gösterir. Çoklu seçim yüzdelerinin toplamı %100 olmak zorunda değildir; barlar ortak %100 barın parçaları değil, bağımsız göstergelerdir. Liste hâlâ bir kullanılan oy sayarken CSV iki seçenek oyu içerir.

Başarılı oydan sonra geçerli oturum normal formu artık almaz. Tarayıcının Back işlemi önceki formu geri getirir ve ziyaretçi yeniden gönderirse sunucu parmak izini de kontrol eder. Tekrar gönderimimiz You have already voted in this poll. mesajı verir ve kullanılan oy toplamı bir kalır.

Eklenti CSRF koruması, rota istek sınırları ve anket, oturum, istek IP'si ve kullanıcı aracısına dayalı takma kimlikli HMAC parmak izi kullanır. Ham IP adresini oy alanı olarak saklamaz. Bu pratik bir caydırıcıdır, doğrulanmış kimlik değildir: oturumu veya diğer parmak izi girdilerini değiştirmek yeni oya izin verebilir. Kişi başına doğrulanmış tek oyun gerekli olduğu durumda uygun kimlik temelli süreç kullanın.

Ziyaretçi istek sınırı yanıtı görürse tekrar gönderimleri durdurup normal süreyi bekleyin. Mesajı aşmak için hız sınırlamasını kapatmayın. Oy ve tekrar denemelerini geçici test anketinde yapın; kullanacağınız toplamlara alıştırma oyları eklemeyin.

Oylama bitince anketi yeniden açın, Status → Closed ayarlayıp Save poll seçin. Kapatma, kayıtlı oyları ve çevirileri korur.

İlk örnekte herkese açık toplamları olmayan kapalı anketi göstermek için Show results → Never da seçiyoruz.

Ziyaretçi sayfasını yenileyin. Soru kalır, form kullanılamaz ve blok This poll is closed. gösterir.

İş bittikten sonra saklanan toplamları yayımlamak istiyorsanız uygun sonuç politikası seçin. Gerçekten Closed durumundaki bu ankette After closing, kaydedilmiş toplu sayımları gösterir ve oy formu sunmaz.

Aynı anketi yeniden açmak için Status → Published ayarlayın, tarihleri ve sonuç politikasını kontrol edip kaydedin. Mevcut oylar kalır; yeniden açma önceki oy verenleri sıfırlamaz veya anketi yeni kampanyaya dönüştürmez. Asıl oy korunarak yeniden açmayı doğruladık. Sonraki soruda bağımsız toplamlar gerekiyorsa yeni anket ve handle oluşturun.

Anket yalnızca Published durumunda, başlangıç zamanı boş veya gelmiş ve bitiş zamanı boş veya gelecekteyse oy kabul eder. Bitiş başlangıçtan sonra olmalıdır. Anketi elle kapatmak bu tarihlerden bağımsız olarak oylamayı durdurur.

Gerçek etkinliğinize uygun gelecek tarihler kullanın. Ayrı Scheduled workshop örneğimiz, gösterim sırasında açıkça gelecekte kalması için Kasım 2030 aralığı kullanır. Form tarih kontrollerinin yanında saat dilimi belirtmez; sitenin görüntüleme saat diliminin girişleri otomatik çevirdiğini varsaymak yerine uygulamanın saat dilimini yöneticinizle doğrulayın.

After closing ile bu gelecekteki anket, açılmadan önce toplamlar ve oy formu olmadan kapalı bilgisi gösterir. Published oylama aralığı başlayınca ziyaretçiler oy verebilir, sonuçlar gizli kalır. Bitiş zamanı gelince saklanan toplu sonuçlar görünür. Açık bir Closed durumu da sonuçlara izin verir; Draft anket, tarihleri geçmiş olsa bile vermez.

Sonuçları bitişe kadar ertelemek için After closing, gönderimden sonra geçerli oturuma göstermek için After voting, herkese açık toplamları gizlemek için Never seçin. Her sınırda gerçek ziyaretçi sayfasını inceleyin. Always formun yerini alan bir sonuç gösterimidir; oy toplamak için çözüm değildir.

Açık/kapalı hesabı istek sırasında yapılır; her sınırda durumu değiştirmek için ayrı görev çalıştırmanız gerekmez. Zamanlamaya güvenmeden önce gerçek başlangıç/bitiş davranışını kendi sunucunuzda deneyin. Ziyaretçiyle uygulama arasındaki önbellekleri de kontrol edin; eski sayfa güncel durumu yanlış gösterebilir.

Gerçek ziyaretçileri davet etmeden önce ait olduğu siteyi, sabit handle değerini, ifadeleri, modu, izinleri, tarihleri ve sonuç politikasını inceleyin. Çevreleyen sayfayı ve yayımlanmış rotasını bağımsız kontrol edin. Geçici ankette bir test oyu verip sayımı ve CSV'yi doğrulayın; kullanacağınız toplamlar için yeni anket oluşturun.

Çok dilli veya zamanlı yayında ziyaretçi görünümünü hedeflenen her dilde ve ilgili tarih sınırlarında doğrulayın. Kaydedilmiş formun yanında gerçek ziyaretçi görünümünü ve kayıtlı oy sayılarını kontrol edin. Anketi kapatma, toplamları dışa aktarma ve yayımlanan sonucu hedef kitleye uygun tutma sorumluluğunu bir operatöre verin.

Entegrasyon sözleşmesi için Polls başvurusu, operatör erişimi için Roller ve İzinler, sayfa iş akışı için Sayfa Yayımlama ile devam edin.