WordPress’te Tweet Nasıl Gömülür: Her Yöntem Açıklandı

WordPress’e tweet gömmek, özel JavaScript yazmadan canlı, etkileşimli bir Twitter gönderisini doğrudan sayfa içeriğinizde işlemek anlamına gelir; orijinal biçimlendirme, medya, yazar atıfı ve etkileşim düğmeleri korunur. WordPress bunu, sayfa tarayıcıya iletilmeden önce Twitter URL’lerini sunucu tarafında tam gömme işaretlemesine otomatik olarak çeviren oEmbed protokolü uygulaması aracılığıyla yerel olarak gerçekleştirir.

Bu kılavuz, desteklenen her gömme yöntemini teknik derinlikte ele almaktadır: Gutenberg blok düzenleyici, Klasik Düzenleyici, ham oEmbed URL çözümlemesi, Twitter’ın widget.js tabanlı zaman çizelgesi gömmesi ve eklenti tabanlı yaklaşımlar; her yöntemin nerede başarısız olduğu, Twitter API politika değişikliklerinin 2024’teki gömmeleriniz için ne anlama geldiği ve harici hizmet kullanılamadığında gömülü içeriğin doğru şekilde işlenmeye devam etmesi dahil.

Tweet Gömmenin Çalışma Prensibi: oEmbed Protokolü

Bireysel yöntemleri incelemeden önce, temel mekanizmayı anlamak saatlerce sürebilecek hata ayıklamanın önüne geçer.

oEmbed, desteklenen bir sağlayıcıdan gelen bir URL’nin bir keşif uç noktası sorgulanarak zengin gömme işaretlemesine çözümlenmesine olanak tanıyan açık bir standarttır (oembed.com’da tanımlanmıştır). WordPress, sürüm 2.9’dan bu yana yerleşik bir oEmbed tüketicisiyle birlikte gelmektedir. Düzenleyiciye bir Twitter URL’si yapıştırdığınızda, WordPress Twitter’ın oEmbed uç noktasını çağırır:

https://publish.twitter.com/oembed?url=<tweet_url>

Twitter’ın sunucusu, bir html alanı içeren bir JSON yükü döndürür; bu alan, <blockquote> öğesi ile widgets.js yükleyen bir <script> etiketinden oluşur. WordPress, her sayfa yüklemesinde gereksiz API çağrılarını önlemek için bu yanıtı wp_oembed post meta tablosunda önbelleğe alır.

Kritik sonuç: Twitter’ın oEmbed uç noktasına erişilemiyorsa, hız sınırına ulaşılmışsa veya hata döndürüyorsa, WordPress düz bir köprü bağlantısı görüntülemeye geri döner. Bu bir WordPress hatası değildir; beklenen oEmbed geri dönüş davranışıdır. Önbelleğe alınmış gömmeler, önbellek geçersiz kılınana kadar işlenmeye devam eder (varsayılan TTL: 24 saat, oembed_ttl filtresiyle kontrol edilir).

Yöntem 1: Gutenberg Blok Düzenleyici (Önerilen)

Blok düzenleyici, URL’yi doğruladığı ve yayımlamadan önce düzenleyici tuvalinde canlı bir önizleme oluşturduğu için en güvenilir gömme yolunu sunar.

Adım 1: Tweet URL’sini Kopyalayın

Twitter’da (X), tweet’e gidin. Tweet kartının sağ üst köşesindeki üç noktalı menüye tıklayın ve Gönderiye bağlantıyı kopyala‘yı seçin. URL biçimi şöyledir:

https://twitter.com/<username>/status/<tweet_id>

veya daha yeni x.com varyantı:

https://x.com/<username>/status/<tweet_id>

Her iki URL biçimi de WordPress’in oEmbed işleyicisi aracılığıyla doğru şekilde çözümlenir. Kısaltılmış t.co URL’leri kullanmayın; bunlar, bazı sunucu ortamlarında sessizce başarısız olabilen ek bir yönlendirme çözümleme adımı gerektirir.

Adım 2: Gömme Bloğunu Ekleyin

