---
type: how-to
title: ウィジェットをホワイトラベルする
summary: ウィジェットシェルの文言、色、リンクをあなた自身のものに置き換えます。ダッシュボードで作る Apex 階層の機能です。
---

[ゲームのカスタマイズ](/docs/game-customization/overview) はウィジェットの中のゲームを変えます。ホワイトラベルは **ウィジェットシェル**、つまりすべてのチャレンジの周りのクロームを変えます。その文言、その色とブランドマーク、そしてそのブランドの帯のリンクです。ダッシュボードで上書きを作り、Caputchin がそれをすべてのウィジェットのマウントに、コード変更もフォークもなしで提供します。

ホワイトラベルは **Apex 階層** の機能です。

## どこにあるか

チーム、またはサイトキーを開き、その **ホワイトラベル** ページ（設定の下）へ行きます。ゲームのカスタマイズと同じエディターを使いますが、特定のゲームではなくウィジェットシェルを対象とするので、ウィジェットが走らせるすべてのチャレンジに適用されます。

## 3 つの軸

ホワイトラベルは、シェルの組み込みのフィールドセットに適用される、ゲームと同じ 3 つの軸を持ちます：

| 軸 | 何を制御するか |
|---|---|
| **言語** | シェルの文字列：verify ラベル、ブランドのワードマーク、状態と close のラベル、アクセシビリティのラベル。 |
| **スキン** | シェルの色と、そのブランドのロゴ。 |
| **構成** | ブランドの帯のリンク先：home リンクと legal リンク。 |

欲しいフィールドだけを上書きします。そのままにするすべては Caputchin の既定を保ちます。

## スコープと既定

ホワイトラベルの上書きは、[ゲームのカスタマイズ](/docs/game-customization/overview#troop-and-site-key-scope) と同じやり方、最も具体的なものが勝つで解決されます。**サイトキー** のプリセットは **チーム** のベースラインに勝ち、それは Caputchin のバンドル済みの既定に勝ち、値ごとに計算されます。チームにベースラインを一度設定し、キーごとに例外を上書きします。各グループ（各言語、ライトとダークのそれぞれ、単一の構成グループ）は 1 つの既定を持ち、それをエディターでマークします。モードが `any` のスキンは、どちらの背景でも働き、ライトとダークの両方のグループの下に現れ、どちらか、または両方の既定として設定できます。バンドル済みのプリセットを拡張し、必要なフィールドだけを変えられます。同じフィールド型とプリセットモデルが両方を動かします。[スキーマリファレンス](/docs/references/customization-schema) を参照してください。

## どう伝播するか

プリセットを保存すると、数秒以内に、影響を受けるすべてのウィジェットのマウントにわたって本番になります。ウィジェットは読み込み時にあなたの上書きを少しだけ待ち、フェッチが遅ければバンドル済みの見た目にフォールバックするので、遅いネットワークが訪問者に空白のウィジェットを見つめさせることは決してありません。

## シェルが出荷される言語

ウィジェットシェル（その中のゲームではなく、すべての検証の周りのクローム）は、英語を既定として、これら 11 言語の組み込み **言語** プリセットとともに出荷されます。[ブラウザの言語](/docs/widget-customization/resolution) がそのどれかである訪問者は、自動でそれでシェルを見ます。ほかの誰もが英語にフォールバックします。これはシェル自身のカバー範囲で、各ゲームの作者が別々に選ぶ、ゲームの言語からは独立しています。

| 言語 | タグ |
|---|---|
| 英語（既定） | `en` |
| 中国語（簡体字） | `zh-Hans` |
| スペイン語 | `es` |
| アラビア語 | `ar` |
| ポルトガル語 | `pt` |
| フランス語 | `fr` |
| ドイツ語 | `de` |
| ロシア語 | `ru` |
| 日本語 | `ja` |
| 韓国語 | `ko` |
| インドネシア語 | `id` |

これらは設定しません。既定でオンです。2 つのことがあなたの代わりに扱われます。右から左の言語（アラビア語）はシェルのレイアウトを自動で `rtl` に反転させ、CJK の言語（中国語、日本語、韓国語）は訪問者のシステムフォントでレンダリングされます。どちらも設定不要です。

これらのどれかの文言を **変える**、または挙がっていない言語を **加える** には、上の言語の軸を使います。その言語タグのプリセットを、ほかのシェルの文字列を上書きするのとちょうど同じように、編集または作成してください。

## あわせて読む

- [ウィジェットが言語とスキンをどう解決するか](/docs/widget-customization/resolution)：訪問者がどの言語とスキンを見るか。
- [CSS でウィジェットをスタイルする](/docs/widget-customization/css-parts)：ホワイトラベルがカバーしないレイアウトと細部を調整する。
- [スキーマリファレンス](/docs/references/customization-schema)：シェルの組み込みフィールドとフィールド型。
- [私たちの哲学](/docs/understanding-caputchin/philosophy)：ホワイトラベルがカスタマイズの梯子のどこにあり、それだけができること。