WebBlocks Memberships ile Üyelere Özel Bir Alan Oluşturun

Memberships, kolayca karıştırılabilen dört öğeyi birbirine bağlar:

Ziyaretçi hesabı, CMS yönetici hesabından ayrıdır. Üye olarak kayıt olmak yönetim paneline erişim sağlamaz. Paketin kendisinin bir fiyatı yoktur: fiyatı, ödeme aralığını ve sağlayıcı seçimini ücretli plan belirler.

Hesapları, ücretsiz paketleri, manuel atamaları ve korumalı sayfaları Commerce olmadan kullanabilirsiniz. Yinelenen ücretli abonelikler, uyumlu Commerce ödeme sağlayıcıları gerektirir. Commerce Buy Button eklemek tek seferlik ürün satışı yapar; yinelenen Memberships aboneliği oluşturmaz.

Geliştirici uç noktaları ve entegrasyon ayrıntıları için Memberships başvurusuna bakın. Bu rehber paneldeki işlemleri ve ziyaretçi hesabı ekranını izler.

İş akışını öğrenirken test kurulumu kullanın. Şunlara ihtiyacınız var:

• Çalışan bir WebBlocks CMS sitesi ve eklenti kurulumu için Super admin hesabı.
• Uyumlu sürüm: Memberships 0.2.0, CMS ^1.100.0 gerektirir; katalog uyumluluğu PHP 8.4 ve Laravel 13 belirtir. Kataloğu gerçek kurulumla karşılaştırın.
• Seçilen sitede Memberships yönetme ve sayfa düzenleme izni. Eklenti bir Site Admin izni sağlar; kullanıcının site ataması da geçerlidir.
• Doğrulama ve parola sıfırlama için doğru kanonik site alan adı ve çalışan CMS giden e-posta yapılandırması.
• Daha sonra ücretli planlar için: Commerce ^0.16, yapılandırılmış PayPal veya SumUp sağlayıcısı, herkese açık HTTPS geri çağrı adresi ve çalışan Laravel zamanlayıcısı.

Üyeleri davet etmeden önce barındırma yöneticinizden test posta kutusuyla teslimatı doğrulamasını isteyin. Yerel görsel ortamı örnek hesaplar kullanır; gerçek gelen kutusuna teslimatı göstermez.

Memberships, eklenti kataloğunda ücretsiz listelenir. Satıcı hesapları ve ödeme işleme ayrı hizmetlerdir.

1. Super admin olarak giriş yapıp System → Plugins bölümünü açın.
2. Browse Plugin Catalog seçeneğinden Memberships eklentisini açın.
3. Uyumluluğu ve seçili sürümü inceleyip Install from Catalog seçeneğini kullanın.
4. Kurulan eklentinin ayrıntı ekranını açıp Enable Plugin seçeneğini kullanın. Yeni kurulan paketler önce inceleyebilmeniz için devre dışı başlar.
5. Ziyaretçileri davet etmeden önce eklenti sağlığını ve veritabanı kurulum sonucunu kontrol edin.

Yöneticiniz güvenilir bir sürüm ZIP'i verirse Plugin ZIP → Upload Plugin ZIP yolunu kullanın, inceleyip etkinleştirin. Panelden kurulum için site sahibinin eklentiyi kaynak koddan derlemesi gerekmez.

Güncel CMS sürümleri eklenti veritabanı değişikliklerini kurulum, güncelleme ve etkinleştirme sırasında uygular. Kurulum başarısızsa ilerlemeden önce bildirilen hatayı çözün. E-posta veya sağlayıcı uyarısı, eksik veritabanı tablolarından farklı bir hazırlık sorunudur.

Kenar çubuğundan Memberships bölümünü açın. Üstteki site adının hedef siteniz olduğunu doğrulayın. 0.2.0 sürümünde yönetim URL'si ?site_id=... kabul eder; site belirtilmezse panel yetkili olunan ilk siteyi seçer. Çok siteli kurulumda yöneticiden doğru siteye ait yönetim URL'sini açmasını isteyin ve paketleri, hesapları veya sayfa erişimini değiştirmeden önce başlığı kontrol edin. Bu sürümde Memberships formunun içinde ayrı site seçicisi yoktur.

