Özel Bloklar — {custom} ve {customcomments}

{custom}, DLE'nin şablon tarafındaki en güçlü aracıdır: istediğiniz kriterlerle haber listesi üretir. {customcomments} aynı işi yorumlar için yapar. "İşte bunlar", "en çok okunanlar", "bu yazarın diğer yazıları" gibi bloklar bu iki etiketle kurulur.

1. {custom} — kendi haber bloğunuz

{custom name="one_cikan" category="1" limit="5" order="rating" cache="30m"}

{custom name="yeni" days="7" limit="4"}

{custom name="one_cikan"}

Tüm parametreler isteğe bağlıdır; en az birini belirtmeniz yeterlidir. Belirtmediğiniz parametreler sitenin genel ayarlarından gelir.

Parametreler

order — sıralama ölçütü

id_as_list yalnızca id= parametresiyle anlamlıdır. Rastgele bloklar için order="rand" kullanın; bu modda sabitleme ve yön ayarları devre dışıdır.

fixed — sabitlenmiş haberler

subcat — alt kategoriler

Örnek: 2 ve 3 numaralı kategoriler, 1 numaralı kategorinin alt kategorileri olsun.

available — hangi sayfada gösterilsin?

Değerler | ile birleştirilir: available="main|cat". Hiç yazılmazsa veya global verilirse her sayfada gösterilir.

Blok koşulu: [custom=X]

name= ile adlandırdığınız blok boş değilse, o adı kullandığınız koşul bloğu görünür. Başlık ve sarmalayıcıyı bu koşula koymak, "boş blok" görüntüsünü önler:

[custom=one_cikan]
<section class="featured">
    <h2>Öne çıkanlar</h2>
    {custom name="one_cikan" category="1" limit="5"}
</section>
[/custom=one_cikan]

Koşul bloğunun etiketin kendisini sarması gerekmez; blok sayfanın başka bir yerinde üretilebilir, koşul ise bambaşka bir yerde durabilir. Birden fazla bloğu birlikte sınayabilirsiniz:

Örnekler

{* 1 ve 2 numaralı yayınlar, tarihe göre *}
{custom id="1,2" order="date"}

{* Yalnızca 2 ve 7 numaralı kategoriler, 5. kayıttan sonra *}
{custom category="2,7" from="5" cache="yes"}

{* 10. kayıttan itibaren 5 kayıt *}
{custom order="date" from="9" limit="5"}

{* Son 2 güne ait 5 haber *}
{custom days="2" limit="5"}

{* Yalnızca sabitlenmiş haberler, en çok 3 tane *}
{custom fixed="only" limit="3"}

{* Ek alanında "Öne Çıkan" yazan haberler *}
{custom xfields="Öne Çıkan" limit="6"}

{* Ziyaretçinin yer imleri, ekleme sırasına göre *}
{custom favorites="yes" order="id_as_list"}

Varsayılan değerler

unique ve cache — iki pratik ayrıntı

navigation — blokta sayfalama

navigation="yes" verildiğinde blok, sayfalama bağlantıları üretir. Ancak bu yalnızca sayfalamayı destekleyen sayfalarda çalışır (ana sayfa, kategori sayfası gibi). Haber detayı veya statik sayfa gibi sayfalaması olmayan yerlerde DLE bu parametreyi yok sayar ve sayfalamayı kapatır.

2. {customcomments} — kendi yorum bloğunuz

Aynı mantıkla yorum listesi üretir. En sık kullanımı, ana sayfaya ya da kenar çubuğuna "son yorumlar" veya "en beğenilen yorumlar" bloğu koymaktır.

{customcomments name="pop_yorum" order="rating" limit="5" cache="1h"}

Blok koşulu, haber tarafındakiyle aynı kurallara sahiptir: [customcomments=…], [not-customcomments=…] ve virgül (hepsi) / dikey çizgi (herhangi biri) mantığı.

[customcomments=pop_yorum]
<aside class="widget">
    <h3>En beğenilen yorumlar</h3>
    {customcomments name="pop_yorum" order="rating" limit="5"}
</aside>
[/customcomments=pop_yorum]

Sık yapılan hatalar

Kontrol listesi

• Her bloğa anlaşılır ve tekil bir name= verdim.
• limit değerlerini küçük tuttum (her blok bir sorgu).
• Yoğun bloklara cache="30m" gibi bir süre verdim.
• Koşul adları name= değerleriyle birebir aynı.
• , (hepsi) ve | (herhangi biri) ayraçlarını bilinçli seçtim.
• Kullandığım template= dosyaları temada mevcut.
• available değerlerini gerçek modül adlarıyla yazdım.
• Blokları hem dar hem geniş ekranda, hem giriş yapmış hem ziyaretçi olarak test ettim.