Les sites web d’un compte : chaque site construit sur whop.site ainsi que chaque domaine signalé par le Whop Pixel, avec le trafic et les revenus attribués par domaine. Montez websites et il les liste avec les visiteurs, les pages vues, les ventes, les revenus, la tendance et les pages les plus consultées. Montez pixel-setup à côté et un site dont l’assistant vient de prouver que le pixel est actif obtient automatiquement une ligne d’attente, car ses premiers événements mettent quelques minutes à atteindre l’API de statistiques et le site semblerait sinon perdu — vous n’avez rien à configurer pour cela, et la ligne est conservée sur votre page afin d’être toujours là si le marchand recharge la page. La lecture des statistiques est privilégiée et nécessite donc un accessToken — sauf dans l’application Whop elle-même, où la session du visiteur assure la lecture.
Cette page documente @whop/elements@1.10.0 et @whop/elements-react@1.10.0.
Depuis v1.0.0.
Playground
Assemblez les éléments avec des données d’exemple. Manipulez les contrôles, ajoutez et organisez des éléments, et observez les événements se déclencher en direct :
import { WhopElements, Websites } from "@whop/elements-react";import { loadWhop } from "@whop/elements";function Example() { return ( <WhopElements elements={loadWhop()}> <Websites /* options */> {/* mount elements here */} </Websites> </WhopElements> );}
Transmettez-les à whop.websites.create({ … }), ou comme props sur <Websites> avec React.
number
Le nombre de jours de trafic couverts par le tableau, de 1 à 90. @default 30 Par défaut : 30.
boolean
Liste les sites construits sur whop.site dès leur création, avec des zéros jusqu’à l’arrivée du trafic. Désactivez cette option pour n’afficher que les domaines signalés par le pixel. @default true Par défaut : true.
PendingWebsite[]
Les sites que vous venez d’ajouter et qui ne sont pas encore en ligne — { domain, kind }, où kind vaut deploy pour un site sur whop.site en attente de son premier déploiement, ou events pour un site en attente de ses premiers événements pixel. Ils s’affichent comme lignes d’attente afin qu’un site ne semble jamais perdu juste après sa configuration, et le tableau interroge le serveur tant qu’il en reste en attente. Les sites dont l’assistant pixel-setup monté prouve qu’ils sont actifs sont ajoutés pour vous, conservés après un rechargement, et ne sont PAS à votre charge — cette option concerne les attentes que le handle ne peut pas voir lui-même, avant tout un site sur whop.site que vous venez de créer, qu’aucun élément ici ne signale. C’est à vous de supprimer les entrées que vous ajoutez : une ligne cesse d’être affichée dès que son domaine atteint le tableau, mais la liste elle-même ne change que lorsque vous la modifiez ; retirez donc une entrée lorsque websitesLoaded nomme son domaine, et appliquez votre propre délai d’expiration aux autres. Par défaut : [].
Afficher propriétés
string
requis
"events" | "deploy"
requis
boolean
Ajoute un bouton de vérification du pixel à chaque ligne. L’élément se contente de signaler l’appui via onVerifyRequested — l’ouverture du site et la décision du résultat vous reviennent, car c’est à une popup ouverte par votre propre page que les navigateurs font confiance. Par défaut : false.
boolean
Ajoute un bouton de paramètres aux lignes whop.site. L’élément se contente de signaler l’appui via onSettingsRequested — la surface d’édition vous revient. Par défaut : false.
boolean
Ajoute un bouton de modification aux lignes whop.site, stylisé comme l’action principale de la ligne. L’élément se contente de signaler l’appui via onEditRequested — la surface d’édition vous revient. Par défaut : false.
string
La ligne à laquelle appartient la vérification en cours — le target de l’événement verifyRequested que vous traitez. Par défaut : "".
string
L’avancement de la vérification en cours, affiché sur le bouton de cette ligne : waiting, connected, not-detected, ou blocked lorsque la popup a été bloquée. Par défaut : "idle".L’une des valeurs "idle", "waiting", "connected", "not-detected" ou "blocked".
string
Un jeton à portée limitée pour les lectures — les statistiques nécessitent stats:read, et la liste des sites whop.site lit les apps (les lignes se limitent au trafic si le jeton ne le permet pas). Générez-le sur votre serveur avec POST /api/v1/access_tokens et définissez-en un nouveau avant son expiration. pixel-setup est le seul enfant auquel il n’est pas transmis — il authentifie ses propres analyses à partir de son propre accessToken — générez donc un seul jeton portant les deux ensembles de scopes et transmettez cette même chaîne aux deux, plutôt qu’un jeton par élément. S’il est omis, les lectures transportent la propre session du visiteur, qui ne répond qu’en same-origin.
string
requis
ID du compte, préfixé par biz_, dont ces surfaces lisent les sites web.
Appearance
Personnalisation visuelle des éléments de ce groupe. Remplace le WhopElements({ appearance }) global. Modifiez-la en direct avec update({ appearance }).
WhopElementsLocale
Langue du texte de l’interface des éléments de ce groupe. Définissez-la sur l’une des langues intégrées à l’application pour remplacer la configuration globale. Toute autre valeur revient à la langue par défaut.
Événements
Transmettez les callbacks dans les options de création ou dans les props React.
onLoadingChange
S’exécute lorsque l’état de chargement groupé change. La valeur est true tant qu’un élément monté est encore en cours de chargement.
boolean
Méthodes
Appelez-les sur le handle Websites obtenu via whop.websites.create({ … }) ou useWebsites().
update
Fusionne de nouvelles options de handle dans chaque élément monté. Avec React, modifiez plutôt les props du namespace.Paramètres
Partial<WebsitesOptions>
requis
destroy
Détruit chaque élément et sous-contrôleur créé par ce handle, supprime le frame du contrôleur et libère ses abonnements. Vous pouvez l’appeler plusieurs fois, mais un handle détruit refuse tout autre appel — créez un nouveau handle pour recommencer. React supprime le groupe automatiquement lorsque le provider est démonté.
Éléments
Les éléments montés par ce groupe. Chacun a sa propre page :
WebsitesElement
Les sites web d’un compte dans un seul tableau : chaque site construit sur whop.site — listé dès sa création, avec des zéros jusqu’à l’arrivée du trafic — fusionné par nom d’hôte avec chaque domaine signalé par le Whop Pixel. Les lignes des sites whop.site portent une marque Whop, de sorte que les deux sources restent distinctes même lorsque les deux ont du trafic. Chaque ligne affiche une tendance des pages vues, les visiteurs uniques, les pages vues, les ventes attribuées, les revenus en USD et le dernier jour où un événement est arrivé. Déplier un domaine charge ses pages les plus consultées, et chaque chiffre de pages vues ouvre le détail des événements qui le composent. Définissez showVerify pour ajouter à chaque ligne un bouton qui demande à la page hébergeant cet élément d’ouvrir le site et de confirmer que le pixel se déclenche ; définissez showSettings pour ajouter aux lignes whop.site un bouton de paramètres qui signale le clic via onSettingsRequested, et showEdit pour ajouter un bouton de modification principal qui le signale via onEditRequested — c’est votre page qui gère l’édition proprement dite.
PixelSetupElement
Installe le Whop Pixel et branche les événements de conversion : copiez le snippet, vérifiez sa présence sur une page, confirmez que les événements se déclenchent. Montez-le inline, ou dans votre propre overlay.
Assistant
Responses are generated using AI and may contain mistakes.