Bu sayfa
@whop/elements@1.10.0 ve @whop/elements-react@1.10.0 sürümlerini belgeler.Whop Elements, kendi sitenize gömdüğünüz, barındırılan ve tema uygulanabilen arayüz bileşenleridir. Her element, Whop’un CDN’inden sunulan yalıtılmış bir çerçevede görüntülenir. İnce, tamamen tiplendirilmiş bir paket kurarsınız ve element kodu kendiliğinden güncel kalır.
Kurulum
Gereksinimler
İçerik güvenliği politikası
@whop/elements paketindeki contentSecurityPolicy(), ilettiğiniz ortam için bu tablodaki her kaynağı döndürür. Sayfa tarafı işlere ait satırlar bir çerçevede değil, sizin sayfanızda çalışır. Elementlerin Apple Pay, Google Pay ve PayPal ile Plaid banka hesabı bağlama için yüklediği betikler başka şirketlerden gelir ve bu satırların ötesinde kaynaklar yükleyebilir. Her sağlayıcının İçerik Güvenliği Politikası rehberini de kontrol edin.Bir modal element, arkasındaki sayfanızı satır içi bir stille karartır. Satır içi stillere izin vermeyen bir
style-src sayfayı karartılmamış bırakır, ancak modal yine de çalışır.Başlamadan önce
İki şeye ihtiyacınız var:- Bir
accountId.biz_önekli bir hesap kimliği veya kullanıcının kendi verileri içinuser_önekli bir kullanıcı kimliği. Ödeme yüzeyleri bunun yerine bir plan veya tutar alır ve her element sayfası hangisine ihtiyaç duyduğunu belirtir. - Bağladığınız elementlere kapsamlandırılmış bir erişim token’ı oluşturan bir sunucu uç noktası.
İlk elementinizi bağlayın
Script etiketi yerine npm’i mi tercih ediyorsunuz? Token, SDK’nın çağırdığı bir geri çağırma değil, sizin ayarladığınız bir değerdir. Süresi dolmadan önce yenisini ayarlayın:React’te aynı nesne
loadWhop() aynı barındırılan betiği ekler ve genel yapıcıyı çözümler:Kimlik doğrulama
Tanıtıcıyı oluştururken biraccessToken iletin. Element başına bir token değil, tanıtıcının tamamı için tek bir token kullanın. Tanıtıcı bu token’ı altındaki her elemente gönderir, bu nedenle ihtiyaç duyduğunuz tüm kapsamları o tek token için isteyin. Her element sayfası okuduğu kapsamları listeler.accessToken değerini atlarsanız, istekler bunun yerine izleyicinin oturum çerezini kullanır. Bu yalnızca whop.com üzerinde çalışır. API, kaynaklar arası ön kontrol isteklerinde Access-Control-Allow-Credentials göndermez, bu nedenle kendi alan adınızdaki bir sayfanın geri dönebileceği bir oturum yoktur ve bir token iletmesi gerekir.Genel yapılandırma
Oluşturma sırasında ilettiğiniz her şey, o örnekten oluşturulan her element grubuna uygulanır (bir tanıtıcının kendi seçenekleri grup bazında geçersiz kılabilir):Her element için görsel özelleştirme:
theme (açık/koyu + paletler), variables (CSS özel özellikleri) ve classes (parça başına stil bildirimleri). Renk şeması bir elementin ilk çiziminden önce uygulanır, bu nedenle koyu sayfalar asla açık renkte parlamaz. Görünüm sayfasına bakın.Element arayüz metinleri için yerel ayar; uygulamanın derlenmiş yerel ayarlarından biri; diğer tüm değerler varsayılan yerel ayara geri döner. Varsayılan değer
"en"."en", "es", "zh", "nl", "pt", "de", "hu", "it", "fr", "ja", "pl" veya "tr" değerlerinden biri.Elementlerin iletişim kurduğu Whop API ortamı;
"sandbox" sandbox API’sini hedefler (test verileri; gerçek para hareket etmez). Bir ortam seçmek, elementlerin alıcının yazdıklarını nereye gönderdiğini değiştirmenin tek yoludur ve her iki ortam da Whop’a aittir. Sandbox ortamı henüz genel kullanıma açık değildir. Varsayılan değer "production".Elementlerin sayfanızda bildirim (toast) gösterip gösteremeyeceği; sağ alt köşede gösterilen kısa durum mesajları (“Payment method added”, “Payment failed”). Tamamen kapatmak için
false olarak ayarlayın. Varsayılan değer true.Whop pikselini atlar. Varsayılan olarak elementler, Whop reklam pikselini henüz çalıştırmayan bir sayfaya, çalıştıkları hesaba (bir element grubunun
accountId değeri veya bir ödemenin planının satıcısı) kapsamlandırılmış olarak yükler ve element analizlerini pikselin ziyaretçi kimliğine bağlar; bu, element etkinliğini Whop’un kimlik grafiğindeki reklam ilişkilendirme verilerinizle birleştirilebilir kılan tek seferlik bir kimlik bağlantısıdır. Bunların hiçbirini yapmamak için true olarak ayarlayın. Kullanım analizlerinin kendisi etkilenmez (bunları tanıtıcı bazında analytics: false ile kapatın). Varsayılan değer false.<WhopElements appearance={…} locale={…}> üzerinden iletilir.toasts genel ayarı bu sayfada canlıdır; aşağıdaki düğme, elementlerin kullandığı aynı kanal üzerinden, bu sayfanın appearance ayarıyla temalandırılmış bir bildirim gönderir:Elementlerin üstlendikleri ve sizin sorumluluğunuzda olanlar
Her element kendi verilerini getirir ve kendi yükleme, boş ve hata durumlarını gösterir.Gezinme ve depolama sizin sorumluluğunuzdadır. Elementler seçimleri ve sonuçları olay olarak bildirir ve veritabanınıza asla yazmaz.İstisna, sayfadan ayrılan bir akıştır. Bir elementreturnUrl aldığında sekmeyi oraya yönlendirir, böylece alıcı sayfanızın dışına çıkabilir. Alıcı oraya başarılı bir site dışı adımdan sonra olduğu kadar başarısız veya yarıda bırakılmış bir adımdan sonra da, URL’ye status (succeeded, failed veya canceled) ve denemenin kimliği eklenmiş olarak ulaşır; bu nedenle returnUrl adresindeki sayfa bir başarı mesajı göstermeden önce status değerini okumalıdır. Teslimatı bir tarayıcı geri çağırması yerine webhook’lardan yapın.Elementler çerçevelerde çalışır, bu nedenle sınırı yalnızca serileştirilebilir değerler geçer. Paylaşılan bir DOM yoktur ve nesne kimliği korunmaz.Sorun giderme
Kullanılabilir elementler
Payments
Bir
plan_ kimliğinden veya satır içi para birimi ve tutardan ödeme toplayın ya da mode: "setup" ile ücret almadan bir ödeme yöntemi kaydedin.Verifications
Bir hesap için kimlik bilgilerini toplar ve doğrular.
Checkout
Whop ödeme oturumları API’sine karşı bir veya daha fazla plan için eksiksiz, barındırılan bir ödemeyi yönetir: kalem kalem fiyat özeti, promosyon kodları, alıcının ödeme yaptığı para birimi ve ödeme toplama yüzeyinin tamamı (içine yerleştirilmiş ödeme elementleri).
Ads
Bir reklam hesabı.
Tracking
Bir hesabın izlenen kitlesi: pikselinin gördüğü herkes ve gerçekleştirdikleri her olay.
Wallet
Bir hesabın para yüzeylerini yönetir.
Websites
Bir hesabın web siteleri: whop.site üzerinde oluşturulan her site ve Whop Pixel’in bildirdiği her alan adı, alan adı başına trafik ve ilişkilendirilmiş gelirle birlikte.
Dashboard
Bir hesabın sitenize gömülü kendi kontrol paneli yüzeyleri.
Delivery
Bir işletme için müşteri teslimat takibi.
Chat
Kanal listesi ve mesaj aramasıyla gerçek zamanlı sohbet.
Sonraki adımlar
- Görünüm: tema, CSS değişkenleri ve parça bazında yeniden stillendirme
- Create Access Token: sunucunuzun token oluşturduğu uç nokta