Paket, erişim haklarını gruplar. Hesap ve sayfa erişimi akışını ödeme sağlayıcısı olmadan sınamak için ücretsiz paketle başlayın.

Memberships ekranında mevcut paketleri geçip boş Packages formuna ilerleyin:

1. Name alanına Studio community yazın.
2. Description alanına Free access to the Northstar Studio member reading room. yazın.
3. Allow free self enrollment kutusunu işaretleyin.
4. Bu formun Save düğmesine basın.

Yeni paket oluşturulduğunda etkindir. Kaydedilen formda Package ID, Active ve Allow free self enrollment görünür. Sonraki adımlar için kimliği not edin.

Ziyaretçilere yalnızca etkin ve ücretsiz katılıma izin veren paketler gösterilir. Doğrulanmış ziyaretçi, operatör veya ödeme onayı olmadan katılabilir. Ücretsiz katılım, bitiş tarihi olmayan üyelik oluşturur.

Workshop circle adında ikinci paket oluşturup açıklamasını Workshop resources for invited participants. yapın. Allow free self enrollment kutusunu boş bırakın. Bu paketi 7. adımda manuel atayacak veya daha sonra ücretli plana bağlayacaksınız.

Ödeme veya davet gerektiren pakette ücretsiz katılımı kapalı tutun. Aksi halde doğrulanmış ziyaretçi aynı paketi ücretsiz yoldan alabilir. Ayrı ücretli plan, kullanılabilir ücretsiz atamayı geçersiz kılmaz.

Doğrudan /plugins/webblocks-memberships/account adresine bağlantı verebilir veya normal CMS sayfasında yerel blokları kullanabilirsiniz.

Join Northstar Studio adında taslak sayfa oluşturun ya da mevcut katılım sayfasına aşamalı güncelleme hazırlayın. Paketlerle aynı siteyi kullanın. Başlık ve üyeliğin sunduklarını açıklayan kısa bir metin ekleyip:

1. Sayfanın Main slotunda Add Block seçeneğini kullanın.
2. Memberships'in yerel hesap bloğu olan My membership account seçeneğini seçin.
3. Bloğu kaydedin.
4. İsterseniz yerel paket listesi bloğu Available free packages ekleyin.
5. Sayfayı önizleyin.

Hesap bloğu bir My membership account bağlantısı gösterir. Kayıt, giriş, parola sıfırlama ve hesap yönetimi ayrı hesap sayfasında yapılır. Blok, içerik sayfanıza kayıt formu gömmez.

Paket listesi bloğu, ücretsiz katılıma açık etkin paketleri Join free package bağlantılarıyla gösterir. Katılımın başarılı olması için ziyaretçinin yine giriş yapması ve e-postasını doğrulaması gerekir. Üst alana kalıcı bağlantı için hesap rotasına giden Member account menü öğesi ekleyin; Gezinme Menüleri rehberine bakın.

Önce önizleyin; katılım sayfasını yalnızca metinler, bağlantılar ve kayıt e-postası hazırken yayınlayın. İçerik taslağının önizlemesi, hesap işlemleri için deneme ortamı değildir: kayıt, katılım ve ödeme istekleri kurulumun gerçek üye kayıtlarını kullanır.

Hesap bağlantısını ayrı tarayıcı profilinde veya gizli pencerede açın. Böylece ziyaretçi oturumunu yönetici oturumunuzdan ayırmak kolaylaşır.

İlk kayıt formu Name ve Email ister. Ziyaretçiden posta kutusunun kendisine ait olduğunu kanıtlamadan parola belirlemesi özellikle istenmez.

1. Create account altında test adı ve kontrol ettiğiniz e-posta adresini girin.
2. Create account düğmesine basın.
3. Aynı sitenin kanonik alan adındaki doğrulama e-postasını açın.
4. Bağlantıyı izleyip Password ve Confirm password alanlarını doldurun, ardından Continue seçeneğini kullanın.
5. Sign in bölümüne dönüp bu e-posta ve parolayla giriş yapın.

Doğrulama bağlantıları 24 saat sonra geçersiz olur. Bağlantıyı açmak onay formunu gösterir; formu göndermek doğrulamayı tamamlar ve parolayı belirler. E-posta bağlantısını yalnızca görüntülemek onu tüketmez.