WordPress blok düzenleyicide + ekleyicisine tıklayın ve Twitter veya Gömme arayın. Twitter bloğunu seçin (Gömmeler kategorisinde listelenir). Satır içinde bir URL giriş alanı görünür.

Alternatif olarak, tweet URL’sini doğrudan boş bir paragraf bloğuna yapıştırın. Gutenberg, Twitter URL kalıbını algılayacak ve bloğu otomatik olarak bir gömmeye dönüştürmenizi isteyecektir; araç ipucu göründüğünde Göm‘e tıklayın.

Adım 3: URL’yi Yapıştırın ve Onaylayın

Tweet URL’sini bloğun URL alanına yapıştırın ve Enter‘a basın veya Göm‘e tıklayın. Gutenberg, oEmbed uç noktasını sorgular ve canlı bir önizleme oluşturur. Önizlemede “Üzgünüz, bu içerik gömlemiyor” mesajı görünüyorsa, tweet ya korumalı bir hesaba aittir, silinmiştir ya da Twitter’ın uç noktası hata döndürmüştür. URL’nin geçersiz olduğunu varsaymadan önce düzenleyiciyi yenileyin ve yeniden deneyin.

Önizleme doğru şekilde oluşturulduktan sonra gönderiyi yayımlayın veya güncelleyin.

Yöntem 2: Klasik Düzenleyici

Klasik Düzenleyici aynı oEmbed ardışık düzenini kullanır, ancak otomatik gömmeyi tetiklemek için URL’nin doğru şekilde yerleştirilmesi gerekir.

Otomatik Gömme Tetikleme Kuralları

WordPress’in WP_Embed sınıfı, gönderi içeriğini, boşluk veya paragraf sonlarıyla çevrelenmiş, çevresinde bağlantı etiketi veya HTML özniteliği bulunmayan, kendi satırında görünen URL’ler için tarar. URL’yi bir köprü bağlantısına (<a href="...">) sararsanız veya bir cümle içinde satır içine yerleştirirseniz, otomatik gömme bastırılır ve URL düz metin olarak işlenir.

Klasik Düzenleyicinin Görsel sekmesinde, tweet URL’sini yeni, boş bir satıra yapıştırın. Aynı satıra herhangi bir çevreleyen metin eklemeyin.

Metin (HTML) sekmesinde, URL şu şekilde kendi başına <p> etiketleri arasında görünmelidir:

<p>https://twitter.com/username/status/1234567890123456789</p>

Güncelle veya Yayımla‘ya tıklayın. Ön yüz, gömülü tweet’i işleyecektir; Klasik Düzenleyicinin Görsel sekmesi canlı önizlemeyi göstermeyebilir, bu beklenen bir davranıştır.

Yöntem 3: Doğrudan oEmbed URL’si (Programatik Gömme)

Özel sayfa şablonları oluşturan veya içeriği programatik olarak dolduran geliştiriciler için WordPress, wp_oembed_get() işlevini ve </code> kısa kodunu sunar.</p>
<h3><code>wp_oembed_get()</code> Kullanımı</h3>
<pre class="ppt-code-block"><code class="language-php"><?php
$tweet_url = 'https://twitter.com/WordPress/status/1234567890123456789';
$embed_html = wp_oembed_get( $tweet_url, array( 'width' => 550 ) );
if ( $embed_html ) {
echo $embed_html;
} else {
echo '<a href="' . esc_url( $tweet_url ) . '">View tweet</a>';
}
?></code></pre>
<p><code>else</code> dalı, üretim kodunda zorunludur. <code>wp_oembed_get()</code> başarısızlık durumunda <code>false</code> döndürür; geri dönüş olmadan hiçbir şey işlememek, hem kullanıcıları hem de tarayıcıları şaşırtan görünmez içerik boşlukları oluşturur.</p>
<h3><code></code> Kısa Kodunu Kullanma</h3>
<pre class="ppt-code-block"><code>https://twitter.com/username/status/1234567890123456789

Bu kısa kod, WP_Embed::shortcode() tarafından işlenir ve otomatik gömme ardışık düzeniyle aynı önbellekleme ve geri dönüş mantığını izler.

Yöntem 4: Twitter Zaman Çizelgesi veya Profil Widget’ı Gömme

