Twitter ve X Akış Widget'ı - Mağazanızda Canlı Zaman Tüneli veya Öne Çıkan Tweet, API Anahtarı ve Geliştirici Hesabı Gerekmez

Sosyal kanıtınız, tam da satışa dönüştüğü yerde

Aktif bir akış, ziyaretçiye mağazanın arkasında gerçek bir işletme olduğunu anlatır — yeni gelen ürünler, müşterilere verilen yanıtlar, bu sabah yapılan bir duyuru. Bu modül o akışı en çok işe yarayacağı yere taşır ve kurulumu yaklaşık bir dakikanızı alır.

API anahtarı yok. Hiç. Hiçbir zaman.

Sürüm 4'ün bütün meselesi bu. Kullanıcı adınızı girin — başındaki @ ile ya da onsuz yapıştırabilirsiniz, modül @ işaretini sizin için otomatik olarak temizler — ve işiniz bitti. Kaydolunacak bir geliştirici hesabı, tamamlanacak bir OAuth akışı, oluşturulacak bir uygulama, yapıştırılacak anahtarlar ve saklanacak kimlik bilgileri yok; çünkü modül bunların hiçbirine dokunmuyor.

Canlı zaman tüneli ya da tek bir öne çıkan tweet

Canlı zaman tüneli, en yeni gönderilerinizi sürekli güncellenen bir akış hâlinde gösterir. Öne çıkan tweet ise seçtiğiniz tek bir gönderiyi gösterir — bağlantısını yapıştırın, ziyaretçilerin göreceği gönderi o olsun.

İkinci modu bilmenizin çok pratik bir nedeni var. Twitter/X'in herkese açık gömme servisi oldukça sıkı bir istek sınırı uygular ve sürekli yenilenen bir zaman tüneli bu kotanın büyük bölümünü tek başına tüketebilir. Öne çıkan tweet yalnızca tek ve sabit bir gönderi talep ettiği için platform yoğun olduğunda çok daha sağlam durur. Otomatik güncellemeden çok kararlılığa değer veriyorsanız seçmeniz gereken mod budur.

Yapılandırma sayfasından seçilen beş konum

Sol sütun, sağ sütun, alt bilgi, ana sayfa veya sol alt köşeye sabitlenen yüzen düğme. Seçimi doğrudan modülün kendi sayfasında yaparsınız — Tasarım → Konumlar ekranına gitmeye gerek yok ve yaptığınız değişiklik anında yürürlüğe girer.

Modülü nasıl kullanacağınızı belirlediği için baştan net olalım: her konum kompakt bir düğme olarak görüntülenir ve ziyaretçi düğmeye tıkladığında akış bir açılır pencerede açılır. Zaman tüneli sütununuzun içine gömülü olarak durmaz. Bu sayede üçüncü taraf bir gömülü içerik sayfanızın kritik görüntüleme yolundan uzak kalır ve modül kendi içeriğinizi hiçbir zaman sayfada aşağı itmez.

Temanıza uyacak şekilde tasarlandı

Açık veya koyu tema, üstüne widget içindeki bağlantılar için isteğe bağlı bir vurgu rengi. Dört ek anahtar başlığı gizler, alt bilgiyi gizler, kenarlıkları kaldırır veya arka planı saydam yapar — bunlar canlı zaman tüneli için geçerlidir ve alan yardım metni de bunu belirtir. 1 ile 20 arasında sabit bir tweet sayısı ya da 200 ile 1200 piksel arasında dilediğiniz yükseklikte kaydırılabilir bir akış seçin.

Öne çıkan tweet için iki ek anahtar daha var: Bu konuyu göster bağlantısını gizleyin ve yalnızca metni istiyorsanız fotoğraf, video ve bağlantı önizlemelerini kapatın.

Bir ziyaretçinin tweet'ten beklediği her şey

Bu, kazınmış metin değil Twitter/X'in resmi widget'ı olduğu için ziyaretçiler gerçeğine kavuşur — yanıtlama, retweet ve beğeni, tıpkı platformun kendisindeki gibi doğal olarak çalışır. Medya, konu başlıkları ve bağlantı önizlemeleri olması gerektiği gibi görüntülenir.

Net doğrulama ve yayına almadan önce önizleme

Ayarların doğru olup olmadığını tahmin etmenize gerek yok. Bir şeyi yanlış girdiğinizde kayıt anlaşılır bir mesajla reddedilir — "Lütfen geçerli bir Twitter/X kullanıcı adı girin: yalnızca harf, rakam ve alt çizgi, en fazla 15 karakter" ya da hatalı bir tweet bağlantısı veya geçersiz bir hex renk kodu için bunun karşılığı — ve hiçbir şey yazılmaz; böylece bir yazım hatası çalışan bir yapılandırmayı sessizce bozamaz. Bir kullanıcı adı veya tweet kaydedildiğinde ise yapılandırma sayfasındaki canlı önizleme, ziyaretçilerin tam olarak ne göreceğini size gösterir.

Özelleştirme konusunda dürüst bir not

Resmi widget yalnızca açık/koyu tema ile tek bir vurgu rengi sunar; gerçekten sunduğu her şey bundan ibarettir. Tweet metnini dilediğiniz gibi yeniden biçimlendirmek istiyorsanız, hiçbir modül bunu resmi gömme üzerinden veremez — bu, API anahtarı istemeyen ve platform kurallarını değiştirdiğinde bozulmayan bir akışın karşılığıdır.

Sürüm 4 gerçek bir güvenlik sorununu ortadan kaldırdı