E-posta gelmezse alıcının spam klasörünü, CMS giden posta yapılandırmasını ve kanonik alan adını kontrol edin. Hesap akışında yeniden gönderme seçeneği varsa kullanın. Bekleyen hesapta Request password reset, posta kutusu doğrulamasını atlamak yerine doğrulama bağlantısı gönderir. E-posta sorununu aşmak için ikinci hesap oluşturmayın.

Giriş yapmış ancak doğrulanmamış ziyaretçi paketlere katılamaz veya üyelere özel içeriği açamaz. Hem doğrulama hem hesabın etkin olması gerekir. Parola sıfırlama, önceki üye oturumlarını geçersiz kılar.

Girişten sonra My membership account, ziyaretçinin adını ve e-postasını, profil adı alanını, mevcut üyelikleri, abonelikleri ve kullanılabilir paketleri gösterir.

Örnek hesabımızda 7. adımdaki operatör akışını göstermek için zaten süreli Workshop circle ataması bulunur. Yeni kaydolan ziyaretçinin başlangıçta üyeliği yoktur.

Available free packages altında Studio community paketini bulup Join free package seçeneğini kullanın. Üyelik listesine artık Studio community, başlangıç zamanı, No expiry ve Active eklenir.

Bu işlem ziyaretçiyi ücretsiz pakete kaydeder; ödeme yetkisi veya ücretli abonelik oluşturmaz. Ziyaretçi, mevcut operatör atamasını ücretsiz katılımla uzatamaz veya değiştiremez. Önceki atama dolmuş ya da iptal edilmişse tekrar Join düğmesine basmak yerine operatörden inceleyip uzatmasını isteyin.

Aynı sitede Studio reading room adında sayfa oluşturun. Üye içeriğini ekleyip erişimi değiştirmeden önce inceleyin. Memberships formunda bulabilmek için sayfa başlığını hatırlayın.

Memberships bölümünde Page access alanına ilerleyip:

1. Page alanından Studio reading room seçin.
2. Access alanından Package holders seçin.
3. Package ID alanından Studio community seçin.
4. Bu formun Save düğmesine basın.

Üç erişim seçeneği vardır:

Bu formda bir sayfa için seçilmiş tek paket şartı belirlenebilir. Aynı paket manuel atamayla veya doğrulanmış ücretli dönemle alınabilir; bunlar bağımsız erişim kaynaklarıdır.

Okuma odası taslaksa kuralı kontrol ettikten sonra yayınlayın. Page access formu erişim politikasını hemen değiştirir; sayfanın içerik taslağından veya aşamalı güncellemesinden ayrıdır. Kuralın kaydedilmesinin sonraki içerik yayınına ertelendiğini varsaymayın. Canlı sayfayı yeniden kontrol edin ve öğrenirken test sitesi kullanın.

Doğrudan sayfa URL'sini iki ziyaretçi oturumunda test edin:

• Oturum kapalı: okuma odası içeriği erişilemez kalmalı.
• Doğrulanmış Studio community üyesi olarak giriş yapılmış: sayfa açılmalı.

Bu testte yönetici önizlemesini değil ziyaretçi rotasını kullanın. İmkânınız varsa gerekli paketi olmayan doğrulanmış hesabı da test edin: yalnızca doğrulama, paketle korunan sayfayı açmamalı.

Korumalı sayfalar herkese açık arama, site haritası ve otomatik sayfa gezinmesinde gösterilmez. Okuma odasını otomatik sayfa listesinin tanıtmasına güvenmek yerine üyelere örneğin katılım sayfasındaki açıklamalarda bilinçli olarak bağlantı verin.

Memberships kullanılamaz hale gelirse koruma devam eder. Eski içerik revizyonunu geri yüklemek mevcut erişim kuralını kaldırmaz. Kopyalar kısıtlamaları devralır; siteler arası paket hakları açıkça yeniden atanmalıdır. İçeriği geri yüklemeyi veya eklentiyi kapatmayı sayfayı herkese açmanın yolu olarak görmeyin. Bilinçli olarak açmak için Page access içinde Public seçip kaydedin.

Davet, çevrimdışı anlaşma veya süreli atölye hakkı için manuel atama kullanın.

