Denne side dokumenterer
@whop/elements@1.10.0 og @whop/elements-react@1.10.0.Whop Elements er hostede UI-komponenter med temaunderstøttelse, som du indlejrer på dit eget website. Hvert element renderes i en isoleret frame, der leveres fra Whops CDN. Du installerer en tynd, fuldt typet pakke, og elementkoden holder sig selv opdateret.
Installation
Krav
Content Security Policy
contentSecurityPolicy() fra @whop/elements returnerer alle kilder i denne tabel for det miljø, du angiver. Rækkerne for arbejde på sidesiden kører på din side, ikke i en frame. De scripts, som elementer indlæser til Apple Pay, Google Pay og PayPal samt tilknytning af bankkonto via Plaid, kommer fra andre virksomheder og kan indlæse ressourcer ud over disse rækker. Tjek også hver udbyders vejledning om Content Security Policy.Et modalt element nedtoner din side bag sig med en inline-style. En
style-src, der ikke tillader inline-styles, efterlader siden unedtonet, men modalen fungerer stadig.Før du starter
Du skal bruge to ting:- Et
accountId. Et konto-ID med præfiksetbiz_eller et bruger-ID med præfiksetuser_til brugerens egne data. Betalingsflader tager i stedet en plan eller et beløb, og hver elementside angiver, hvad den kræver. - Et server-endpoint, der opretter et adgangstoken, afgrænset til de elementer, du monterer.
Montér dit første element
Foretrækker du npm frem for script-tagget? Tokenet er en værdi, du angiver, ikke en callback, som SDK’et kalder. Sæt et nyt, før det udløber:I React bæres det samme objekt af
loadWhop() indsætter det samme hostede script og resolver den globale constructor:Godkendelse
Angiv etaccessToken, når du opretter handlet. Brug ét token til hele handlet, ikke ét pr. element. Handlet sender det token til alle elementer under det, så bed om alle de scopes, du har brug for, på det ene token. Hver elementside angiver de scopes, den læser.Hvis du udelader
accessToken, bruger forespørgsler i stedet seerens sessionscookie. Dette fungerer kun på whop.com. API’et sender ikke Access-Control-Allow-Credentials ved cross-origin-preflights, så en side på dit eget domæne har ingen session at falde tilbage på og skal angive et token.Global konfiguration
Alt, hvad du angiver ved oprettelsen, gælder for alle elementgrupper, der oprettes fra den instans (et handles egne indstillinger kan tilsidesætte pr. gruppe):Visuel tilpasning af alle elementer —
theme (lys/mørk + paletter), variables (CSS custom properties) og classes (style-deklarationer pr. del). Farveskemaet anvendes før et elements første rendering, så mørke sider aldrig blinker lyst. Se Appearance.Sprog for elementernes UI-tekst — et af appens indbyggede sprog; enhver anden værdi falder tilbage til standardsproget. Standard er
"en".En af "en", "es", "zh", "nl", "pt", "de", "hu", "it", "fr", "ja", "pl" eller "tr".Hvilket Whop API-miljø elementerne taler med —
"sandbox" går til sandbox-API’et (testdata; ingen rigtige penge flyttes). Valg af miljø er den eneste måde at ændre, hvor elementerne sender det, en køber indtaster, og begge miljøer er Whops egne. Sandbox-miljøet er endnu ikke generelt tilgængeligt. Standard er "production".Om elementer må vise toast-notifikationer på din side — korte statusbeskeder (“Payment method added”, “Payment failed”), der renderes i nederste højre hjørne. Sæt
false for at slå dem helt fra. Standard er true.Spring Whop-pixlen over. Som standard indlæser elementer Whop-annoncepixlen på en side, der ikke allerede kører den, afgrænset til den konto, de arbejder for (en elementgruppes
accountId eller sælgeren af en checkouts plan), og knytter elementanalyser til pixlens besøgs-id, en engangskobling af identitet, der gør elementaktivitet mulig at sammenkøre med dine data om annonceattribution i Whops identitetsgraf. Sæt true for at gøre ingen af delene. Selve brugsanalyserne påvirkes ikke (slå dem fra pr. handle med analytics: false). Standard er false.<WhopElements appearance={…} locale={…}>.Den globale toasts er live på denne side — knappen nedenfor sender en via den samme kanal, som elementerne bruger, med denne sides appearance som tema:Hvad elementerne håndterer, og hvad du selv står for
Hvert element henter sine egne data og renderer sine egne tilstande for indlæsning, tomhed og fejl.Du håndterer navigation og lagring. Elementer rapporterer valg og resultater som events og skriver aldrig til din database.Undtagelsen er et forløb, der forlader siden. Hvor et element tager enreturnUrl, navigerer det fanen dertil, så køberen kan ende uden for din side. Køberen ankommer dertil efter et mislykket eller afbrudt eksternt trin såvel som efter et vellykket, med status (succeeded, failed eller canceled) og forsøgets ID tilføjet til URL’en, så siden på returnUrl skal læse status, før den viser en succesbesked. Lever ud fra webhooks i stedet for ud fra en browser-callback.Elementer kører i frames, så kun serialiserbare værdier krydser grænsen. Der er ingen delt DOM, og objektidentitet bevares ikke.Fejlfinding
Tilgængelige elementer
Payments
Indsaml en betaling ud fra et
plan_-ID eller en inline valuta og et beløb, eller gem en betalingsmetode uden opkrævning med mode: "setup".Verifications
Indsamler og verificerer identitetsoplysninger for en konto.
Checkout
Driver en fuld hostet checkout for en eller flere planer — specificeret prisoversigt, rabatkoder, den valuta, køberen betaler i, og hele fladen til indsamling af betaling (betalingselementerne, sammensat indeni) — mod Whops API til checkout-sessioner.
Ads
En annoncekonto.
Tracking
En kontos sporede målgruppe: alle, som dens pixel har set, og alle events, de har udført.
Wallet
Driver en kontos pengeflader.
Websites
En kontos websites: alle sites bygget på whop.site plus alle domæner, som Whop Pixel rapporterer, med trafik og tilskrevet omsætning pr. domæne.
Dashboard
En kontos egne dashboard-flader, indlejret på dit website.
Delivery
Leveringssporing for en virksomheds kunder.
Chat
Realtidschat med en kanalliste og søgning i beskeder.
Næste trin
- Appearance: temaer, CSS-variabler og restyling pr. del
- Create Access Token: det endpoint, din server udsteder fra

