3ball.app'i Sitende Embed Et — Ücretsiz iframe Entegrasyonu

3ball antrenörünü bilardo kulüp siten, blogun veya öğrenme platformuna embed et. Tek iframe tag'i, tam responsive, API key gerekmez. Kişisel ve ticari kullanım için ücretsiz; atıf takdir edilir ama zorunlu değil.

Temel embed (her HTML)

<iframe
  src="https://3ball.app/?embed=1"
  title="3ball — 3-bant karambol antrenörü"
  width="100%"
  height="600"
  loading="lazy"
  referrerpolicy="no-referrer-when-downgrade"
  allow="fullscreen"
  style="border:0; border-radius:12px; max-width:100%;"></iframe>

Responsive (16:9 wrapper)

<div style="position:relative; padding-bottom:56.25%; height:0; overflow:hidden; border-radius:12px;">
  <iframe
    src="https://3ball.app/?embed=1"
    title="3ball antrenör"
    style="position:absolute; top:0; left:0; width:100%; height:100%; border:0;"
    loading="lazy"
    allow="fullscreen"></iframe>
</div>

WordPress (block editor)

Yazı editöründe Custom HTML blok ekle.
Üstteki temel embed kodunu yapıştır.
Önizle ve yüksekliği ayarla (önerilen: masaüstü 600-800 px).

React komponenti

function ThreeBallEmbed({ height = 600 }) {
  return (
    <iframe
      src="https://3ball.app/?embed=1"
      title="3ball — 3-bant antrenör"
      width="100%"
      height={height}
      loading="lazy"
      style={{ border: 0, borderRadius: 12, maxWidth: "100%" }}
      allow="fullscreen"
    />
  );
}

URL ile önceden yüklü pozisyon

Belirli bir pozisyon embed etmek mi istiyorsun? Preset yüklemek için ?pos=... ekle:

/?embed=1&pos=ticky — Ticky pozisyonu
/?embed=1&pos=umbrella — Şemsiye
/?embed=1&pos=around-the-table — Etrafından
/?embed=1&mode=drill — Drill modunda aç
/?embed=1&mode=solver — AI Çözücü modunda aç

CSP & X-Frame-Options

3ball.app varsayılan olarak X-Frame-Options: SAMEORIGIN ile sunulur — bu header ile dış embed mümkün değil. CSP ile frame-ancestors *'e geçişi değerlendiriyoruz. Şimdilik domain'inle info@setviva.com'a ulaş, allow-list'e ekleyelim.

Atıf (önerilir)

3ball embed edersen, 3ball.app'e geri link takdir edilir:

<p style="font-size:12px; opacity:.7; margin-top:8px;">
  Antrenör: <a href="https://3ball.app/">3ball.app</a> — ücretsiz, MIT-friendly.
</p>

Sınırlamalar

Çok oyunculu embed modunda henüz desteklenmiyor.
Lokalizasyon kullanıcının tarayıcı tercihine saygı gösterir; ?lang=tr vb. ile dili zorla.
Siten katı CSP kullanıyorsa, frame-src https://3ball.app'e izin ver.