Members tablosunda ziyaretçinin Member ID değerini, kaydedilmiş Workshop circle formunun üstünde Package ID değerini bulun. Bu kimlikler seçilen sitedeki kayıtları tanımlar; hesap parolası veya davet kodu değildir.

Grant or extend membership alanına ilerleyip girin:

Save seçeneğini kullanın. Atama Membership grants altında, üyenin hesabında da üyelik olarak görünür.

Panel bu tarihleri UTC olarak etiketler. İstediğiniz başlangıcı ve bitişi girmeden önce sitenizin yerel saatinden dönüştürün. Ziyaretçi hesabı tarihleri sitenin yapılandırılmış saat diliminde gösterir. Gelecekteki başlangıç henüz etkin değildir; şu an veya daha önceki bitiş süresi dolmuştur. Ends at UTC alanını yalnızca bitiş tarihi olmayan üyelik istiyorsanız boş bırakın.

Aynı üye/paket atamasını uzatmak için aynı kimliklerle istediğiniz tam başlangıç ve bitiş tarihlerini tekrar girip kaydedin. Bu, kopya oluşturmak yerine o atamayı günceller. Önceki iptali de kaldırdığından kaydetmeden önce tüm süreyi inceleyin.

Kalıcı test için test gününü kapsayan tarihler seçin; görseldeki sabit tarihler sonsuza kadar tekrar kullanılacak değerler değildir.

Membership grants içindeki Revoke, o manuel atamanın hakkını kaldırır. Ayrı ücretli aboneliği iptal etmez; üyenin aynı pakete başka güncel hak üzerinden erişimi devam edebilir. Erişimi araştırırken hem atamaları hem ücretli ödemeleri inceleyin.

Members tablosundaki Disable account, hesabın giriş yapmasını veya mevcut üye oturumlarını kullanmasını engeller. Üyenin yenilemelerinin iptalini de talep eder. Hesabı yeniden etkinleştirmek yeni giriş gerektirir; yeni ödeme yetkisi sayılmaz.

Pakette Active seçimini kaldırmak o paketi erişim için kullanılamaz yapar ve abonelikleri için yenileme iptali ister. Paket devre dışı bırakmayı yalnızca listeden kart gizleme olarak değil erişim ve ödeme değişikliği olarak ele alın.

Ücretli üyeliklerde 11. adımdaki iptal kontrollerini de izleyin. Sıraya alınmış iptal hâlâ sağlayıcı onayı gerektirir; yerel kayıtları kapatmak harici anlaşmanın sona erdiğini kanıtlamaz.

Önce ücretsiz akışı tamamlayın. Ücretli planlar için yöneticiyle birlikte Commerce 0.16.x ve PayPal veya SumUp sağlayıcısını yapılandırın. Memberships bu sağlayıcı ayarlarını yeniden kullanır; içinde ikinci kimlik bilgileri formu yoktur.

Commerce rehberi kurulum ve sağlayıcı ayarlarını açıklar. Test order (no payment) seçeneği tek seferlik Commerce siparişleri içindir. Doğrulanmış yinelenen Memberships ödemesi veya ücretli erişim oluşturamaz.

Plan sunmadan önce:

1. Commerce → Settings içinde hedef sağlayıcıyı sandbox ortamı ve eşleşen test satıcı hesabıyla başlayarak yapılandırın.
2. Sağlayıcının kimlik bilgilerini, desteklenen para birimini ve hazırlık durumunu kontrol edin.
3. Üyelik sitesi için herkese açık HTTPS kanonik alan adı belirleyin.
4. Geri çağrı teslimatını doğrulayın. PayPal mevcut Commerce webhook'unu abonelik ve satış olaylarıyla; SumUp ise Memberships ödeme geri çağrısını kullanır.
5. Barındırma yöneticisine ana uygulamanın Laravel zamanlayıcısını her dakika çalıştırıp heartbeat durumunu doğrulatın.
6. Ödeme gerekiyorsa paketin etkin ve Allow free self enrollment seçiminin kapalı olduğunu doğrulayın.

Memberships, webblocks-memberships:billing:sync komutunu her beş dakikada çalışacak şekilde kaydeder. PayPal kendi yerel yenileme tahsilatlarını yapar; yerel görev sağlayıcı kanıtlarını ve erişimi uzlaştırır. SumUp için görev, yetkilendirilmiş vadesi gelen yenilemeleri de işler. Yönetici uzlaştırmayı araştırmak için komutu çalıştırabilir; ancak komutun vadesi gelen yetkili SumUp tahsilatlarını işleyebileceğini bilmelidir. Yalnızca önizleme yapan tanı komutu değildir.

