BelgelerYönetim PaneliStrapi CMS Yönetim Kılavuzu

📝 Strapi 5 CMS İçerik Yönetimi Kılavuzu

Strapi 5; ana sayfa bloklarının düzeninden ürün seçeneklerinin çevirilerine ve genel marka renklerine kadar mağazanızın tüm içeriğini kod yazmadan yönetmenizi sağlar.

1. Strapi İçerik Yapısını Anlamak

Sol menüdeki Content Manager altında iki temel veri yapısı göreceksiniz:

Tekil Tipler (Single Types)

Tüm sitede yalnızca tek bir örneği bulunan sayfalar veya yapılandırmalar:

  • Homepage: Ana sayfanın içeriği ve dinamik blok düzeni.
  • Storefront Setting: Mağazanın genel ayarları (renkler, menü ve altbilgi).

Koleksiyon Tipleri (Collection Types)

Birden fazla üretilebilen ve listelenebilen veri tipleri:

  • Banners: Promosyon afişleri ve reklam görselleri.
  • Articles: Blog makaleleri ve haber içerikleri.

2. Genel Mağaza Ayarları

Sitenin genel görünümünü özelleştirmek için Single Types altındaki Storefront Setting bölümüne gidin.

  • Fiyat Dönüştürme (convertToToman): Fiyatların yerel para birimlerine göre doğru basamakta gösterilmesini sağlar.
  • RTL Yönü (isRtl): Arapça ve Farsça gibi sağdan sola yazılan diller için mağaza yönünü ayarlar.
  • Dinamik Stiller (Dynamic Styling): Ana renk paletini, yazı tiplerini ve sosyal bağlantıları anında değiştirin.

3. Ürün Varyant ve Seçenek Çevirileri (Dictionary Entries)

Medusa panelinde tanımladığınız ürün seçeneklerini (örn: Color veya Size) mağaza vitrininde farklı dillerde göstermek için Strapi Dictionary bölümünü kullanabilirsiniz.

🌐 Yeni Bir Çeviri Nasıl Tanımlanır?

  1. Sol menüde Collection Types altından Dictionary Entries seçeneğine tıklayın.
  2. Create new entry düğmesine tıklayın.
  3. Key alanına Medusa'daki İngilizce karşılığı tam olarak yazın (örn: Red veya Large).
  4. Value alanına hedef dildeki karşılığı yazın (örn: Kırmızı veya Büyük Beden).
  5. Save ve ardından Publish düğmesine basarak kaydedin.
  6. Son olarak değişiklikleri Save ve Publish yapın. Bundan sonra ön yüz sistemi, Medusa ürünlerinden gelen Color kelimesini otomatik olarak Renk olarak çevirip gösterecektir.

4. Dinamik Alanlarla (Dynamic Zones) Ana Sayfayı İnşa Etmek

Ana sayfa katı bir tasarıma bağlı değildir; blokları bir yapboz gibi üst üste dizebilirsiniz. Yeni bir blok eklemek için:

1İlk olarak blok içeriğini Collection Types'ta hazırlayın

Bir bloğu ana sayfaya eklemeden önce içeriğini Collection Types bölümünde oluşturun:

  • Afiş ekleyecekseniz içeriği önce Banners altında oluşturun.
  • Blog ekleyecekseniz yazıları önce Articles altında hazırlayın.
  • Öne çıkan ürünler doğrudan Medusa veritabanından dinamik olarak çekilir.
  • Makaleler için: Bir Hp Section Blog oluşturun.
  • Kategoriler için: Bir Hp Section Category Collection oluşturun.

İstenen ayarları belirleyin, ardından Save ve Publish butonlarına basın.

2İkinci olarak bloğu Homepage sayfasına ekleyin

  1. Add an entry to Sections düğmesine tıklayın.
  2. İstediğiniz blok türünü (örn: Banner Grid veya Featured Products) seçin.
  3. Ayarları doldurun ve birinci adımda hazırladığınız içerikle ilişkilendirin.
  4. Blok içindeki Relation alanında, 1. adımda oluşturduğunuz Bölümü (Section) arayıp seçin.
  5. Sürükle ve Bırak (Drag & Drop) özelliğini kullanarak blokların görüntülenme sırasını değiştirebilirsiniz.

3Üçüncü olarak kaydedin ve yayınlayın

  1. Değişiklikleri Taslak (Draft) olarak kaydetmek için Save butonuna tıklayın.
  2. Yayınlamadan önce son görünümü incelemek için Open Live Preview butonunu kullanın.
  3. Sonuç onaylandıysa bir sonraki adıma geçin, aksi takdirde ayarları düzenleyin.

4Yayınlama (Publish)

  1. Sayfanın üst kısmındaki Publish butonuna tıklayın.
  2. Strapi otomatik olarak ön yüze bir Webhook gönderir ve anasayfa önbelleğini temizler.
  3. Birkaç saniye içinde yeni blok canlı sitede görüntülenir.
Uzman Tavsiyesi
Her zaman önce Collection Types bölümünde gerekli tüm Bölümleri (Sections) oluşturup yayınlayın (Publish), ardından Homepage sayfasına geçerek bunları Dynamic Zone alanına ekleyin.

Gelişmiş Strapi CMS Yönetim Paneli

Strapi'de Öğelerin Kolay Yönetimi (adminDisplayTitle alanı)

Kalabalık Dynamic Zone veya İlişki (Relation) listelerinde blokların daha kolay yönetilmesi için tüm Strapi formlarına adminDisplayTitle adında özel bir alan eklenmiştir. Ayarlar dişli çarkından (Configure the view), Entry title alanını adminDisplayTitle olarak ayarlayabilirsiniz. Artık herhangi bir öğeye özel bir ad (örneğin "Sonbahar Bannerı") yazdığınızda, bu ad açılır listede ve kartlarda görünerek bulunmasını çok kolaylaştırır. Bu alan tamamen Özeldir (Private) ve son kullanıcıya iletilmez.


Canlı Önizleme ve Anında Güncelleme

Taslak ve Yayınlama Modu (Draft & Publish)

Sayfa içeriklerini yayınlamadan önce taslak olarak hazırlayın, inceleyin ve tek tıkla canlıya alın.

İsteğe Bağlı Anlık Yeniden Doğrulama (On-Demand ISR)

Strapi'de içerik yayınlandığında Next.js önbelleği milisaniyeler içinde yenilenir.


Özel Geliştirici Kılavuzları

Modüler bloklar ve görsel marka ayarları hakkında ayrıntılı teknik rehberler.

Modüler Blok Kılavuzu

Yeni bloklar oluşturmayı ve Next.js 16 ile entegre etmeyi öğrenin.

Kılavuzu Aç

Genel Ayarlar Kılavuzu

Storefront Setting alanlarının ve marka kimliği yapılandırmasının tam dökümü.

Kılavuzu Aç