> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Sites web

> 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.

> [!NOTE]
>
> 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 :

```tsx React theme={null}
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>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const websites = window.WhopElements().websites.create({ /* options */ });
</script>
```

## Options

Transmettez-les à `whop.websites.create({ … })`, ou comme props sur `<Websites>` avec React.

**windowDays** `number`

Le nombre de jours de trafic couverts par le tableau, de 1 à 90. @default 30 Par défaut : `30`.

**includeApps** `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`.

**pendingWebsites** `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 : `[]`.

**propriétés**

**domain** `string` *required*

**kind** `"events" | "deploy"` *required*

**showVerify** `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`.

**showSettings** `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`.

**showEdit** `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`.

**verifyTarget** `string`

La ligne à laquelle appartient la vérification en cours — le `target` de l'événement `verifyRequested` que vous traitez. Par défaut : `""`.

**verifyStatus** `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"`.

**accessToken** `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.

**accountId** `string` *required*

ID du compte, préfixé par `biz_`, dont ces surfaces lisent les sites web.

**appearance** `Appearance`

Personnalisation visuelle des éléments de ce groupe. Remplace le `WhopElements({ appearance })` global. Modifiez-la en direct avec `update({ appearance })`.

**locale** `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.

**loading** `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**

**options** `Partial\<WebsitesOptions\>` *required*

### `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 :

> [card] [WebsitesElement](https://docs.whop.com/fr/elements/latest/websites/websites.md)
>
> 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.

> [card] [PixelSetupElement](https://docs.whop.com/fr/elements/latest/websites/pixel-setup.md)
>
> 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.


## Related topics

- [Présentation de l'API Whop](https://docs.whop.com/fr/api-reference/overview.md)
- [Héberger un site web sur Whop](https://docs.whop.com/fr/developer/websites/overview.md)
- [Hébergement de sites web sur Whop](https://docs.whop.com/fr/developer/websites/hosting.md)