PayPal webhook'u /plugins/webblocks-commerce/webhooks/paypal adresidir. PayPal uygulamasının webhook aboneliğine ilgili BILLING.SUBSCRIPTION.* ve PAYMENT.SALE.* olay konularını ekleyin. Yinelenen SumUp geri çağrısı /plugins/webblocks-memberships/billing/webhooks/sumup adresidir ve Commerce'in tek seferlik sipariş geri çağrısından ayrıdır. Görseldeki localhost adresini değil kanonik HTTPS ana makinesini kullanın.

Sağlayıcı hesabının gereksinimleri için güncel PayPal Subscriptions belgelerini ve SumUp kayıtlı kart rehberini izleyin. Başarılı tek seferlik ödeme, o satıcının yinelenen ödeme desteğini tek başına doğrulamaz.

Memberships → Paid plans içinde plan formunu doldurun:

Amount in minor units tam sayıdır. €10 planı için 1000 girin; 10 veya 10.00 değil. Para biriminin basamak sayısı değişebilir; hepsinin kuruş kullandığını varsaymayın. Aylık aralık sayısı 1–12 olabilir. Yıllık planda year(s) ve 1 kullanılır.

Save düğmesine yalnızca sağlayıcı yapılandırması hazır olduğunda basın. Kaydedilen planın gösterilen tutarını ve paket bağlantısını kontrol edin. Görsel, yapılandırılmış satıcı kimlik bilgileri olmadan gönderim öncesi formu gösterir; çalışan sağlayıcı bağlantısının kanıtı değildir.

Mevcut abonelikler kabul edilmiş fiyat ve ödeme aralığını korur. Fiyat değişirse yeni plan oluşturun. Yeni planın mevcut onayları sessizce güncellediğini varsaymayın.

Hesap sayfasında doğrulanmış üye Paid plans bölümünden kullanılabilir Payment provider seçer ve açık onay kutusunu işaretler:

I authorize the stated recurring subscription charge until I cancel renewal.

Ardından Subscribe seçeneğini kullanır. Ücretli plan hem kendi sağlayıcı seçiminin açık hem o sağlayıcının kullanılabilir olmasını gerektirir; boş sağlayıcı listesi veya kapalı Subscribe düğmesi, ücretsiz katılımı açmak için gerekçe değil çözülmesi gereken hazırlık sorunudur.

PayPal: üye Approve with PayPal bağlantısıyla PayPal'da yinelenen anlaşmayı onaylar. Siteye dönüş ödeme kanıtı değildir. Check payment status kullanın ve paket erişimi beklemeden önce sunucunun ödenmiş abonelik dönemini doğruladığından emin olun.

SumUp: üye sağlayıcının kart bileşenini ve kayıtlı kartla yinelenen ödeme için gereken doğrulamayı tamamlar. Geçici 1 birimlik kurulum tahsilatı iade edilir; EUR kurulumunda bu €1.00 demektir. Bu kurulum €10 abonelik bedelini ödemez veya paketi açmaz. Erişim yalnızca doğrulanmış abonelik ödemesinden sonra başlar. Ham kart bilgileri normal CMS bloğuna değil sağlayıcının bileşenine girilmelidir.

Üye hesap ekranından Manage subscription bölümünü açabilir. Operatörler Paid plans altında Subscriptions, Check payment status, Cancel renewal ve ödeme geçmişi tablosunu görür.

Canlı plan sunmadan önce sağlayıcının sandbox ortamında iptali test edin. Cancel renewal ardından harici iptal doğrulanana kadar Check payment status kullanın. İptal talebi gelecekteki yenileme isteklerini durdurur; ancak önceden istenmiş ödeme tamamlanabilir. İade edilmiş veya ters kaydedilmiş dönemler dışında erişim normalde ödenmiş dönemin sonuna kadar sürer.

Stop offering this plan and cancel renewal, planın tamamını etkiler ve abonelikleri için iptal ister. Fiyat düzenleme veya tüm yenilemeleri sürdürerek teklifi gizleme düğmesi değildir.

