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

# Websites

> Bir hesabın web siteleri: whop.site üzerinde oluşturulan her site ile Whop Pixel'in bildirdiği her alan adı, alan adı başına trafik ve atfedilen gelirle birlikte. `websites` bağlayın; bunları ziyaretçiler, sayfa görüntülemeleri, satışlar, gelir, eğilim ve en çok görüntülenen sayfalarla listeler. Yanına `pixel-setup` bağlayın; sihirbazın pikselini canlı olarak doğruladığı bir site otomatik olarak bir bekleme satırı alır, çünkü ilk olaylarının istatistik API'sine ulaşması birkaç dakika sürer ve site aksi hâlde kaybolmuş gibi görünürdü — bunun için hiçbir şey bağlamanız gerekmez ve satır sayfanızda tutulur; böylece satıcı sayfayı yeniden yüklese de orada kalır. İstatistik okumak ayrıcalıklıdır, bu nedenle bir `accessToken` gerektirir — izleyicinin oturumunun okumayı taşıdığı Whop'un kendi uygulaması içinde hariç.

> [!NOTE]
>
> Bu sayfa `@whop/elements@1.10.0` ve `@whop/elements-react@1.10.0` sürümlerini belgeler.

*`v1.0.0` sürümünden beri.*

## Playground

Elementleri örnek verilerle bir araya getirin. Kontrolleri kullanın, elementler ekleyip düzenleyin ve olayların canlı olarak tetiklenmesini izleyin:

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

## Seçenekler

Bunları `whop.websites.create({ … })` çağrısına veya React'te `<Websites>` üzerinde prop olarak iletin.

**windowDays** `number`

Tablonun kapsadığı trafik gün sayısı, 1 ile 90 arasında. @default 30 Varsayılan değer `30`.

**includeApps** `boolean`

whop.site üzerinde oluşturulan web sitelerini var oldukları andan itibaren listeler; trafik gelene kadar sıfırlarla. Yalnızca pikselin bildirdiği alan adlarını göstermek için kapatın. @default true Varsayılan değer `true`.

**pendingWebsites** `PendingWebsite[]`

Az önce eklediğiniz ve henüz canlı olmayan web siteleri — `{ domain, kind }`; burada `kind`, ilk dağıtımını bekleyen whop.site üzerindeki bir site için `deploy`, ilk piksel olaylarını bekleyen bir site için `events` değeridir. Bekleme satırları olarak gösterilirler; böylece bir site kurulumdan hemen sonra asla kaybolmuş gibi görünmez ve herhangi biri beklemedeyken tablo yoklama yapar. Bağlı `pixel-setup` sihirbazının canlı olarak doğruladığı siteler sizin için eklenir, yeniden yüklemede korunur ve sizin işiniz DEĞİLDİR — bu, tanıtıcının kendisinin göremediği beklemeler içindir; her şeyden önce de buradaki hiçbir elementin bildirmediği, az önce oluşturduğunuz whop.site üzerindeki bir site için. Eklediğiniz girdileri kaldırmak size aittir: alan adı tabloya ulaştığında satır çizilmeyi bırakır, ancak listenin kendisi yalnızca siz değiştirdiğinizde değişir; bu nedenle `websitesLoaded` alan adını bildirdiğinde girdiyi kaldırın ve geri kalanlara kendi zaman aşımınızı verin. Varsayılan değer `[]`.

**özellikler**

**domain** `string` *required*

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

**showVerify** `boolean`

Her satıra bir piksel kontrol düğmesi ekler. Element basışı yalnızca `onVerifyRequested` aracılığıyla bildirir — siteyi açmak ve sonuca karar vermek size aittir, çünkü tarayıcıların güvendiği açılır pencere kendi sayfanızın açtığıdır. Varsayılan değer `false`.

**showSettings** `boolean`

whop.site satırlarına bir ayarlar düğmesi ekler. Element basışı yalnızca `onSettingsRequested` aracılığıyla bildirir — düzenleme yüzeyi size aittir. Varsayılan değer `false`.

**showEdit** `boolean`

whop.site satırlarına satırın birincil eylemi olarak stillendirilmiş bir düzenleme düğmesi ekler. Element basışı yalnızca `onEditRequested` aracılığıyla bildirir — düzenleme yüzeyi size aittir. Varsayılan değer `false`.

**verifyTarget** `string`

Devam eden kontrolün hangi satıra ait olduğu — işlediğiniz `verifyRequested` olayındaki `target`. Varsayılan değer `""`.

**verifyStatus** `string`