Tek tweet oEmbed, zaman çizelgeleri için geçerli değildir. Tam bir profil zaman çizelgesi, liste zaman çizelgesi veya hashtag koleksiyonu, Twitter’ın yayımlama aracı aracılığıyla oluşturulan Twitter’ın Gömülü Zaman Çizelgeleri widget’ını gerektirir.

Adım 1: Widget Kodunu Oluşturun

publish.twitter.com adresine gidin. Giriş alanına aşağıdaki URL biçimlerinden birini girin:

Gömülü Zaman Çizelgesi‘ni seçin, ardından genişlik, yükseklik, tema (açık/koyu) ve dili yapılandırmak için Özelleştirme seçeneklerini ayarla‘ya tıklayın. Kodu Kopyala‘ya tıklayın.

Oluşturulan kod şu şekilde görünür:

<a class="twitter-timeline"
   data-width="600"
   data-height="800"
   data-theme="dark"
   href="https://twitter.com/username">
  Tweets by username
</a>
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

Adım 2: Kodu WordPress’e Ekleyin

Gutenberg‘de, istenen konuma bir Özel HTML bloğu ekleyin ve gömme kodunu doğrudan yapıştırın.

Klasik Düzenleyici‘de, Metin sekmesine geçin (Görsel değil) ve kodu imleç konumuna yapıştırın. Görsel sekmesine yapıştırırsanız, düzenleyicinin HTML temizleyicisi <script> etiketini kaldırabilir ve widget’ı tamamen bozabilir.

Önemli: widgets.js komut dosyası etiketinin sayfa başına yalnızca bir kez görünmesi gerekir. Aynı sayfaya birden fazla Twitter widget’ı gömüyorsanız, <script> etiketini yalnızca ilk widget’a ekleyin ve gereksiz komut dosyası yüklemesini ve olası işleme yarış koşullarını önlemek için sonraki widget’lardan çıkarın.

Yöntem Karşılaştırması

Twitter API Değişiklikleri ve WordPress Gömmelerine Etkisi

Twitter’ın X platformuna geçişi ve 2023’te API erişim katmanlarının yeniden yapılandırılmasından bu yana, WordPress gömmelerini doğrudan etkileyen çeşitli davranışlar değişmiştir:

oEmbed uç noktası kullanılabilirliği: publish.twitter.com/oembed uç noktası, tek tweet gömmeler için kimlik doğrulaması olmadan herkese açık olmaya devam etmektedir. Ancak hız sınırlaması daha agresif hale gelmiştir. oEmbed önbelleğini sık sık geçersiz kılan yüksek trafikli siteler (örneğin, her dağıtımda WordPress nesne önbelleğini temizleyerek) HTTP 429 yanıtlarıyla karşılaşabilir ve bu durum gömmelerinin düz bağlantılara geri dönmesine neden olabilir.

widgets.js yükleme performansı: platform.twitter.com/widgets.js betiği eşzamansız olarak yüklenir, ancak yine de üçüncü taraf bir işleme engelleme bağımlılığı oluşturur. Core Web Vitals optimizasyonu için, viewport’a girinceye kadar yüklemeyi ertelemek amacıyla defer özniteliğiyle yüklemeyi veya bir cephe deseni kullanmayı düşünün (yalnızca kullanıcı etkileşiminde gerçek widget’ı yükleyen statik bir ekran görüntüsü yer tutucusu).

Korumalı ve silinen tweetler: Bir tweet silindiğinde veya hesap korumalı olarak ayarlandığında, oEmbed uç noktası 404 döndürür. WordPress bu 404 yanıtını önbelleğe alır; bu, tweet daha sonra geri yüklense bile gömmenin otomatik olarak kurtarılmayacağı anlamına gelir. İlgili _oembed_* post meta girişlerini veritabanından silerek veya Oembed Reset gibi bir eklenti kullanarak gönderinin oEmbed önbelleğini manuel olarak temizlemeniz gerekir.

