Şablon Sistemi

Bu doküman, Zonely şablon sisteminin günlük kullanımda nasıl çalıştığını açıklar. En çok kullanılan alanlara odaklanır: Şablonlar, Şablon Değişiklikleri, Eskimiş Şablonlar, Şablon Düzenleyici ve SFTP akışı.

​

Genel Bakış

Şablon sistemi, çekirdek yapıya doğrudan dokunmadan tema dosyalarını güvenli şekilde yönetebilmek için hazırlanmıştır. Günlük kullanımda çoğu işlem şu alanlarda yapılır:

1. Şablonlar
2. Şablon Değişiklikleri
3. Eskimiş Şablonlar
4. Şablon Düzenleyici
5. SFTP erişimi

Bu ekranların her birinin farklı bir amacı vardır, ancak hepsi aynı şablon iş akışının parçasıdır.

​

Şablonlar

Şablonlar sayfası ana çalışma alanıdır. Burada şablon dosyalarını listeleyebilir, arama yapabilir, tema filtresi kullanabilir ve dosyaları düzenlemek için açabilirsiniz. Ayrıca geliştiricilerin en sık kullandığı işlemler de burada yer alır. Örneğin tüm şablonları indirme, ZIP yükleme, SFTP bağlantısı açma veya tüm şablon değişikliklerini geri alma gibi işlemler buradan yapılır. Burada iki farklı kapsam arasında geçiş yapılabilir: Normal Şablon Site temasını ifade eder. AdminCP Şablon Yönetim paneli arayüzünü ifade eder. Kısacası bir dosyayı bulmak, açmak ve üzerinde çalışmak istediğinizde ilk uğrayacağınız ekran burasıdır.

​

Şablon Değişiklikleri

Şablon Değişiklikleri sayfası sadece değişmiş dosyaları gösterir. Bu yüzden hızlı kontrol ve temizlik için oldukça kullanışlıdır. Tüm şablonlar arasında gezmek yerine sadece override edilmiş veya düzenlenmiş dosyaları görürsünüz. Bu ekrandan şunları yapabilirsiniz: Bir dosyanın farkını görüntülemek. Tek bir dosyayı geri almak. Tüm değişmiş şablonları topluca sıfırlamak. Özellikle birden fazla dosyada işlem yaptıktan sonra nelerin gerçekten değiştiğini görmek için en pratik ekranlardan biridir.

​

Eskimiş Şablonlar

Eskimiş Şablonlar sayfası, çekirdek şablon güncellemelerinden sonra kullanılır. Sistem bir override dosyasının eski bir şablon sürümüne göre kaldığını tespit ederse, bu dosya burada listelenir. Böylece sistem güncellendikten sonra hangi override dosyalarının yeniden gözden geçirilmesi gerektiği kolayca anlaşılır. Buradan dosyaları tek tek güncelleyebilir ya da tüm eskimiş şablonları topluca güncelleyebilirsiniz. Önerilen yaklaşım basittir: Önce farkı inceleyin, sonra güncellemeyi uygulayın.

​

Şablon Düzenleyici

Şablon Düzenleyici, panel içindeki ana düzenleme alanıdır. Bir drawer içinde açılır. Sol tarafta dosya ağacı, sağ tarafta ise editör alanı bulunur. Değişmiş dosyalar ağaçta işaretli görünür, bu da hangi dosyaların düzenlendiğini takip etmeyi kolaylaştırır. Üst tarafta genelde iki temel işlem bulunur: Değişiklikleri Kaydet Mevcut dosyanın içeriğini kaydeder. Değişiklikleri Geri Al Mevcut dosya üzerindeki override içeriğini geri alır. Panel üzerinden yapılan şablon çalışmalarının büyük kısmı bu düzenleyici içinde yürütülür.

​

Günlük kullanım akışı

Günlük kullanımda akış genelde oldukça basittir.

​

Panelden şablon düzenleme

1. Şablonlar sayfasını açın.
2. Doğru kapsamı seçin.
3. Gerekirse temayı belirleyin.
4. Arama veya dosya listesi ile ilgili dosyayı bulun.
5. Düzenle butonuna tıklayın.
6. Editör içinde değişikliği yapın.
7. Dosyayı kaydedin.
8. Gerekirse Şablon Değişiklikleri ekranından farkı tekrar kontrol edin.

Bu, panel üzerinden çalışan geliştiriciler için en yaygın akıştır.

​

Tek dosyayı geri alma

Sadece bir dosyadaki değişikliği geri almak istiyorsanız:

1. Şablonlar veya Şablon Değişiklikleri ekranını açın.
2. İlgili dosyayı bulun.
3. Geri Al butonuna tıklayın.
4. İşlemi onaylayın.

Bu işlemden sonra ilgili dosyanın override içeriği silinir veya sıfırlanır.

​

Tüm değişiklikleri geri alma

Seçili kapsam veya tema içindeki tüm değişiklikleri sıfırlamak istiyorsanız:

1. Şablonlar veya Şablon Değişiklikleri ekranını açın.
2. Tüm şablon değişikliklerini geri al seçeneğini kullanın.
3. İşlemi onaylayın.

