Documentation

Mergen documentation

Step-by-step guide to installing the Mergen WordPress theme, activating your license, importing demos and managing your site. Explore the Mergen theme.

6 min read 16 başlık

The English translation of this documentation is coming soon; the Turkish version is shown for now.

On this page
  1. Amaç
  2. Ön koşullar
  3. 1. Güncellemeler nasıl gelir?
  4. Güncellemeden önce
  5. Güncellemeden sonra
  6. Destek süresi dolduysa
  7. Elle güncelleme
  8. 2. Alt tema (mergen-child)
  9. Kurulum
  10. Ne nereye yazılır?
  11. 3. Çeviri
  12. Sürüm numaralarını okumak
  13. Test sitesi (staging) kullanmak
  14. Güncelleme sırasında hata olursa
  15. Sık yapılan hatalar
  16. İlgili bölümler

Güncelleme ve alt tema

Mergen düzenli olarak güncellenir: yeni demolar, bloklar, özellikler, güvenlik ve uyumluluk düzeltmeleri gelir. Bu bölüm güncellemeleri nasıl alacağınızı, kendi değişikliklerinizi güncellemede kaybetmemek için alt temayı nasıl kullanacağınızı ve temayı nasıl çevireceğinizi anlatır.

Amaç#

  • Güncellemeleri WordPress'in kendi ekranından tek tıkla almak.
  • Güncellemeden önce ve sonra yapılacakları bilmek.
  • Kod ve şablon değişikliklerinizi alt temada güvenle yapmak.

Ön koşullar#

  • Lisansınız etkin ve Güncelleme & destek süreniz devam ediyor. Süreyi Mergen › Lisans ekranında görürsünüz. Bkz. Kurulum ve lisans.
  • Güncel bir site yedeği (barındırma panelinizden ya da bir yedekleme eklentisiyle).

1. Güncellemeler nasıl gelir?#

Lisansınız etkin ve destek süreniz devam ediyorsa yeni Mergen ve Mergen Core sürümleri WordPress'in kendi güncelleme ekranına gelir:

  1. Başlangıç › Güncellemeler ekranında ya da Görünüm › Temalar'da Mergen'in üzerinde "Yeni sürüm var" uyarısını görürsünüz. Mergen Core güncellemesi Eklentiler ekranında ve aynı Güncellemeler ekranında listelenir.

    WordPress güncellemeleri
    Başlangıç › Güncellemeler: tema ve eklenti güncellemeleri burada listelenir.
    Görünüm › Temalar'da Mergen
    Görünüm › Temalar: Mergen'in tema ayrıntıları.
  2. Görünüm › Temalar'da Mergen'e tıklayınca tema ayrıntıları açılır: kurulu sürüm (1), yeni sürüm bilgisi ve Sürüm ayrıntıları bağlantısı. Bu bağlantı sizi sürüm notlarına götürür.

    Tema ayrıntıları
    Tema ayrıntıları: (1) sürüm, (2) eylemler.
  3. Şimdi güncelle'ye tıklayın. Ayarlarınız, içerikleriniz, sayfa oluşturucu düzenleriniz ve lisansınız korunur.
  4. Güncellemeden sonra panelde bir kez "Mergen güncellendi" bildirimi çıkar; Mergen › Bu sürümde neler var ekranı yenilikleri gösterir.

    Bu sürümde neler var
    Mergen › Bu sürümde neler var: sürüm başına yenilikler.

İpucu: Tema ayrıntılarında Otomatik güncellemeleri etkinleştir bağlantısı varsa, küçük sürümlerin kendiliğinden kurulmasını sağlayabilirsiniz. Büyük ve kalabalık sitelerde güncellemeleri elle ve önce test sitesinde yapmanızı öneririz.

Güncellemeden önce#

  1. Sitenizin tam yedeğini alın (dosyalar ve veritabanı).
  2. Mergen klasöründe doğrudan değişiklik yaptıysanız bunları alt temaya taşıyın; aksi hâlde güncellemede silinir. Bkz. Alt tema.
  3. Büyük sürümlerde (ör. 2.x → 3.x) önce bir test sitesinde (ör. staging.alanadiniz.com; lisans kotanıza sayılmaz) deneyin.

Güncellemeden sonra#

  1. Yönetim çubuğundaki Önbelleği temizle'ye tıklayın; CDN kullanıyorsanız orada da temizleyin.
  2. Ana sayfanızı, bir yazıyı ve (varsa) sepet/ödeme ile randevu sayfalarını kontrol edin.
  3. Mergen Core'u da güncel tutun; yeni tema sürümleri eklentinin güncel sürümünü bekleyebilir.

