DLE SSS (Sıkça Sorulan Sorular) v1.0 — Akordeon FAQ sayfası ve yönetim paneli

SSS (Sıkça Sorulan Sorular) nedir?

SSS, DataLife Engine 21 için kurulabilir tam bir eklenti paketidir. Ön yüze akordeon SSS sayfası, yönetim paneline soru yönetimi ekler. Veriler veritabanı tablosu değil, engine/data/faq.json dosyasında tutulur.

• Paket: dle-faq-sss.zip (içinde faq.xml)
• Sürüm: 1.0
• Uyumluluk: DLE 21.0+
• Ön yüz: SITENIZ/?do=faq
• Yönetim: admin.php?mod=faq — Sıkça Sorulan Sorular (Üçüncü taraf modüller)

Kurulum

1. Yönetim paneli → Eklenti yönetimi → Eklenti yükle.
2. Bu makaledeki ZIP içinden faq.xml dosyasını seçip yükleyin (XML’i tek başına yüklemeyin; paket ZIP’tir).
3. Listede SSS (Sikca Sorulan Sorular) görünür; aktif edin.

Kurulumda otomatik olarak şunlar olur:

• engine/data/faq.json oluşturulur (yoksa boş dizi),
• public/adminpanel/images/faq.png simgesi yazılır (yoksa),
• aktif temada faq.tpl yoksa oluşturulur (varsa dokunulmaz),
• _admin_sections menü kaydı eklenir.

Dil uyarısı: Eklenti kurulumda mevcut language/Turkish ve language/English dosyalarını yamalar. Siteniz başka bir dil kullanıyorsa faq.xml içindeki after operasyonlarını o dile uyarlayın.

$config['allow_plugins'] açık olmalıdır.

Yaşam döngüsü

Neden phpdisable? DLE, eklenti pasif edildiğinde _plugins_files.active alanını 0 yapar; oluşturulan dosyalar devre dışı kalır ve ?mod=faq açılamaz. Menü kaydı durursa panelde kırık link kalır.

Korunanlar: faq.json verisi ve faq.tpl şablonu silinmez. Yalnızca menü kaydı ve simge temizlenir.

Yönetim paneli bağlantısı

Menü, DLE API ile yazılır (elle SQL yok):

include_once ENGINE_DIR . '/api/api.class.php';
$dle_api->install_admin_module('faq', 'Sıkça Sorulan Sorular', 'SSS yönetimi', 'public/adminpanel/images/faq.png', '1');

• Menü engine/skins/default.skin.php içinde 5. grup ($lang['admin_other_section'] / Üçüncü taraf modüller) altında listelenir; engine/inc/options.php aynı kayıtları kart olarak gösterir.
• Simge yalnızca kartta görünür; sol menüde modüller ikonsuzdur.
• allow_groups sadece görünürlüktür. Doğrudan admin.php?mod=faq yazan biri için sayfa kendi kontrolünü yapar: grup 1 değilse msg("error", ...).

Paketin içeriği (9 dosya, 10 operasyon)

Şablon (templates/<Skin>/faq.tpl) XML ile oluşturulamaz: DLE dosya operasyonları yalnızca .php ve .lng kabul eder. Bu yüzden phpinstall içinde file_put_contents kullanılır. PHP kancalarına <?php etiketi koyulmaz (eval ile global scope).

Korumalı dosyalara operasyon yazılmaz: engine/classes/mysql.php, plugins.class.php, data/config.php, dbconfig.php, socialconfig.php, videoconfig.php.

Nasıl kullanılır? (yönetim)

1. admin.php?mod=faq açın (grup 1).
2. Soru ekle ile modalı açın. Soru düz metin, cevap TinyMCE ile HTML’dir.
3. Kaydet / düzenle / sil. Satırdaki anahtarla aktif-pasif değiştirin.
4. Satırları sürükleyerek sıralayın (Sortable). Sıra faq.json dizisinin sırasıdır.
5. Ön yüzde yalnızca active = 1 kayıtlar, bu sırayla görünC�r.

JSON kayıt yapısı: q (soru), a (cevap HTML), active (0/1).

Cevap alanında TinyMCE

• Editör JS’si yalnızca ?mod=faq sayfasında yüklenir.
• Bootstrap modal gizliyken init edilirse editör bozuk çıkar. Init shown.bs.modal olayında; temizlik tinymce.remove ile openFaqModal() başında ve hidden.bs.modal sonrasında yapılır.
• Kaydetmede içerik tinymce.get('faq_a').getContent() ile alınır.
• Araç çubuğu DLE haber editörüyle aynı düzendedir: iki satır, fontformatting / align grupları, forecolor / backcolor, quickbars, kelime sayacı, fullscreen, table, charmap, hr, undo/redo, removeformat.
• DLE’nin kutu stilleri (Bilgi / Uyarı / Hata / Kenarlıklı / Gölgeli / renkli arka planlar) ve başlık blokları dahildir.
• Koyu tema (dle_theme_dark → oxide-dark), content_css: public/editor/css/content.css — DLE ile aynı.
• Resim/video yükleme yoktur (haber editöründeki upload sunucusu bağlı değildir). Resim için image diyaloğunda kaynak URL kullanın.
• Arayüz dili $lang['language_code'] (public/editor/tiny_mce/langs/tr.js).