Devam eden kontrolün nasıl gittiği, o satırın düğmesinde gösterilir: `waiting`, `connected`, `not-detected` veya açılır pencere engellendiğinde `blocked`. Varsayılan değer `"idle"`.

`"idle"`, `"waiting"`, `"connected"`, `"not-detected"` veya `"blocked"` değerlerinden biri.

**accessToken** `string`

Okumalar için kapsamlı bir token — istatistikler `stats:read` gerektirir ve whop.site web sitesi listesi uygulamaları okur (token bunu yapamazsa satırlar yalnızca trafiğe düşer). Onu sunucunuzda `POST /api/v1/access_tokens` ile oluşturun ve süresi dolmadan önce yenisini ayarlayın. `pixel-setup` bunun aktarılmadığı tek alt öğedir — kendi taramalarını kendi `accessToken` değeriyle doğrular — bu nedenle element başına bir token yerine her iki kapsam kümesini taşıyan tek bir token oluşturun ve aynı dizeyi ikisine de iletin. Atlanırsa okumalar izleyicinin kendi oturumunu taşır; bu da yalnızca aynı origin'de yanıt verir.

**accountId** `string` *required*

Bu yüzeylerin web sitelerini okuduğu, `biz_` önekli hesap kimliği.

**appearance** `Appearance`

Bu grubun elementleri için görsel özelleştirme. Genel `WhopElements({ appearance })` ayarını geçersiz kılar. `update({ appearance })` ile canlı olarak değiştirin.

**locale** `WhopElementsLocale`

Bu grubun element arayüz metni için yerel ayar. Genel yapılandırmayı geçersiz kılmak için uygulamanın derlenmiş yerel ayarlarından birine ayarlayın. Diğer her değer varsayılan yerel ayara geri döner.

## Olaylar

Geri çağırmaları oluşturma seçeneklerinde veya React prop'larında iletin.

### `onLoadingChange`

Gruplanmış yükleme durumu değiştiğinde çalışır. Bağlı herhangi bir element hâlâ yükleniyorken değer `true` olur.

**loading** `boolean`

## Metotlar

Bunları `whop.websites.create({ … })` veya `useWebsites()` tarafından döndürülen Websites tanıtıcısı üzerinde çağırın.

### `update`

Yeni tanıtıcı seçeneklerini bağlı her elementle birleştirir. React'te bunun yerine namespace prop'larını değiştirin.

**Parametreler**

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

### `destroy`

Bu tanıtıcının oluşturduğu her elementi ve alt denetleyiciyi yok eder, denetleyici çerçevesini kaldırır ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz, ancak yok edilmiş bir tanıtıcı diğer her çağrıyı reddeder — baştan başlamak için yeni bir tanıtıcı oluşturun. Sağlayıcı kaldırıldığında React grubu otomatik olarak kaldırır.

## Elementler

Bu grubun bağladığı elementler. Her birinin kendi sayfası vardır:

> [card] [WebsitesElement](https://docs.whop.com/tr/elements/latest/websites/websites.md)
>
> Bir hesabın web siteleri tek bir tabloda: whop.site üzerinde oluşturulan her site — var olduğu andan itibaren listelenir, trafik gelene kadar sıfırlarla — Whop Pixel'in bildirdiği her alan adıyla ana bilgisayar adına göre birleştirilir. whop.site satırları bir Whop işareti taşır; böylece iki kaynak ikisinin de trafiği olduğunda bile ayrı kalır. Her satır bir sayfa görüntüleme eğilimi, benzersiz ziyaretçiler, sayfa görüntülemeleri, atfedilen satışlar, USD gelir ve bir olayın geldiği son günü gösterir. Bir alan adını genişletmek en çok görüntülenen sayfalarını yükler ve her sayfa görüntüleme rakamı onu hangi olayların oluşturduğunun dökümünü açar. Bu elementi barındıran sayfadan siteyi açmasını ve pikselin tetiklendiğini doğrulamasını isteyen satır başına bir düğme eklemek için `showVerify` ayarlayın; tıklamayı `onSettingsRequested` aracılığıyla bildiren whop.site satırlarına bir ayarlar düğmesi eklemek için `showSettings`, `onEditRequested` aracılığıyla bildiren birincil bir düzenleme düğmesi eklemek için `showEdit` ayarlayın — asıl düzenleme sayfanıza aittir.

> [card] [PixelSetupElement](https://docs.whop.com/tr/elements/latest/websites/pixel-setup.md)
>
> Whop Pixel'i yükler ve dönüşüm olaylarını bağlar: snippet'i kopyalayın, bir sayfada olup olmadığını kontrol edin, olayların tetiklendiğini doğrulayın. Satır içinde veya kendi katmanınızın içinde bağlayın.