Destek süresi dolduysa#

Temanız çalışmaya devam eder; yalnız yeni sürümler indirilemez. Güncelleme ekranında "destek ve güncelleme süreniz doldu" açıklaması ve Destek sürenizi yenileyin bağlantısı çıkar.

  1. Bağlantıdan (ya da temorya.com hesabınızdan) destek sürenizi yenileyin.
  2. Mergen › Lisans ekranında Şimdi doğrula'ya tıklayın (1). Yeni bitiş tarihi Güncelleme & destek satırında görünür ve güncellemeler yeniden gelir.

    Lisansı doğrula
    Mergen › Lisans: (1) Şimdi doğrula.

Elle güncelleme#

Otomatik güncelleme sunucunuzda çalışmıyorsa:

  1. Temorya hesabınızdan yeni mergen.zip dosyasını indirin.
  2. Görünüm › Temalar › Yeni tema ekle › Tema yükle ile yükleyin.
  3. WordPress "Bu tema zaten kurulu" der ve iki sürümü karşılaştırır; Yüklenenle değiştir'i seçin.
  4. Mergen Core için aynı işlemi Eklentiler › Yeni eklenti ekle › Eklenti yükle ile mergen-core.zip dosyasıyla yapın.

Dikkat: Tema klasörünü FTP ile silip yeniden yüklemeyin; yükleme sırasında site kısa süreliğine temasız kalır. "Yüklenenle değiştir" yöntemi daha güvenlidir.

2. Alt tema (mergen-child)#

Mergen güncellendiğinde temanın dosyaları yenisiyle değişir. Kendi CSS, PHP ya da şablon değişikliklerinizi alt temada yaparsanız güncellemede kaybolmaz. Alt tema, ana temanın bütün özelliklerini kullanır; yalnız sizin değiştirdiğiniz dosyaları ezer.

İpucu: Yalnız birkaç satır CSS eklemek istiyorsanız alt temaya gerek yok: Tema ayarları › Gelişmiş › Özel kod › Özel CSS alanı da güncellemelerde korunur.

Kurulum#

  1. Temorya hesabınızdan mergen-child.zip dosyasını indirin.
  2. Görünüm › Temalar › Yeni tema ekle › Tema yükle ile yükleyin. Ana tema Mergen kurulu kalmalıdır; silmeyin.
  3. Mergen Child'ı etkinleştirin. Lisansınız, Mergen ayarlarınız, menüleriniz ve logonuz korunur.

    Alt tema
    Görünüm › Temalar: (1) Mergen Child, (2) etkin tema.

Ne nereye yazılır?#

