RSS Bilgilendirici — Yönetim Modülü

Bu modül, başka sitelerin RSS akışlarını kendi sayfanızda blok olarak göstermenizi sağlar. Paneldeki adı “Sitedeki RSS bilgilendiricileri”, ekran başlığı “Site bilgilendiricileri için RSS listelerini yönetme” olan bu bölüm bir içerik aktarma aracı değildir: dış kaynaktan haber oluşturmaz, yalnızca dışarıdaki veriyi sayfanızda gösterir.

Konu	Ayrıntı
Yönetim modülü	`engine/inc/rssinform.php`
Panel adresi	`admin.php?mod=rssinform`
Yetki anahtarı	`admin_rssinform`
Ne yapar?	Dış RSS akışını sayfada blok olarak gösterir
Ön yüz etiketi	`{inform_ETIKET}` — `main.tpl` içinde çağrılır
Varsayılan şablon	`informer.tpl` — her kayıt için ayrı şablon verilebilir
Önbellek	`informer_<id>` anahtarıyla; kaynak belirli aralıkla yeniden çekilir
Şablon ayrıntısı	RSS Bilgilendirici — informer.tpl

i

Gösterim, aktarma değildir Bu modül dış akıştaki içeriği veritabanınıza yazmaz. Haber oluşmaz, kategori altında yeni kayıt çıkmaz. Sayfa yüklendiğinde (önbelleğe göre) dış akıştan alınan öğeler, seçtiğiniz şablonla bir blok olarak basılır.

İşlem (action) değerleri

Modül yalnızca dört işlem değerini kullanır. Liste varsayılan görünümdür; kaydetme işlemleri ayrı adımlarda yapılır.

action	Görevi
`add`	Yeni bilgilendirici formunu gösterir
`edit`	Var olan bilgilendiricinin düzenleme formunu gösterir
`doadd`	Yeni bilgilendiriciyi kaydeder
`doedit`	Düzenlenen bilgilendiriciyi kaydeder

Kayıt formu alanları

Aşağıdaki adlar, formun gönderdiği alan adlarıdır (name değerleri). Alanların anlamları ve sınırları doğrudan kaynaktan alınmıştır.

Alan	Anlamı
`rss_tag`	Bilgilendiricinin etiket adı. Ön yüzde `{inform_ETIKET}` ile çağrılır. `totranslit` ile sadeleştirilir (küçük harf, boşluk → tire). Azami 40 karakter.
`rss_descr`	Kısa açıklama. Azami 250 karakter.
`rss_url`	Kaynak RSS akışının adresi.
`rss_date_format`	Tarihin gösterim biçimi; panelde tarih biçimi için yardım bağlantısı vardır.
`rss_template`	Kullanılacak şablonun adı (`.tpl` uzantısı olmadan). Boş bırakılırsa `informer.tpl` kullanılır. Azami 40 karakter.
`rss_max`	Bu akıştan alınacak haber sayısı.
`rss_tmax`	Başlıktaki azami karakter sayısı; aşılırsa başlık kısaltılır. `0` = sınırsız.
`rss_dmax`	Haberdeki azami karakter sayısı; aşılırsa metin kısaltılır. `0` = sınırsız.
`category`	Öğelerin atanacağı kategori bilgisi (seçim listesi, dizi).

!

rss_template her kayıt için ayrıdır Aynı informer.tpl dosyasını kullanmak zorunda değilsiniz. Farklı bilgilendiriciler için ortak.tpl, partner-ust.tpl gibi dosyalar tanımlayıp her birini farklı tasarımla gösterebilirsiniz. Ancak adı yazdığınız dosya mevcut olmalıdır; yoksa blok boş görünür.

Ön yüz kullanımı

Bilgilendirici, main.tpl içine etiket adıyla yerleştirilir. Etiket adı, kayıtta girdiğiniz rss_tag değeridir. Etiket partner ise kullanım {inform_partner} biçimindedir.

<aside class="partner-block">
    <h2>İş ortağımız</h2>
    <ul>
        {inform_partner}
    </ul>
</aside>

Şablon motoru, main.tpl derlenirken {inform_ETIKET} etiketini ilgili blok içeriğiyle değiştirir. Yani içerik, etiketin bulunduğu konumda üretilir.

Önbellek davranışı

Konu	Ayrıntı
Anahtar	`informer_<id>`
Amaç	Her sayfa görüntülemesinde dış kaynağa istek gitmemesi
Yenileme	Kaynak, belirli aralıkla yeniden çekilir
Sonuç	Kaynaktaki değişiklik anında değil, yenileme sonrası görünür

Karıştırılmaması gereken modüller

DLE’de “RSS” adını taşıyan üç ayrı iş vardır ve bunlar sıkça birbirine karıştırılır. Bu sayfa yalnızca gösterim ile ilgilidir.

Modül	Görevi
`admin.php?mod=rssinform` Yetki: `admin_rssinform`	Bu sayfa: dış RSS içeriğini sayfada blok olarak gösterir.
`admin.php?mod=rss` Yetki: `admin_rss`	Dış RSS akışlarını haber olarak içe aktarır (tablo `PREFIX_rss`). Aktarma yapar, gösterim yapmaz.
`engine/rss.php`	Sitenin kendi RSS akışını yayımlar (dışa aktarma). Bkz. RSS Dışa Aktarma.

Bilgilendirici oluşturma akışı

Yetkiyi doğrulayın Grubunuzda admin_rssinform izni açık olmalıdır.
Panel modülünü açın admin.php?mod=rssinform adresine gidin.
Yeni kayıt formunu açın action=add ile formu getirin.
Etiket ve kaynağı girin rss_tag ile rss_url alanlarını doldurun; etiket ön yüzdeki çağrı adı olacaktır.
Şablon ve sınırları belirleyin rss_template, rss_max, rss_tmax, rss_dmax ve tarih biçimini ayarlayın.
Kaydedip yayına alın Formu kaydedin (doadd) ve etiketi main.tpl içine yerleştirin.

Sık yapılan hatalar

Hata	Sonuç
`rss_tag` ile `{inform_X}` adının uyuşmaması	Etiket sayfada olduğu gibi görünür, blok çıkmaz
Şablon adını yazıp dosyayı oluşturmamak	Blok boş görünür
Dış kaynağa her istekte gidildiğini sanmak	Önbellek vardır; içerik yenilemeye kadar eski kalır
Kaynak akışın geçersiz olması	Blok boş kalır
Etiketi `main.tpl` yerine rastgele bir şablon içine koymak	Bilgilendirici beklenen yerde üretilmez
Haberi sayfada göstermekle akışı içe aktarmayı karıştırmak	Yanlış modül kullanılır; beklenen içerik oluşmaz

Kontrol listesi

Grubumda admin_rssinform izni açık.
rss_tag değeri ile main.tpl içindeki {inform_X} etiketi birebir aynı.
rss_url geçerli bir dış RSS akışını gösteriyor.
rss_template adı verildiyse ilgili dosya mevcut; boşsa informer.tpl kullanılıyor.
rss_max, rss_tmax ve rss_dmax değerlerini ihtiyaca göre ayarladım.
Önbellek yenilendikten sonra blok içeriğini doğruladım.
Bu modülün içeriği aktarmadığını, yalnızca gösterdiğini biliyorum.