Tamamen kaçırılmış SumUp dönemi için tüm geçmiş dönemleri otomatik tahsil etmek yerine yeni katılım gerekir. Ödeme sonucu bilinmiyorsa yeni abonelik göndermeye devam etmeyin; önce mevcut referansı uzlaştırın. Manuel atamalar bağımsız kalır: atamayı iptal etmek ödemeyi iptal etmez, ödemeyi iptal etmek de geçerli manuel atamayı silmez.

Memberships, Commerce veya sağlayıcı ayarlarını kalıcı kaldırmadan önce harici anlaşmaları iptal edip sonucu doğrulayın. Yerel eklenti kodunu kaldırmak tek başına yerel PayPal anlaşmasını iptal etmez.

Canlı sağlayıcı ayarlarına yalnızca hedef satıcının sandbox ortamında onay, ödeme doğrulama, yenileme, iptal ve geri çağrı kontrolleri geçtiğinde geçin. Bu testler kendi test hesabınızı gerektirir; rehberin örnek görselleri onların yerini tutmaz.

Korumalı sayfa, zaten herkese açık dosya URL'sini özel yapmaz. Gizli çalışma dosyasını açık depolamaya yükleyip sayfasını gizlemenin dosyayı koruduğunu varsaymayın.

Barındırma yöneticisinden özel, herkese açık olmayan dosya sistemi diski hazırlamasını isteyin. Korumalı sayfada yayınlanmış blok tarafından kullanılan özel Media Library kaydı, aynı sayfa/paket erişim denetimiyle Memberships özel indirme rotasından sunulabilir.

Rota biçimi /plugins/webblocks-memberships/downloads/{page}/{media} şeklindedir. Kurulumunuzdaki gerçek sayfa ve medya kimliklerini kullanıp yayınlanmış blok ilişkisini doğrulayın. Yalnızca medya kaydının gizlilik bayrağını değiştirmek açık depolama URL'sini geri alamaz. İndirmeyi hem oturum kapalıyken hem hedef paket sahibi olarak test edin.

Normal açık indirmeler için İndirilebilir Dosya Sunun rehberine bakın. Bu akışı üye kaynakları için yeniden kullanmadan önce yöneticinin gizli dosya depolamasını incelemesini sağlayın.

Appointments, giriş yapmış ziyaretçiyi tanımak, müşteri ayrıntılarını önceden doldurmak ve rezervasyonu doğrulanmış üyeyle ilişkilendirmek için isteğe bağlı olarak Memberships kullanabilir. Bir hizmet doğrulanmış hesap veya seçilen etkin paket gerektirebilir.

Kısıtlı hizmeti yapılandırırken aynı siteyi ve hedef paketi seçin. Ücretli paket hakkı, manuel atamayla aynı doğrulanmış erişim sorgusunu kullanır. Üyeliği çoğaltmak için başka Commerce ürünü satmanız gerekmez.

Memberships olmadan normal misafir rezervasyonları sürebilir. Gerekli üye hizmeti kullanılamadığında kısıtlı hizmetler kapalı kalır. Üyenin erişimini değiştirmek geçmiş randevulardaki müşteri kayıtlarını yeniden yazmaz. Ayrı hizmet kurulumu için Appointments başvurusuna bakın.

Katılım sayfasının teklifi açıkladığını, hesap bağlantılarının doğru siteyi açtığını, doğrulama e-postasının geldiğini ve doğrulanmış ziyaretçinin hedef ücretsiz pakete katılabildiğini doğrulayın. Korumalı sayfayı oturum kapalıyken, paketsiz ve güncel paket erişimiyle kontrol edin. UTC tarihlerini ve yalnızca ücretli paketlerde ücretsiz katılımın kapalı olduğunu doğrulayın.

Yinelenen ödeme sunuyorsanız ayrıca sağlayıcının sandbox ortamını, geri çağrıları, zamanlayıcıyı, güncel dönem erişimini ve doğrulanmış iptali test edin. Yalnızca incelediğiniz sayfaları yayınlayın, ardından herkese açık HTTPS sitede doğrudan ziyaretçi ve indirme kontrollerini tekrarlayın.

Memberships başvurusu, Commerce rehberi, Gezinme Menüleri veya Roller ve İzinler ile devam edin.