İstediğinizAlt temadaki dosya
CSS değişikliğistyle.css (Mergen'in stilinden sonra yüklenir)
PHP kodu, kanca, süzgeçfunctions.php (sonuna ekleyin)
Şablon değişikliğiAna temadaki dosyayı aynı klasör yoluyla alt temaya kopyalayıp düzenleyin

Şablon örnekleri:

  • mergen/template-parts/card/classic.php → mergen-child/template-parts/card/classic.php (yazı kartları)
  • mergen/template-parts/blocks/kit/<blok>.php → mergen-child/template-parts/blocks/kit/<blok>.php (oluşturucu blokları)
  • mergen/single.php → mergen-child/single.php

functions.php örneği — belge bağlantılarını kendi yardım sayfanıza yönlendirmek:

<?php
add_filter( 'mergen/docs_url', function ( $url, $section ) {
	return 'https://www.alanadiniz.com/yardim/' . $section . '/';
}, 10, 2 );

Dikkat: Kopyaladığınız şablonlar Mergen güncellemesiyle otomatik güncellenmez. Büyük sürümlerden sonra ana temadaki yeni hâliyle karşılaştırın; WooCommerce şablonu kopyaladıysanız WooCommerce'in "eski şablon" uyarılarını takip edin.

3. Çeviri#

Mergen ve Mergen Core çeviriye hazırdır. Çeviri şablonları:

  • Tema: mergen/languages/mergen.pot
  • Eklenti: mergen-core/languages/mergen.pot
  1. Loco Translate eklentisini kurun ya da bilgisayarınızda Poedit kullanın.
  2. Şablondan yeni bir dil oluşturup çevirin.
  3. Dosyayı wp-content/languages/themes/mergen-<yerel>.mo olarak kaydedin (ör. mergen-en_US.mo). Loco Translate bunu sizin için yapar.

Tarayıcıda çalışan metinler (takvim, formlar, hesaplayıcılar, Blok ekle penceresi) de aynı çeviri dosyasından gelir. Çok dilli siteler için Mergen, WPML ve Polylang Pro'nun okuduğu wpml-config.xml dosyasıyla gelir; tema ayarlarındaki metinler (alt bilgi, düğme yazıları) dil başına çevrilebilir.

Not: Çevirileri mergen/languages/ klasörüne değil, wp-content/languages/ altına kaydedin; tema klasörü güncellemede yenilenir.

Sürüm numaralarını okumak#

Mergen sürümleri üç sayıdan oluşur: ana.küçük.düzeltme (ör. 2.1.0).

Değişen sayıÖrnekNe içerir?Önerimiz
Düzeltme2.1.0 → 2.1.1Hata ve güvenlik düzeltmeleriHemen güncelleyin
Küçük2.1 → 2.2Yeni özellikler, demolar, bloklar; geriye uyumluYedek alıp güncelleyin
Ana2.x → 3.0Büyük değişiklikler; alt temadaki şablonları etkileyebilirÖnce test sitesinde deneyin

Her sürümün ayrıntısı sürüm notlarında yazar.

Test sitesi (staging) kullanmak#

Büyük güncellemeleri ve önemli tasarım değişikliklerini önce canlı sitenin bir kopyasında denemek en güvenli yoldur:

  1. Barındırma panelinizin Staging / Test sitesi aracıyla (çoğu firmada tek tıktır) sitenizin bir kopyasını oluşturun. Adresi genellikle staging.alanadiniz.com biçimindedir.
  2. Kopya sitede Mergen lisansınızı girin; staging.* adresleri lisans kotanıza sayılmaz.
  3. Güncellemeyi kopyada yapın ve ana sayfa, yazı, mağaza ve randevu sayfalarını kontrol edin.
  4. Her şey yolundaysa canlı sitede aynı güncellemeyi yapın. Kopyadan canlıya veritabanı aktarmayın; canlıdaki yeni siparişler ve randevular kaybolur.

Dikkat: Test sitesinden müşterilere e-posta gitmemesi için kopya sitede Tema ayarları › E-posta › E-postaları SMTP ile gönder'i kapatın ya da bir test SMTP hesabı kullanın.

Güncelleme sırasında hata olursa#

WordPress güncellemeyi önce indirir, sonra eski klasörün yerine yenisini koyar. Bu sırada bağlantı kesilirse site kısa bir süre "Bakım için kısa süreliğine kullanılamıyor" iletisi gösterebilir.

  1. Birkaç dakika bekleyip sayfayı yenileyin; WordPress işlemi çoğu zaman kendisi tamamlar.
  2. İleti on dakikadan uzun sürerse FTP ya da barındırma panelinizin dosya yöneticisiyle WordPress'in ana klasöründeki .maintenance dosyasını silin.
  3. Görünüm › Temalar'da Mergen'in sürümünü kontrol edin. Güncelleme yarım kaldıysa elle güncelleme adımlarıyla yeni mergen.zip dosyasını Yüklenenle değiştir yöntemiyle yükleyin.
  4. Güncellemeden sonra beyaz ekran ya da kritik hata görürseniz önce Mergen Core'un da güncel olduğundan emin olun; sorun sürerse yedeğinizden geri dönüp destek talebi açın. Talebe barındırma panelinizdeki PHP hata günlüğünün son satırlarını ekleyin.

İpucu: WordPress, kritik bir hata oluştuğunda yönetici e-postanıza "kurtarma modu" bağlantısı gönderir. Bu bağlantıyla panele girip sorunlu eklentiyi devre dışı bırakabilirsiniz; bu yüzden Ayarlar › Genel'deki yönetici e-postasının güncel olması önemlidir.

Sık yapılan hatalar#

BelirtiNedenÇözüm
Güncelleme görünmüyorLisans doğrulanmamış ya da destek süresi dolmuşMergen › Lisans › Şimdi doğrula; süreyi yenileyin.
"Paket indirilemedi"Sunucu temorya.com'a bağlanamıyorBkz. SSS; elle güncelleyin.
Alt temaya geçince logo/menü kaybolduAlt tema daha önce başka ayarlarla açılmışGörünüm › Menüler'den konumu, Tema ayarları › Genel'den logoyu yeniden seçin. Bkz. SSS.
Güncellemeden sonra tasarım eskiÖnbellekÖnbelleği temizle ve Ctrl+F5.
Kendi değişikliklerim kaybolduDoğrudan ana temada düzenlenmiştiYedekten geri alın ve değişiklikleri alt temaya taşıyın.

İlgili bölümler#

Tekerlek ya da iki parmakla yakınlaştırın, sürükleyerek gezinin, çift tıklayın.