← Dokümanlar

Drupal

Tuvelia grafiğini ya da haritasını bir Drupal sitesine gömmek: Full HTML biçiminde kodu yapıştırmak (önerilen) ya da oEmbed Providers modülüyle medya olarak eklemek. Drupal 10 ve 11'de denendi.

Son doğrulama: 2026-09-24 · 14 gün önce

Tuvelia'nın bir Drupal modülü yok; gerekmiyor da. Yayındaki bir grafiği ya da
haritayı Drupal sitesine iki yoldan koyabilirsin. İkisi de Drupal 10.6 ve
Drupal 11.4 test kurulumlarında denendi (SQLite, varsayılan tema, CKEditor 5).

YolEtkileşim (ipucu, zaman imleci)Telefonda kutuGereken
Gömme kodunu yapıştırmakçalışıriçeriğe göre uzar"Full HTML" metin biçimi
Medya (oEmbed)çalışırsabit yükseklikte kalır, altta boşluk olabiliroEmbed Providers modülü

Önerilen yol: gömme kodunu yapıştırmak

  1. Tuvelia'da grafiği ya da haritayı yayınla ve Paylaş › Bağlantı ve embed
    bölümünden İnteraktif kodu kopyala (bir iframe ve küçük bir betik).
  2. Drupal'da içeriği düzenle; gövde alanının altındaki "Text format" seçiminde
    Full HTML'i seç.
  3. Editörün araç çubuğunda "Source" düğmesine bas (gerekirse "Show more items"
    altında), kodu yapıştır ve kaydet.

Sayfada canlı gömme çıkar: ipucu kutuları ve zaman imleci çalışır, kutu
telefonda içeriğe göre uzar (denendi: 375 px genişlikte harita 339 × 339,
sayfada yatay kayma yok). Editör kodu biraz yeniden biçimlendirir (iframe'i bir
paragrafın içine alır, stil yazımını sadeleştirir); bu gömmeyi etkilemez.

⚠ "Basic HTML" ve "Restricted HTML" kodu tamamen siler — hata vermeden,
sayfada hiçbir şey görünmez. Kodu yalnız iframe ve script etiketlerine izin
veren bir biçimde (Drupal'da bu genellikle Full HTML'dir) yapıştır. Full HTML'i
kimin kullanabileceği sitenin güvenlik kararıdır; o biçim genellikle yalnız
güvenilir editörlere açıktır.

Site katı bir içerik güvenlik politikası (CSP) uyguluyorsa frame-src'e ve
script-src'e https://tuvelia.com eklenmelidir; betik engellenirse gömme yine
çalışır ama kutu sabit oranda kalır.

Medya olarak: oEmbed Providers modülü

Bağlantıyı yapıştırarak ekleme yolu. Drupal çekirdeği bilinen sağlayıcıları
oembed.com listesinden okur; Tuvelia 24 Eylül 2026'dan beri o listede.

  1. Katkı modülünü kur: composer require drupal/oembed_providers (denenen sürüm
    3.x), ardından Media, Media Library ve oEmbed Providers
    modüllerini aç.
  2. Bir "provider bucket" oluştur ve sağlayıcı listesinden Tuvelia'yı seç.
    Listede göremiyorsan (Drupal listeyi bir süre önbellekte tutar) oEmbed
    Providers ayarlarında Tuvelia'yı özel sağlayıcı olarak elle ekle:
    • ad: Tuvelia · sağlayıcı adresi: https://tuvelia.com
    • uç nokta: https://tuvelia.com/oembed · biçim: JSON
    • şemalar: https://tuvelia.com/embed/* ve https://www.tuvelia.com/embed/*
  3. ⚠ Bucket'ın makine adı
    kısa olsun (en çok 13 karakter, ör. tuvelia): medya alanının adı
    field_media_oembed_ + bu addan oluşur ve Drupal alan adlarını 32 karakterle
    sınırlar (denendi: Drupal 11 fazlasını sessizce kırptı, Drupal 10 hata verdi).
  4. Kaynağı bu bucket olan bir medya türü oluştur (ör. "Tuvelia").
  5. Medya eklerken Tuvelia bağlantısını yapıştır (https://tuvelia.com/embed/…);
    ad, grafiğin başlığından kendiliğinden dolar. İçeriğe metin editörünün medya
    gömme düğmesiyle ya da bir medya alanıyla koyarsın.

⚠ Telefonda altta boşluk. Drupal oEmbed içeriğini kendi sayfasından gelen
bir iframe'in içinde, Tuvelia'nın bildirdiği ölçüde (ör. 800 × 572) gösterir
ve o kutuyu sonradan uzatıp kısaltmaz. Geniş ekranda sorun yoktur; dar ekranda
Tuvelia'nın içeriği küçülür ama Drupal'ın kutusu aynı yükseklikte kalır
(denendi: 375 px'te harita 335 px, kutu 572 px). Telefonda okunacak sayfalarda
ilk yol daha iyidir.

Varsayılan medya görünümü tarih ve yazar gibi alanları da gösterebilir; medya
türünün görünüm ayarlarından kapatılır.

Hikâyeler

Hikâyeler kendi sayfalarında yayınlanır ve başka bir sayfaya gömülmez; Drupal
içeriğinden hikâyenin adresine bağlantı ver.