Bu işlem özellikle test bittiğinde veya ortamı hızlıca temizlemek istediğinizde işe yarar.

​

Eskimiş şablonları güncelleme

Çekirdek şablonlar güncellendiğinde, eski override dosyalarını gözden geçirmek gerekir. Genel akış şöyledir:

1. Eskimiş Şablonlar ekranını açın.
2. Gerekirse doğru kapsamı ve temayı seçin.
3. Önce farkı inceleyin.
4. Sonra ilgili dosyayı ya da tüm dosyaları güncelleyin.

Bu yaklaşım, override dosyalarını sistemin güncel yapısıyla uyumlu tutar.

​

SFTP iş akışı

Şablonlar sayfasındaki SFTP bağlantısı alan adına özel erişim bilgilerini üretir. Açılan modal içinde genelde şu bilgiler yer alır: Sunucu Port Kullanıcı adı Şifre Hızlı bağlantı URI bilgisi Sunulan işlemler genelde şunlardır: Bağlantıyı Kopyala Bağlantı bilgilerini kopyalar. SFTP Aç Bağlantı akışını doğrudan başlatır. SFTP, paneldeki şablon sistemiyle birlikte çalışır. Yani dosyaları uzaktan düzenleyebilir, ama yine de panel üzerinden takip etmeye devam edebilirsiniz. SFTP ile düzenleme yaptıktan sonra değişikliklerin panelde görünmesi birkaç saniye sürebilir. Hemen görünmüyorsa sayfayı yenileyip tekrar kontrol etmek gerekir.

​

Fark görünümü nasıl çalışır

Fark ekranı, tüm dosyayı ham biçimde göstermek yerine değişikliğe odaklanan bir görünüm sunar. Bu ekran sayesinde şunları daha kolay görürsünüz: Hangi dosyada değişiklik var. Değişiklik dosyanın neresinde yapılmış. Entegrasyon satırı neresi. Bir şey eklenmiş mi, silinmiş mi, değiştirilmiş mi. Sistem bazı backend bloklarını iç tarafta gizliyorsa, diff ekranında bu bölümler ham kod yerine etiketli bir görünümle gösterilebilir. Bu da değişikliği daha okunur hale getirir.

​

Önerilen çalışma şekli

Bazı küçük alışkanlıklar şablon yönetimini çok daha güvenli hale getirir. Önemli dosyalarda kaydetmeden önce farkı kontrol edin. Tek seferde çok büyük değişiklikler yapmak yerine küçük adımlarla ilerleyin. Çekirdek güncellemeden sonra mutlaka Eskimiş Şablonlar sayfasını kontrol edin. Yönetim paneli tarafındaki işlemleri AdminCP kapsamında yapın. Site tarafındaki işlemleri Normal Şablon kapsamında yapın. Bu yaklaşım, olası çakışmaları azaltır ve gerektiğinde geri dönüşü kolaylaştırır.

​

Sık karşılaşılan durumlar

​

Şablon yüklenemedi

Bunun birkaç nedeni olabilir: Dosya yolu seçilen tema ile uyuşmuyor olabilir. Yanlış kapsam seçilmiş olabilir. Dosya yüklenirken geçici bir hata oluşmuş olabilir. Ne yapılmalı: Önce kapsamı kontrol edin. Sonra temayı kontrol edin. Sayfayı yenileyip tekrar deneyin.

​

Geri aldım ama eski içerik hâlâ görünüyor

Bu durum bazen eski override dosyasının fiziksel olarak kalmasından veya sayfanın önbellekten yüklenmesinden kaynaklanır. Ne yapılmalı: Aynı dosya için Geri Al işlemini tekrar çalıştırın. Şablon Değişiklikleri ekranında kaydın kalktığını doğrulayın. Sayfayı önbelleksiz şekilde yenileyin.

​

SFTP ile düzenledim ama panelde hemen görünmüyor

Bu genelde senkronizasyon süreci henüz tamamlanmadığında olur. Ne yapılmalı: Şablonlar sayfasını yenileyin. İlgili dosyada fark görünümünü açın. Gerekirse dosyayı panel editöründen bir kez açıp tekrar kaydedin.

​

Kısa özet

Zonely şablon iş akışı birkaç temel ekran etrafında döner: Şablonlar Ana çalışma ekranıdır. Şablon Değişiklikleri Sadece değişmiş dosyaları gösterir. Eskimiş Şablonlar Çekirdek güncellemelerden sonra override dosyalarını senkron tutmak için kullanılır. Şablon Düzenleyici Dosyaları düzenlemek, kaydetmek ve geri almak için kullanılır. SFTP Uzaktan düzenleme yapmak için kullanılır, ancak panel akışıyla birlikte çalışır. Bu ekranlara alıştıktan sonra günlük şablon yönetimi oldukça rahat hale gelir. Çoğu işlem doğru dosyayı bulmak, güvenli şekilde düzenlemek, farkı kontrol etmek ve gerekirse geri almak etrafında döner.