1. Eklenti Hakkında
Hoş Geldin Mesajı, DataLife Engine 19.0 için özel olarak geliştirilmiş bir yönetici modülüdür. Sitenize gelen ziyaretçilere belirli tarih aralıklarında otomatik olarak görsel ve metin içerikli karşılama mesajları göstermenizi sağlar.
Eklenti, DLE'nin kendi template sistemine entegre olur ve {hosgeldin} etiketi aracılığıyla istediğiniz her template dosyasında kullanılabilir. Kampanya dönemleri, özel günler, duyurular veya kalıcı karşılama mesajları için idealdir.
2. Temel Özellikler
2.1 Admin Paneli Yönetimi
Eklenti, DLE yönetici paneline tamamen entegre bir arayüz sunar. Sol menüde "Hoş Geldin Mesajı" olarak listelenir ve şu işlemleri destekler:
• Tüm mesajların liste görünümünde yönetimi
• Anlık durum göstergesi: Yayında / Bekliyor / Sona Erdi / Pasif
• Tek tıkla düzenleme ve silme
• Birden fazla mesaj oluşturma ve sıralama
2.2 İçerik Yönetimi
Her hoş geldin mesajı için aşağıdaki içerik alanları mevcuttur:
|
Başlık |
Mesajın ana başlığı. Maksimum 255 karakter. |
|
Mesaj Metni |
HTML destekli içerik alanı. <b>, <i>, <a>, <span>, <br> gibi temel etiketler kullanılabilir. Maksimum 3000 karakter. |
|
Resim URL |
Harici veya dahili bir resim URL'si girilebilir. |
|
Resim Yükleme |
Bilgisayardan JPG, PNG, GIF veya WEBP formatında resim yüklenir. Maksimum 2MB. Dosyalar /upload/hosgeldin/ klasörüne kaydedilir. |
|
Buton Linki |
Ziyaretçinin tıkladığında yönlendirileceği URL adresi. |
|
Buton Yazısı |
Link butonunun üzerinde görünecek metin. Varsayılan: "Devamını Oku". |
2.3 Tarih & Zamanlama Sistemi
Eklentinin en güçlü özelliklerinden biri gelişmiş tarih yönetim sistemidir:
• Başlangıç ve bitiş tarihleri için görsel tarih seçici (date picker)
• Mesaj yalnızca belirlenen tarih aralığında otomatik olarak görünür
• Tarih aralığı dışındaki mesajlar otomatik gizlenir, herhangi bir müdahale gerekmez
• Admin listesinde anlık durum takibi: Bekliyor (tarih gelmedi), Yayında, Sona Erdi
• Aktif/Pasif toggle ile tarihten bağımsız hızlı açma-kapama
2.4 Çoklu Mesaj & Sıralama
Aynı anda birden fazla aktif mesaj yönetilebilir:
• Sınırsız sayıda mesaj eklenebilir
• Sıralama numarası ile gösterim önceliği ayarlanabilir (küçük sayı = önce gösterilir)
• Her mesaj bağımsız tarih aralığına sahip olabilir
• Aynı anda en fazla 5 aktif mesaj template'de gösterilir
3. Kurulum
3.1 Dosya Yapısı
Eklenti iki ana PHP dosyasından oluşur:
|
engine/inc/hosgeldin.php |
Admin panel modülü. Tüm yönetim arayüzü bu dosyadadır. |
|
engine/modules/functions_hosgeldin.php |
{hosgeldin} template etiketini işleyen fonksiyon dosyası. |
3.2 Kurulum Adımları
Adım 1 — Dosyaları Yükle
İki PHP dosyasını FTP aracılığıyla yukarıdaki hedef konumlara yükleyin.
Adım 2 — Veritabanı Kurulumu
phpMyAdmin'de SQL sekmesini açın. PREFIX yerine kendi prefix değerinizi yazarak aşağıdaki sorguları çalıştırın:
Adım 3 — functions.php Entegrasyonu
engine/modules/functions.php dosyasının en sonuna şu satırı ekleyin:
Adım 4 — main.php Entegrasyonu
engine/modules/main.php dosyasında $tpl->compile('main') satırından hemen önce ekleyin:
Adım 5 — Template Etiketi
DLE Admin → Template Yönetimi → main.tpl (veya tercih ettiğiniz template) dosyasını açın. Mesajın görüneceği konuma ekleyin:
Adım 6 — Klasör İzni
upload/hosgeldin/ klasörünü oluşturun ve 755 iznini verin.
4. Kullanım Kılavuzu
4.1 Yeni Mesaj Ekleme
1. Admin paneline giriş yapın.
2. Sol menüden "Hoş Geldin Mesajı" modülüne tıklayın.
3. "+ Yeni Mesaj Ekle" butonuna tıklayın.
4. Başlık ve mesaj metni alanlarını doldurun (zorunlu).
5. İsteğe bağlı olarak resim URL'si girin veya bilgisayardan resim yükleyin.
6. Başlangıç ve bitiş tarihlerini tarih seçici ile ayarlayın.
7. "Aktif Et" kutucuğunu işaretleyin ve Kaydet'e tıklayın.
4.2 Durum Açıklamaları
|
✓ Yayında (Yeşil) |
Mesaj aktif, bugün tarih aralığı içinde ve ziyaretçilere görünüyor. |
|
Bekliyor (Sarı) |
Mesaj aktif fakat başlangıç tarihi henüz gelmedi. |
|
Sona Erdi (Gri) |
Bitiş tarihi geçti, mesaj otomatik olarak gizlendi. |
|
Pasif (Kırmızı) |
Aktif Et kutucuğu işaretlenmedi, tarihten bağımsız gizli. |
5. Teknik Detaylar
5.1 Önbellek Sistemi
Performans için eklenti veritabanı sorgularını önbellekler:
• Sorgu sonuçları engine/cache/hosgeldin_cache.php dosyasına PHP array olarak yazılır
• Önbellek süresi: 1 saat (3600 saniye)
• Admin panelinden yapılan her kaydetme ve silme işleminde önbellek otomatik temizlenir
• Manuel temizlik için engine/cache/hosgeldin_cache.php dosyasını silebilirsiniz
5.2 Güvenlik
• Tüm kullanıcı girdileri strip_tags() ve DLE'nin safesql() fonksiyonuyla temizlenir
• Mesaj alanında yalnızca belirli HTML etiketlerine izin verilir
• Dosya yükleme: Sadece resim uzantıları (JPG, PNG, GIF, WEBP), maksimum 2MB
• Admin sayfasına erişim yalnızca grup 1 (süper admin) ile sınırlıdır
• DATALIFEENGINE sabiti kontrolü ile doğrudan URL erişimi engellenir
5.3 Veritabanı
Eklenti tek bir tablo kullanır: PREFIX_hosgeldin
|
id |
INT AUTO_INCREMENT — Birincil anahtar |
|
baslik |
VARCHAR(255) — Mesaj başlığı |
|
mesaj |
TEXT — HTML içerikli mesaj metni |
|
resim |
VARCHAR(500) — Resim URL veya yolu |
|
url |
VARCHAR(500) — Buton bağlantı adresi |
|
url_metin |
VARCHAR(255) — Buton üzerindeki yazı |
|
baslangic |
DATE — Yayın başlangıç tarihi |
|
bitis |
DATE — Yayın bitiş tarihi |
|
aktif |
TINYINT(1) — Aktif/Pasif durumu |
|
siralama |
INT — Gösterim öncelik sırası |
|
olusturma |
DATETIME — Kayıt oluşturma zamanı |
6. Sorun Giderme
|
Mesaj görünmüyor |
Admin panelinde Aktif kutucuğu işaretli mi? Bugünün tarihi başlangıç-bitiş aralığında mı? engine/cache/hosgeldin_cache.php dosyasını silin. |
|
{hosgeldin} çıkmıyor |
functions.php'ye include satırı eklendi mi? main.php'ye hosgeldin_parse_tag satırı eklendi mi? |
|
Admin menüde yok |
PREFIX_admin_sections tablosuna INSERT sorgusu çalıştırıldı mı? |
|
Resim yüklenmiyor |
upload/hosgeldin/ klasörü var mı ve 755 iznine sahip mi? |
|
Fatal error: msgbox |
Eski v1.0 hosgeldin.php kullanılıyor. v2.0 ile değiştirin. |
Hoş Geldin Mesajı Eklentisi v2.0
DataLife Engine 19.0 uyumlu · erenyumak.com
