Kur / Ayarlar Sayfası

settingsPageId, kurulum sonrası ve eklenti ayarlarında tenant'a açılacak Custom UI sayfasını işaret eder. Onboarding (ör. API anahtarı, tercih) ve sonradan yapılandırma için tek giriş noktasıdır.

Nasıl çalışır

Tenant eklentiyi kurar / "Ayarlar"a tıklar
   │
   ▼
Panel, settingsPageId ile eşleşen pages[] sayfasını iframe'de açar
   │   (App Bridge + session token → tenant kimliği)
   ▼
Senin ayar/onboarding ekranın  ──►  ayarları kendi backend'inde sakla

settingsPageId mevcut bir Custom UI sayfasının id'sine işaret etmelidir. Ayrı bir mekanizma değildir — sıradan bir Custom UI sayfasını “ayarlar girişi” olarak işaretler.

Manifest şeması

Alan	Tip	Zorunlu	Açıklama
settingsPageId	string	–	Mevcut bir `pages[].id`'si. Boşsa eklentinin ayar girişi olmaz.

"pages": [
  { "id": "setup", "customUiOrigin": "https://app.eklentim.com", "path": "/setup" }
],
"settingsPageId": "setup"   // tenant kurulum/ayarlarda bu sayfa açılır

Adımlar

Bir Custom UI sayfası ekle (ui:page scope).
Editörde “Kur / Ayarlar Sayfası” alanından o sayfayı seç → settingsPageId yazılır.
Sayfa içinde session token ile tenant'ı doğrula ve ayarları yükle/kaydet.

Onboarding'i burada topla: tenant kurulumdan hemen sonra bu sayfaya yönlenir, böylece eklenti ilk kullanımdan önce yapılandırılır.