Desteklenen platformlar

Kurulum

1. Eklentiyi indir. Zip'i açma, olduğu gibi yükleyeceksin.
2. WordPress yönetiminde Eklentiler › Yeni Eklenti Ekle › Eklenti yükle'ye tıkla, zip'i seç, Şimdi kur ve ardından Etkinleştir.
3. Ayarlar › TurkCDN sayfasını aç. En üstte yükleme klasörünün adresi yazar, ör. https://mysite.com/wp-content/uploads.
4. Bu adresi TurkCDN panelinde Alanlar sayfasında alanının Kaynak ayarına yapıştır.
5. Alanının adresini (ör. https://cdn.turkcdn.com/magazam) eklentinin TurkCDN adresi kutusuna yaz. İstersen WebP ya da AVIF'i seç, Değişiklikleri kaydet.
6. Siteni aç, bir görsele sağ tıklayıp adresine bak: cdn.turkcdn.com ile başlıyorsa tamam.

Bilmen gerekenler

• Yönetim paneline ve sunucudaki dosyalarına dokunulmaz. Eklentiyi kapatınca adresler eski hâline döner.
• Önbellek eklentisi (WP Rocket, LiteSpeed Cache, W3 Total Cache…) kullanıyorsan kaydettikten sonra önbelleği temizle.
• Görüntüleyiciyi açarsan tıklayınca büyütme ve büyüteç sitende de çalışır.

Bir görseli değiştirdin ama eskisi görünüyorsa TurkCDN panelinden o görseli sil; bir sonraki istekte yenisi alınır.

Kurulum

WooCommerce ayrı bir eklenti istemez. Ürün görsellerin WordPress'in yükleme klasöründe durduğu için WordPress kurulumundaki adımlar mağazandaki her görseli kapsar: ürün kartları, ürün galerisi, kategori görselleri, sepet ve önerilen ürünler.

Mağazada nasıl kullanılır?

• Format: ürün fotoğraflarında AVIF en küçük dosyayı verir, sayfaların belirgin biçimde hızlanır.
• Görüntüleyici: açarsan ürün fotoğrafına tıklayınca büyük hâli açılır, üzerinde gezince büyüteç çıkar. Ayarını TurkCDN panelinden yaparsın.
• Yeni ürün: bir şey yapman gerekmez. Yüklediğin görsel, sayfada ilk görüntülendiğinde TurkCDN'e alınır.

Ürün görselini aynı adla değiştirdiysen eskisi görünmeye devam eder. TurkCDN panelinden o görseli sil ya da görseli yeni adla yükle.

Kurulum (OpenCart 4)

1. Eklentiyi indir. Zip'i açma ve adını değiştirme: OpenCart eklentiyi dosya adından tanır.
2. Yönetimde Eklentiler › Yükleyici (Extensions › Installer) sayfasında Yükle'ye bas ve zip'i seç.
3. Aynı sayfada alttaki listede TurkCDN satırındaki yeşil Kur düğmesine bas.
4. Eklentiler › Eklentiler'de türü Modüller yap, TurkCDN'i Kur, ardından Düzenle'ye bas.
5. Ayar sayfasındaki kaynak adresini (ör. https://magaza.com/image) Kopyala ile al ve TurkCDN panelinde alanının Kaynak ayarına yapıştır.
6. Alanının adresini (ör. https://cdn.turkcdn.com/magazam) yaz, format ve görüntüleyiciyi seç, Durum'u aç ve kaydet.
7. Bir ürün sayfasında görsel adresinin cdn.turkcdn.com ile başladığına bak.

OpenCart 3

3.x sürümünü indir, Eklentiler › Eklenti Yükleyici'den yükle, Eklentiler › Eklentiler › Modüller'de TurkCDN'i kur ve düzenle. Ayarlar 4.x ile aynı.

Bilmen gerekenler

• Türkçe dil paketlerinde menü adları biraz farklı olabilir; parantez içindeki İngilizce adlar her zaman aynı.
• Sayfa önbelleği eklentisi kullanıyorsan kaydettikten sonra önbelleği temizle.
• Birden fazla mağazan varsa her mağaza kendi görsel adresiyle çevrilir.

Bir görseli aynı adla değiştirdiysen TurkCDN panelinden o görseli sil; bir sonraki istekte yenisi alınır.

Kurulum

1. Modülü indir. Zip'i açma.
2. Yönetimde Modüller › Modül yöneticisi'ne gir, sağ üstteki Bir modül yükle'ye tıkla ve zip'i bırak.
3. Kurulum bitince Yapılandır'a tıkla. Sayfanın üstünde mağazanın kaynak adresi yazar, ör. https://magaza.com.
4. Bu adresi TurkCDN panelinde alanının Kaynak ayarına yapıştır.
5. Alanının adresini (ör. https://cdn.turkcdn.com/magazam) TurkCDN adresi kutusuna yaz, format ve görüntüleyiciyi seç, Kaydet.
6. Gelişmiş Parametreler › Performans'ta Önbelleği Temizle'ye bas, vitrinde bir ürün görselinin adresine bak.

Bilmen gerekenler

• Hem img/p/… adresleri hem kullanıcı dostu adresler (12-home_default/ayakkabi.jpg) çevrilir.
• Tema ve modül görselleri (ikonlar, ödeme logoları) varsayılan olarak çevrilmez. Ana sayfa slaytı gibi büyük görseller için ayardan açabilirsin.
• Nginx kullanıyorsan PrestaShop'un görsel yönlendirme kurallarının sunucuda tanımlı olması gerekir.
• Kombinasyon değiştirme ve filtreleme gibi sonradan yüklenen görseller mağazandan gelmeye devam eder; bir şey bozulmaz.

Bir görseli aynı adla değiştirdiysen TurkCDN panelinden o görseli sil; bir sonraki istekte yenisi alınır.

Kurulum

1. Modülü indir ve Magento'nun kök klasöründe aç: unzip turkcdn-magento.zip -d app/code/
2. Modülü etkinleştir: bin/magento module:enable TurkCdn_ImageCdn
3. Kur: bin/magento setup:upgrade. Mağazan production modundaysa ardından bin/magento setup:di:compile çalıştır.
4. Önbelleği temizle: bin/magento cache:flush
5. Yönetimde Stores › Configuration › TurkCDN sayfasını aç. Etkin'i Evet yap, alanının adresini (ör. https://cdn.turkcdn.com/magazam) yaz, format ve görüntüleyiciyi seç, kaydet.
6. Adres kutusunun altında mağazanın medya adresi yazar (ör. https://magaza.com/media). Bunu TurkCDN panelinde alanının Kaynak ayarına yapıştır.
7. Önbelleği bir kez daha temizle. Varnish kullanıyorsan onu da temizle.

Bilmen gerekenler

• Ayarlar store view başına yapılır. Birden çok mağazan varsa her biri ayrı TurkCDN alanına bağlanabilir.
• Tam sayfa önbelleğinden gelen sayfalar da çevrilir. Ayarları değiştirdikten sonra önbelleği temizle.
• Kendi alan adını bağladıysan, Magento'nun güvenlik politikası (CSP) için o adresi izin listesine eklemen gerekir.
• Headless (PWA, GraphQL) vitrinlerde görsel adreslerini kendi uygulamanda değiştirmelisin.

Bir görseli aynı adla değiştirdiysen TurkCDN panelinden o görseli sil; bir sonraki istekte yenisi alınır.

Kurulum

1. Eklentiyi indir. Zip'i açma.
2. Yönetimde Sistem › Kur › Eklentiler'e gir, Paket Dosyasını Yükle sekmesine zip'i bırak.
3. Sistem › Yönet › Uyumlu Ekler'de turkcdn diye ara ve Sistem - TurkCDN'i aç.
4. Kaynak adresi altında yazan adresi (ör. https://site.com/images) TurkCDN panelinde alanının Kaynak ayarına yapıştır.
5. Alanının adresini (ör. https://cdn.turkcdn.com/alanim) TurkCDN adresi kutusuna yaz, format ve görüntüleyiciyi seç.
6. Durum'u Etkin yap ve Kaydet & Kapat'a bas. Sitende bir görselin adresine bak.

Bilmen gerekenler

• Joomla'nın içerikte kullandığı göreli adresler (images/…) de çevrilir; düz metne dokunulmaz.
• Düzenleme sayfalarına ve metin kutularına dokunulmaz, makalelerine CDN adresi kaydedilmez.
• Mağaza bileşenin görselleri images dışında bir klasörde tutuyorsa o görseller çevrilmez.

Bir görseli aynı adla değiştirdiysen TurkCDN panelinden o görseli sil; bir sonraki istekte yenisi alınır.