X.com URL uyumluluğu: WordPress’in oEmbed sağlayıcı listesi, WordPress 6.4’te twitter.com URL’lerine ek olarak x.com URL’lerini tanıyacak şekilde güncellendi. Daha eski bir WordPress sürümü çalıştırıyorsanız, x.com URL’leri otomatik olarak gömülmeyecektir; bunun yerine twitter.com URL biçimini kullanın.

Eklenti Tabanlı Gömme: Ne Zaman Kullanılmalı

Yerel oEmbed çoğu kullanım durumu için yeterlidir. Şu durumlarda özel bir eklenti kullanmayı düşünün:

• Twitter’ın uç noktası kullanılamadığında geri dönüş işleme (eklentiler statik bir ekran görüntüsünü önbelleğe alabilir)
• Tweet kürasyon — canlı bir zaman çizelgesi widget’ına güvenmeden kimliğe göre seçilmiş bir tweet kümesi görüntüleme
• GDPR uyumlu geç yükleme — kullanıcı üçüncü taraf içeriğe açıkça onay verene kadar widgets.js isteğini erteleme
• Twitter’ın varsayılan kart görünümünü geçersiz kılan özel stil

Popüler seçenekler arasında Smash Balloon Twitter Feed (yerel önbellekleme ile zaman çizelgesi kürasyon için) ve Embed Social (çok platformlu sosyal akışlar için) bulunmaktadır. Her ikisi de oEmbed ardışık düzenini tamamen atlar ve kendi API entegrasyonlarını kullanır.

Performans ve SEO Değerlendirmeleri

Twitter widget’larını geç yükleyin: widgets.js betiği, sayfa yüküne yaklaşık 150–200 KB ekler ve birkaç ek ağ isteği tetikler. Widget viewport’a girinceye kadar yüklemeyi ertelemek için Intersection Observer API’sini veya bir onay yönetim platformunu kullanın.

Yapılandırılmış veri: Gömülü tweetler otomatik olarak Schema.org işaretlemesi oluşturmaz. Tweet, alıntıladığınız bir alıntı veya olgusal bir iddia içeriyorsa, anlamsal netlik için gömmenin etrafına <blockquote> ile itemscope ve itemtype="https://schema.org/Quotation" ekleyin.

Erişilebilirlik: Twitter’ın gömülü widget’ı ARIA rolleri içerir, ancak iframe başlığı varsayılan olarak genel bir dizeye ayarlanır. Daha iyi ekran okuyucu uyumluluğu için zaman çizelgesi gömme kodundaki <a> etiketinde data-aria-label özniteliğini kullanarak bunu geçersiz kılın.

İçerik Güvenlik Politikası (CSP): WordPress kurulumunuz katı bir CSP başlığı uyguluyorsa, script-src ve frame-src yönergelerinizde platform.twitter.com ve cdn.syndication.twimg.com adreslerini beyaz listeye eklemeniz gerekir. Bunu yapmamak, WordPress yönetici panelinde herhangi bir görünür hata olmaksızın widget’ı sessizce engeller.

WordPress siteniz sunucu düzeyindeki başlıkları kontrol ettiğiniz bir VPS Hosting ortamında çalışıyorsa, CSP yönergelerini bir eklentiye güvenmek yerine doğrudan Nginx veya Apache yapılandırmanıza ekleyebilirsiniz. Bu, sayfalarınızda komut dosyası çalıştırmasına izin verilen üçüncü taraf kaynaklar üzerinde hassas kontrol sağlar.

cPanel ile VPS kullanan siteler için CSP başlıkları, ModSecurity kuralları düzenleyicisi aracılığıyla veya etki alanının public_html dizinindeki .htaccess dosyasına Header set Content-Security-Policy yönergeleri eklenerek yapılandırılabilir.

oEmbed Önbelleğini Temizleme

Bir tweet gömme işlemi doğru şekilde işlenmeyi bıraktığında, en yaygın neden eski veya hata önbelleğe alınmış bir oEmbed yanıtıdır. WordPress, oEmbed verilerini _oembed_ önekiyle post meta olarak depolar. Belirli bir gönderi için önbelleği temizlemek üzere:

DELETE FROM wp_postmeta
WHERE post_id = <your_post_id>
AND meta_key LIKE '_oembed_%';

