Genel Bilgiler

DataLife Engine, haberleri ve çeşitli modülleri görüntülemek için şablon sistemi kullanmanıza olanak tanır. Motorda şablonların kullanımını mümkün olduğunca basitleştirmeye çalıştık. Kullanmak için programlama dillerini bilmenize gerek yoktur, sadece HTML dili yeterlidir. Ancak, şablonları tam ve kolay bir şekilde kullanmak için şablon kullanım kılavuzunu dikkatle okumanızı öneririz.

Şablonlar Nedir?

DLE'de şablon, /templates/ klasöründe bulunan bir klasördür. İçerisindeki dosyalar, aynı şablona ait dosyalardır.

Şablonları Dahil Etme

Ayrıca {include file="my_block.tpl"} etiketini kullanarak bir şablonu diğerine dahil edebilirsiniz. Bu etiket, belirtilen my_block.tpl dosyasını şablona dahil eder. Bu etiket, birden fazla etiketin kullanıldığı karmaşık bir düzende şablonun yapısını basitleştirmek için tasarlanmıştır. Bu etiket tüm .tpl şablon dosyalarında çalışır. Bağlanan dosya, şablon klasörünüzde veya alt klasörlerinde olmalıdır.

Farklı bir şablonda bulunan bir şablon dosyasını bağlamak istiyorsanız, komut dosyasının kök dizininden tam yolu kullanmalısınız. Örneğin, {include file="/templates/mytemplate/my_block.tpl"}.

Şablon Etiketlerinin Çalışması

Bağlanabilir şablonun etiketleri, o dosyayı dahil etmek için kullanılan şablonda izin verilen etiketlerle aynı olmalıdır. Örneğin, my_block.tpl main.tpl'ye bağlanıyorsa, main.tpl'de izin verilen etiketler bu dosyada da çalışacaktır.

Örnek Şablon Dahil Etme

<!-- main.tpl dosyası -->
<html>
<head>
    <title>{title}</title>
</head>
<body>
    <header>
        {include file="header_block.tpl"}
    </header>
    
    <div class="content">
        {content}
    </div>
    
    <footer>
        {include file="footer_block.tpl"}
    </footer>
</body>
</html>

Şablon Dosya Yapısı

Tipik bir DataLife Engine şablonu genellikle aşağıdaki temel dosyaları içerir:

  • main.tpl - Ana şablon dosyası, site düzeninin temelini oluşturur
  • fullstory.tpl - Tam makale görüntüleme şablonu
  • shortstory.tpl - Kısa makale özeti şablonu
  • static.tpl - Statik sayfalar için şablon
  • comments.tpl - Yorumlar için şablon
  • ve diğer çeşitli modül şablonları

Önemli Not

Şablonlarınızı değiştirmeden önce her zaman yedeklemeniz önemle tavsiye edilir. Bu, beklenmeyen hataların oluşması durumunda sitenizin düzenini geri yüklemenize olanak tanır.

Şablon Etiketlerinin Kullanımı

DataLife Engine şablonlarında kullanılan etiketler genellikle iki formatta olabilir:

  1. {etiketi} - Tek etiketler, değer veya bilgi göstermek için kullanılır
  2. [etiket]İçerik[/etiket] - Çift etiketler, içeriği belirli koşullara göre görüntülemek için kullanılır

Bu etiketler, şablon içinde dinamik içeriğin nerede ve nasıl görüntüleneceğini kontrol etmenizi sağlar.

Şablonlarda Koşullu İçerik Örneği

<!-- Kullanıcı giriş yapmışsa görüntüle -->
[login]
    <div class="welcome">Merhaba, {login}!</div>
    <div class="user-panel">
        <a href="/profile/">Profilim</a>
        <a href="/pm/">Mesajlarım ({new-pm})</a>
        <a href="/?action=logout">Çıkış</a>
    </div>
[/login]

<!-- Kullanıcı giriş yapmamışsa görüntüle -->
[not-login]
    <div class="auth-form">
        <a href="/?do=login">Giriş</a> veya
        <a href="/?do=register">Kayıt Ol</a>
    </div>
[/not-login]