Bu, herhangi bir özellikten daha önemli. Önceki sürümler tweet'leri Twitter API v1.1 üzerinden, pakete gömülü on yıllık bir OAuth kütüphanesi ve modülün her kopyasının içinde gönderilen sabit kodlanmış geliştirici kimlik bilgileri ile çekiyordu. Twitter/X 2023'te bu API'ye ücretsiz erişimi kapattı, dolayısıyla entegrasyon güvenilir biçimde çalışmayı bırakmıştı — daha kötüsü, açığa çıkmış bu kimlik bilgileri yüzünden yapılandırılmamış bir kurulum varsayılan olarak sessizce bir başkasının akışını çekiyordu.

Sürüm 4 bunların tamamını kaldırır: API katmanı yok, pakete gömülü OAuth kütüphanesi yok, sızacak kimlik bilgisi yok ve modülde bir platform politikası değişikliğinin bozabileceği hiçbir şey kalmadı.

Yükseltme, eski sürümden kalanları temizler

Modülü açın, kendini taşısın. Eski API anahtarları ve artık geçerli olmayan eski ayarlar veritabanınızda öylece bırakılmak yerine bilinçli olarak silinir. Kullanıcı adınız ve konum tercihiniz olduğu gibi aktarılır.

Sürüm 4.1.1 ayrıca açıkça anlatmaya değer bir yükseltme hatasını giderdi: 4.0.1 adımı başarısını bir registerHook() çağrısının true dönmesine bağlıyordu; bu yüzden geçici bir hata — ya da yarım kalmış önceki bir denemede zaten kaydedilmiş bir kanca — adımı başarısız sayıyor ve PrestaShop modülü devre dışı bırakıyordu. Kanca artık idempotent biçimde kaydediliyor ve adım her zaman başarı bildiriyor.

Bir gizlilik ayarı ve izleme konusunda net bir cevap

İsteğe bağlı Do Not Track anahtarı, Twitter/X'ten ziyaretçileri widget üzerinden kişiselleştirmemesini ve izlememesini ister. Bunun ne yapıp ne yapmadığını bilin: betiğin yüklenmesini engellemez. Bu modül, akışın göründüğü sayfalarda platform.twitter.com adresinden bir betik yükler; bunu, üçüncü taraf her gömülü içerikte olduğu gibi çerez ve gizlilik politikanızda belirtmelisiniz.

Uyumluluk

PrestaShop 1.7, 8 ve 9 ile sekiz dilde çalışır: Almanca, Felemenkçe, Fransızca, İngilizce, İspanyolca, İtalyanca, Lehçe ve Türkçe. Akış bir açılır pencerede açıldığı için her konum temanızın Bootstrap kalıcı penceresini kullanır — bu, classic temada ve ondan türeyen temalarda standarttır, ağır özelleştirilmiş bir temada ise kontrol etmekte fayda vardır. Teknik modül adı önceki sürümlerle aynı kaldığı için mevcut kurulumlar sorunsuz yükselir.

Sıkça sorulan sorular

Twitter geliştirici hesabına veya API anahtarlarına ihtiyacım var mı?

Hayır. Kullanıcı adınızı girin — @ ile ya da onsuz, modül her iki durumda da @ işaretini temizler — ve hepsi bu. Kaydolunacak bir yer ve saklanacak bir kimlik bilgisi yok.

İki mod arasındaki fark nedir?

Canlı zaman tüneli en yeni gönderilerinizle kendiliğinden güncellenir. Öne çıkan tweet seçtiğiniz tek bir gönderiyi gösterir ve yalnızca o tek gönderiyi talep ettiği için Twitter/X gömme servisine istek sınırı uyguladığında çok daha dayanıklıdır.

Nereye yerleştirebilirim ve akış sayfaya gömülü olarak mı görünür?

Sol sütun, sağ sütun, alt bilgi, ana sayfa veya sol alt köşedeki yüzen düğme; seçim yapılandırma sayfasında yapılır. Her durumda konum bir düğme olarak görüntülenir ve akış mağazanızın üzerinde bir açılır pencerede açılır — sütunun içine gömülü olarak durmaz.

Akışımda "Canlı akış şu anda yüklenemedi." yazıyor.

Twitter/X'in kendi gömme altyapısı isteği reddetmiş veya istek sınırına takmış demektir. Bu, modülün denetiminde olan bir şey değildir ve genellikle birkaç dakika içinde kendiliğinden düzelir. Sık yaşıyorsanız Öne çıkan tweet moduna geçin.

Tweet'leri markama birebir uyacak şekilde biçimlendirebilir miyim?

Yalnızca belli bir noktaya kadar — resmi widget açık ya da koyu tema ile tek bir vurgu rengi sunar. Bu sınır bu modülden değil, Twitter/X'ten kaynaklanır.

Ziyaretçiler mağazamdan yanıt verip retweet yapabilir mi?

Evet. Resmi gömme olduğu için yanıtlama, retweet ve beğeni doğal olarak çalışır.

Eski bir sürümden yükselttim — API anahtarlarıma ne oldu?

Diğer eski ayarlarla birlikte bilerek silindiler. Eski entegrasyon, yıllardır herkese açık hâlde bulunan kimlik bilgilerine ihtiyaç duyuyordu; yenisi ise yalnızca kullanıcı adınıza ihtiyaç duyar.

KVKK yükümlülükleriyle uyumlu mu?

Twitter/X'ten deneyimi kişiselleştirmemesini isteyen bir Do Not Track seçeneği var, ancak gömme betiği yine de yüklenir. Üçüncü taraf her gömülü içerikte olduğu gibi bunu gizlilik politikanızda belirtin.