Bu sorguyu phpMyAdmin, WP-CLI veya veritabanı yönetim aracınız aracılığıyla çalıştırın. Temizledikten sonra, bir sonraki sayfa yüklemesi oEmbed verilerini Twitter’ın uç noktasından yeniden alacaktır.

WP-CLI kullanarak belirli bir gönderiyi daha güvenli bir şekilde hedefleyebilirsiniz:

wp post meta delete <post_id> --all --match="_oembed_*"

Veya tüm oEmbed önbelleklerini site genelinde temizleyin (büyük sitelerde dikkatli kullanın):

wp eval 'global $wpdb; $wpdb->query("DELETE FROM {$wpdb->postmeta} WHERE meta_key LIKE "_oembed_%"");'

WordPress’i Dedicated Servers üzerinde çalıştıran ekipler için, bu WP-CLI komutunu her dağıtımdan sonra bir cron görevi olarak zamanlamak, eski gömme önbelleklerinin içerik güncellemeleri arasında kalıcı olmamasını sağlar.

Hosting Ortamı Değerlendirmeleri

Tweet gömmelerinin güvenilirliği, sunucunuzun publish.twitter.com adresine giden HTTP istekleri yapabilmesiyle doğrudan bağlantılıdır. Çeşitli hosting yapılandırmaları bu istekleri sessizce engelleyebilir:

• Giden bağlantıları standart dışı portlarla veya belirli IP aralıklarıyla kısıtlayan Güvenlik duvarı kuralları
• Harici URL’lerle curl_exec() veya file_get_contents() kullanan disable_functions PHP yönergeleri
• WordPress’in HTTP API’sinin akış sarmalayıcı geri dönüşünü kullanmasını engelleyen php.ini içindeki allow_url_fopen = Off
• Agresif giden istek kısıtlamasına sahip Paylaşımlı hosting ortamları

Paylaşımlı Web Hosting planlarında, oEmbed sürekli başarısız oluyorsa, PHP yapılandırmanızda allow_url_fopen özelliğinin etkin olduğunu ve cURL’nin kullanılabilir olduğunu doğrulayın. Her ikisini de WordPress yönetici panelinde Araçlar > Site Sağlığı > Bilgi > Sunucu bölümünden kontrol edebilirsiniz.

Siteniz aynı zamanda gömülü tweetlere başvuran işlemsel e-posta veya bülten içeriği işliyorsa, yüksek trafikli dönemlerde kaynak çekişmesini önlemek için E-posta Hosting ortamınızın web sunucunuzdan ayrı olarak yapılandırıldığından emin olun.

SSL ve Karma İçerik

WordPress siteniz HTTPS üzerinden çalışıyorsa (modern herhangi bir dağıtım için zorunludur), gömülü tweet iframe’lerinin de HTTPS üzerinden yüklenmesi gerekir. Twitter’ın oEmbed uç noktası ve widgets.js yalnızca HTTPS üzerinden sunulur, bu nedenle standart gömmelerle bu genellikle bir sorun değildir.

Ancak, gömme HTML’sini manuel olarak oluşturuyorsanız veya http:// URL’lerine başvuran eski bir önbelleğe alınmış gömme kullanıyorsanız, tarayıcılar iframe’i karma içerik olarak engelleyecektir. Gönderi içeriğinizi http://platform.twitter.com referansları için denetleyin ve bunları https:// ile değiştirin. Düzgün yapılandırılmış SSL Sertifikaları olan siteler için, bu karma içerik senaryosu, gömmeler WordPress yönetici panelinde doğru görünürken üretimde boş kutular olarak işlenmesinin en yaygın nedenidir (yanlış yapılandırılmış kurulumlarda HTTP üzerinden erişilebilir).

Teknik Karar Kontrol Listesi

Belirli senaryonuz için doğru gömme yaklaşımını seçmek üzere bu matrisi kullanın:

• Tek tweet, Gutenberg düzenleyici, özel kod yok: Twitter Gömme bloğunu kullanın — URL’yi yapıştırın, önizlemeyi onaylayın, yayımlayın.
• Tek tweet, Klasik Düzenleyici: twitter.com/status/ URL’sini Görsel sekmesinde kendi satırına yapıştırın; Metin sekmesinde bir bağlantı etiketine sarılmadığını doğrulayın.
• Tek tweet, PHP şablonu veya özel gönderi türü: false dönüş değerleri için açık bir geri dönüşle wp_oembed_get() kullanın.
• Profil zaman çizelgesi veya hashtag akışı: publish.twitter.com adresinden widget kodu oluşturun, Gutenberg’de Özel HTML bloğu veya Klasik Düzenleyicide Metin sekmesi aracılığıyla ekleyin.
• Sık önbellek temizleme işlemi olan yüksek trafikli site: oEmbed API çağrı sıklığını azaltmak ve hız sınırlamasından kaçınmak için kalıcı nesne önbelleklemesi (Redis veya Memcached) uygulayın.
• GDPR’ye duyarlı kitle: Onay kapılı widget yüklemesi olan bir eklenti kullanın; açık kullanıcı onayı kaydedilene kadar widgets.js yüklemeyin.
• Tweet silinmesinin ardından gömme işlemi durdu: Etkilenen gönderi için _oembed_* post meta’sını temizleyin ve statik bir ekran görüntüsüyle değiştirin veya gömmeyi kaldırın.
• CSP başlığı widget’ları engelliyor: Sunucu düzeyinde script-src ve frame-src yönergelerinde platform.twitter.com ve cdn.syndication.twimg.com adreslerini beyaz listeye ekleyin.
• x.com URL’leri gömülmüyor: WordPress 6.4’ten daha eski bir sürüm çalıştırıyorsanız twitter.com URL biçimine geçin veya WordPress çekirdeğini güncelleyin.

SSS

Gömülü tweetim neden işlenmiş bir kart yerine düz bir bağlantı olarak görünüyor?

WordPress’in Twitter’ın uç noktasına yönelik oEmbed isteği başarısız oldu veya hata döndürdü ve WordPress bu hatayı önbelleğe aldı. Etkilenen gönderi için _oembed_* post meta’sını temizleyin, sunucunuzun publish.twitter.com adresine giden HTTPS istekleri yapabildiğini doğrulayın ve tweet’in silinmediğini veya gizli yapılmadığını onaylayın.

Tweet gömmek sayfa yükleme hızını etkiler mi?

Evet. Twitter’ın widgets.js betiği yaklaşık 150–200 KB boyutundadır ve cdn.syndication.twimg.com adresine ek istekler tetikler. Intersection Observer ile betiği geç yükleyerek veya yalnızca kullanıcı etkileşiminde canlı widget’ı yükleyen statik bir cephe kullanarak bunu azaltın.

Korumalı (gizli) hesaplardan tweet gömebilir miyim?

Hayır. Twitter’ın oEmbed uç noktası, kendi hesabınızın takip durumundan bağımsız olarak korumalı hesaplardaki tweetler için 404 döndürür. Desteklenen bir geçici çözüm yoktur; bunun yerine uygun atıfla birlikte ekran görüntüsü kullanmanız gerekir.

Twitter’ın oEmbed uç noktası çökerse gömülü tweetlere ne olur?

WordPress, önbelleğe alınmış gömme HTML’sini 24 saate kadar sunar (varsayılan TTL). Önbellek süresi dolduktan sonra, uç nokta kurtarılana kadar gömme düz bir köprü bağlantısına dönüşür. Önbellek TTL’sini uzatmak için temanızın functions.php dosyasına şunu ekleyin:

add_filter( 'oembed_ttl', function( $ttl ) {
    return 7 * DAY_IN_SECONDS; // Cache for 7 days
} );

Gömülü tweetler Twitter’ın API hız limitlerini etkiler mi?

oEmbed uç noktası (publish.twitter.com/oembed), Twitter v2 API’sinden ayrıdır ve API token’ları tüketmez ya da geliştirici katmanı hız limitlerine sayılmaz. Ancak, WordPress oEmbed önbelleğini sık sık geçersiz kılan yüksek hacimli siteleri etkileyebilen IP adresine dayalı kendi belgelenmemiş hız limitlerine tabidir.