İçerik temizleme (güvenlik)

Hem engine/ajax/faq.php (kaydetme) hem engine/modules/faq.php (gösterim) faq_clean_html() kullanır. İki yerde aynı olmalıdır.

• Tehlikeli bloklar içerikleriyle silinir: script, style, iframe, object, embed, svg, math, form, input, button … HTML yorumları silinir.
• Etiket beyaz listesi: p, div, span, br, strong/b, em/i, u, s, ul, ol, li, blockquote, h1–h6, code, pre, a, img, hr, table/thead/tbody/tr/td/th.
• Öznitelik beyaz listesi (etiket başına): style, href, target, title, src, alt, width, height, colspan, rowspan.
• style ayrıca özellik beyaz listesinden geçer (color, background-color, font-*, text-align, line-height, padding, margin, border*, border-radius, box-shadow, list-style-type …). url(, expression(, @import ve { } < > " ' içeren değerler reddedilir.
• <a> href yoksa kaldırılır; kalanlara rel="nofollow noopener" eklenir.
• <img> yalnızca jаvascript: / dаta: dışı kaynaklarla kabul edilir.

Bu, regex tabanlı pragmatik bir temizleyicidir; içeriği yalnızca grup-1 girdiği için yeterlidir. Yazarlara/üyelere açacaksanız DLE’nin ParseFilter / HTMLPurifier’ı ile değiştirin.

Geriye dönük uyumluluk: içerikte < yoksa (düz metin) eski davranış korunur — htmlspecialchars + nl2br.

Ön yüz şablonu ve etiketler

Modülün şablona verdiği yer tutucular yalnızca ikidir: {faq-title} ve {faq-body}.

Modülün ürettiği HTML sözleşmesi (faq.tpl CSS’i bunlara bağlıdır):

div.faq-list
div.faq-item
div.faq-question   -> "N. soru" + <i class="fa fa-chevron-down"></i>
div.faq-answer     -> cevap HTML'i
div.faq-empty      -> kayıt yoksa

Kurulumun yazdığı varsayılan faq.tpl: başlık + gövde, gömülü CSS (kenarlıklı kart, tıklanınca .open), FontAwesome ok ikonu, tıklama ile akordeon JS’i.

Ne değiştirilir → hangi dosya

CSS/JS’i tema dosyalarına taşımak

1. templates/<Tema>/css/faq.css ve js/faq.js oluşturun.
2. faq.tpl içindeki <style> yerine {include file="{THEME}/css/faq.css"}, script yerine {include file="{THEME}/js/faq.js"} yazın.

{THEME} çıktıda $config['http_home_url'] . 'templates/' . $config['skin'] olur.

Dokunulmaması gerekenler

• engine/engine.php ve engine/ajax/controller.php içindeki eklenti satırları (case "faq", whitelist). searchcode çekirdeğe aittir; elle değişirse güncelleme bozulur.
• Korumalı çekirdek / ayar dosyaları.
• HTML temizleyiciyi yalnızca tek dosyada değiştirmek.

Başka siteye uyarlama — kontrol listesi

1. XML’i yükleyip aktive edin.
2. Kendi diliniz için website.lng ve adminpanel.lng anahtarlarını ekleyin (paket yalnızca TR/EN yamalar).
3. Aktif temanın faq.tpl dosyasını düzenleyin (yalnızca iki yer tutucu doldurulur).
4. ?mod=faq ile iaçerik girin, ?do=faq ile test edin.
5. Bağka sayfada göstermek: en basit yol ?do=faq bağlantısıdır. Aynı sayfaya gömmek için ikinci bir case veya ortak fonksiyon gerekir.
6. Tema değiştirirseniz faq.tpl’i yeni temanın klasörüne kopyalayın. phpinstall yalnızca o anki aktif temaya ve yalnızca dosya yoksa yazar.

Güvenlik ve log

• Tüm uçlarda user_hash (CSRF), $db->safesql, htmlspecialchars(..., ENT_QUOTES, 'UTF-8') ve grup-1 yetki kontrolü vardır.
• Yönetim AJAX’ı native adminfunction.php değildir; engine/ajax/faq.php + controller.php whitelist yaması zorunludur.
• Silme/kaydetme USERPREFIX_admin_logs tablosuna 2001–2005 kodlarıyla yazılır. Okunabilir etiket için adminlogs.lng içine admin_logs_action_2001 … 2005 eklenebilir (opsiyonel).

Yama uygulanmadıysa

?mod=plugins → ilgili eklenti → hata listesi (PREFIX_plugins_logs). En sık neden: searchcode metninin DLE sürümünde değişmiş olması.

Kaldırma

phpdelete menüyü kaldırır ve public/adminpanel/images/faq.png simgesini siler. faq.json ve faq.tpl kalır (içeriğiniz / tema düzenlemeniz). İsterseniz bunları elle silin.