XOOPS — DATALIFE

XCREATE — XOOPS İÇİN GELİŞMİŞ İÇERİK YÖNETİM MODÜLÜ

Xcreate, XOOPS platformu için tasarlanmış kategori tabanlı dinamik bir içerik yönetim modülüdür. Standart haber veya makale modülünün çok ötesine geçen xcreate; 30 ilave alan tipi, görsel blok oluşturucu, 15 blok düzeni, 10 widget bloğu, SEO araçları, yorum sistemi, iletişim formu motoru, Smarty eklentileri, debug loglama ve mevcut kurulumlardan veri göçü desteğiyle tam anlamıyla kurumsal düzeyde bir içerik katmanı sunar.




================================================================
BÖLÜM 1: TEMEL İÇERİK YÖNETİMİ
================================================================

1.1 İÇERİK YAPISI
------------------

Her xcreate içeriği şu çekirdek alanlardan oluşur:

- Başlık
- Özet / Kısa Açıklama
- Tam İçerik (XOOPS aktif WYSIWYG editörü ile — TinyMCE, FCKeditor vb.)
- Kapak Görseli
- Slug (SEO dostu URL tanımlayıcısı; otomatik üretilir, elle düzenlenebilir)
- Yayın Durumu (taslak / yayında / arşiv)
- Öne Çıkan İşareti (featured flag)
- Görüntülenme Sayacı
- Yayın ve Güncelleme Tarihleri
- Yazar (XOOPS kullanıcısı)
- Kategori Ataması
- SEO Meta Alanları (başlık, açıklama, OG, Twitter Card, JSON-LD)
- Derecelendirme Puanı ve Oy Sayısı


1.2 KATEGORİ SİSTEMİ
----------------------

xcreate hiyerarşik kategori yapısını destekler. Her kategori için:

- Kategori adı ve açıklaması
- Üst kategori seçimi (iç içe hiyerarşi)
- Kategori görseli
- Sıralama ağırlığı
- O kategoriye özel ilave alanlar tanımı
- Mail bildirimi ayarları (iletişim formu entegrasyonu için)
- Başarılı gönderim mesajı ve Reply-To adresi


1.3 KULLANICI YETKİLENDİRME VE İZİNLER
-----------------------------------------

xcreate, XOOPS'un yerleşik grup sistemiyle tam entegre bir yetki
motoru içerir (class/permission.php). Admin panelinden grup bazında
şu yetkiler ayarlanabilir:

- İçerik görüntüleme
- İçerik oluşturma / gönderme
- İçerik düzenleme ve silme
- Admin paneline erişim
- Yorum yapabilme



================================================================
BÖLÜM 2: İLAVE ALANLAR (CUSTOM FIELDS) — 30 ALAN TİPİ
================================================================

xcreate'in en güçlü özelliği ilave alan sistemidir. Admin panelinden
istediğiniz kadar alan ekleyebilir; her alanı bir veya birden fazla
kategoriye atayabilirsiniz.

----------------------------------------------------------------
2.1 TEMEL GİRİŞ ALANLARİ
----------------------------------------------------------------

TEXT — Kısa Metin
Tek satırlık metin girişi.
Doğrulama: minlength, maxlength, pattern (regex), min, max, step.
Örnek: ürün kodu, altyazı, kısa not.

TEXTAREA — Uzun Metin
Çok satırlı düz metin alanı.
Örnek: açıklama, biyografi, teknik detay.

EDITOR — Zengin Metin Editörü
XOOPS aktif WYSIWYG editörünü kullanır.
HTML içerikler için; varsayılan editör ne ise onu açar.

NUMBER — Sayı
Yalnızca sayısal değer alır. min/max/step doğrulaması desteklenir.
Örnek: fiyat, adet, yıl, puan.

EMAIL — E-posta
Geçerli e-posta formatını zorunlu kılan alan.

URL — Bağlantı
Geçerli URL formatında giriş alanı.

COLOR — Renk Seçici
HTML color picker ile HEX renk kodu girişi.

DATE — Tarih
Takvim seçici ile tarih girişi (YYYY-MM-DD).

DATETIME — Tarih ve Saat
Tarih + saat birlikte (datetime-local).


----------------------------------------------------------------
2.2 SEÇİM ALANLARİ
----------------------------------------------------------------

SELECT — Açılır Liste
Önceden tanımlı seçenekler arasından tekil seçim.
Seçenekler xcreate_field_options tablosunda saklanır.

CHECKBOX — Çoklu Onay Kutusu
Birden fazla seçeneğin işaretlenebildiği alan.
Değerler virgülle ayrılmış liste olarak kaydedilir.

RADIO — Radyo Düğmeleri
Seçenek listesinden yalnızca bir tanesinin seçilmesi için.



----------------------------------------------------------------
2.3 MEDYA ALANLARİ
----------------------------------------------------------------

IMAGE — Tekli Görsel
Sunucuya görsel yükleme (/uploads/xcreate/ klasörüne).
Yüklenen görselin önizlemesi gösterilir. Mevcut görsel korunur.
Tekrarlanabilir alanda her satır için bağımsız görsel.

GALLERY — Çoklu Görsel Galerisi
Ctrl/Cmd ile birden fazla görsel seçimi (multiple file input).
Yüklenen görseller grid önizleme ile listelenir; her biri
ayrı silinebilir. Tekrarlanabilir galeri ayrı isim şeması kullanır.

FILE — Dosya Yükleme
Her türlü dosya türü için (PDF, DOC, ZIP vb.).
İzin verilen uzantılar modül ayarlarından belirlenir.

FILEINFO — Gelişmiş Dosya Yönetimi
Sürükle-bırak destekli tam özellikli dosya alanı.

Özellikler:
• Dosya tipi ikonları: PDF, Word, Excel, ZIP, ses, video, görsel vb.
• İzin verilen uzantı filtresi (field_options ile konfigüre edilir)
• Maksimum boyut kontrolü (MB cinsinden)
• AJAX ile anlık yükleme ilerleme çubuğu (progress bar)
• İndirme sayacı takibi (downloads alanı)
• Dosya boyutunu okunur formata çevirme (B / KB / MB / GB)
• Kaldır butonu ile mevcut dosyayı temizleme
• JSON formatında saklanır:
{filename, original_name, ext, size, mime, downloads}

EMBED — Medya Gömme
URL girerek video/ses içeriği gömme alanı.

Desteklenen platformlar:
• YouTube (normal izleme, Shorts, Live)
• Vimeo
• Dailymotion
• Twitch (kanal ve video)
• SoundCloud
• Spotify (parça, playlist, albüm, episode, show)
• Google Maps embed
• Herhangi bir genel URL (generic iframe)

Admin formunda URL girilirken anlık önizleme gösterilir.
Genişlik, yükseklik ve autoplay field_options ile ayarlanır.


----------------------------------------------------------------
2.4 YAPISAL VERİ ALANLARİ
----------------------------------------------------------------

TABLE — Veri Tablosu
Admin tarafından sütun adları ve tipleri önceden tanımlanmış
interaktif tablo girişi.

Sütun tipleri: text, number, date, datetime, url, email,
color, dropdown, checkbox
Özellikler: satır ekle/sil, senkronize et butonu, satır sayacı.
JSON: {rows: [[...], [...]]}
Yapılandırma: {"cols":["Ad","Değer"],"types":["text","number"]}

GROUP — Tekrar Edilebilir Alan Grubu
Alt alanları olan, birden fazla satır eklenebilen yapılandırılmış
alan. Her satır kart şeklinde görünür.

Alt alan tipleri: text, number, date, datetime, textarea, url,
email, color, select/dropdown, checkbox, image
Özellikler: sürükle-bırak satır sıralama, kart kaldırma,
başlangıç satır sayısı ayarlanabilir.
JSON dizisi: [{sirket:"...", tel:"..."}, ...]

TIMELINE — Zaman Çizelgesi
Kronolojik adımlar için tekrarlanabilir veri yapısı.
Her adım için: tarih, başlık, açıklama, renk (color picker).
Adım ekle / son adımı sil butonları.
JSON: [{date, title, desc, color}, ...]

CHECKLIST — Kontrol Listesi
Yapılacaklar / kontrol listesi öğeleri.
Her öğe için metin + onay kutusu (tamamlandı/tamamlanmadı).
Öğe ekle / kaldır; zebra satır arka planı.
JSON: [{text, checked}, ...]

FAQ — Sık Sorulan Sorular
Soru-cevap çiftleri için özel alan.
Numaralı kart arayüzü; çift ekle / kaldır.
JSON: [{q, a}, ...]

QUOTE — Alıntı / Söz
Alıntı metni + yazar + kaynak üçlüsü.
JSON: {text, author, source}

SOCIAL — Sosyal Medya Linkleri
Platform bazlı URL girişi.

Desteklenen platformlar:
facebook, instagram, twitter/X, youtube, linkedin, whatsapp,
telegram, tiktok, pinterest, github, website

Hangi platformların gösterileceği field_options ile seçilir.
Her platform için renkli ikon rozeti gösterilir.
JSON: {facebook:"url", instagram:"url", ...}

OPENINGHOURS — Çalışma Saatleri
7 günlük haftalık çalışma saati giriş alanı.

Her gün için:
• Açık/kapalı onay kutusu
• Açık günler için başlangıç-bitiş saati (time input)
• Hafta sonu ayrı arka plan rengi ile vurgulanır
• Kapalı etiket metni özelleştirilebilir

JSON: {mon:{open:1,from:"09:00",to:"18:00"}, ...}

MAP — Konum Seçici
Leaflet.js ile interaktif harita alanı (OpenStreetMap).

Özellikler:
• Haritaya tıklayarak konum seçme
• Marker sürükleyerek konum güncelleme
• Başlangıç koordinatı ve zoom ayarlanabilir (field_options)
• Seçilen koordinat anlık etiketle gösterilir
• Temizle butonu
• "lat,lng" formatında saklanır (örn: 39.925533,32.866287)
• MAP PINS blok düzeniyle entegre çalışır


----------------------------------------------------------------
2.5 GÖRSEL / UI ALANLARİ
----------------------------------------------------------------

PROGRESS — İlerleme Çubuğu
Yüzde (0-100) değeri için kaydırıcı + sayısal giriş kombinasyonu.
Range slider ve number input birbiriyle senkronize çalışır.
Anlık görsel bar önizleme. Renk özelleştirme (field_options ile).

BADGE — Renkli Rozet / Etiket
Metin + renk birleşimli rozet alanı.

Özellikler:
• Color picker ile anlık renk seçimi
• Canlı önizleme (form üzerinde)
• Ön tanımlı rozet seçenekleri:
field_options: "metin:#renk,metin2:#renk2"
• "metin||#renk" formatında saklanır

CODE — Kod Editörü
CodeMirror 5 ile sözdizimi vurgulama destekli kod yazım alanı.

Desteklenen diller:
PHP, HTML, CSS, JavaScript, SQL, Python, Bash/Shell,
XML, JSON, YAML, Markdown, Düz Metin

Özellikler:
• Dil seçici dropdown (anında değiştirilebilir)
• Karanlık (Dracula) veya açık tema
• Satır numaraları
• Kopyala butonu
• Satır sayısı göstergesi
• JSON: {lang:"php", code:"..."}


----------------------------------------------------------------
2.6 ALAN ÖZELLİKLERİ VE DAVRANIŞLARI
----------------------------------------------------------------

Her ilave alan için şu seçenekler yapılandırılabilir:

- Alan adı (field_name): veritabanı ve Smarty'de kullanılan tekil ad
- Alan etiketi (field_label): formda gösterilen başlık
- Alan tipi: yukarıdaki 30 tipten biri
- Açıklama / yardım metni
- Zorunlu alan (required)
- Tekrarlanabilir (repeatable): çoğu tip için desteklenir
- Koşullu görünürlük (conditional): başka alana bağlı göster/gizle
- Lookup alanı: başka kategori içeriklerini referans alma
- Varsayılan değer
- Doğrulama kuralı: minlength, maxlength, min, max, pattern, step
- Sıralama ağırlığı
- Durum (aktif/pasif)
- Bağlı kategoriler (çoklu kategori — xcreate_field_cats tablosu)


----------------------------------------------------------------
2.7 TEKRARLANABİLİR ALANLAR (REPEATABLE)
----------------------------------------------------------------

TEXT, TEXTAREA, IMAGE, FILE, URL, NUMBER gibi alanlarda
field_repeatable = 1 işaretlendiğinde alan dinamik olarak
çoğaltılabilir. Kullanıcı "Ekle" butonu ile yeni satır açar,
her tekrarlanan değer ayrı satırda kaydedilir.


----------------------------------------------------------------
2.8 KOŞULLü ALANLAR (CONDITIONAL FIELDS)
----------------------------------------------------------------

Bir alan başka bir alanın değerine göre gösterilip gizlenebilir.
Koşul JSON olarak saklanır: {"field_id":5,"operator":"==","value":"Yazılım"}

Desteklenen operatörler:
== (eşit), != (eşit değil), contains (içerir), not_empty (boş değil)

renderConditionEngine() JS motorunu otomatik üretir. Motor form
değişikliklerini dinleyerek ilgili satırları anlık gösterir/gizler.


----------------------------------------------------------------
2.9 LOOKUP ALANI
----------------------------------------------------------------

Bir alan başka bir kategorinin içerik listesinden seçim yapılmasını
sağlayabilir. field_lookup_enabled, field_lookup_cat_id ve
field_lookup_field_id parametreleriyle yapılandırılır.
AJAX endpoint (ajax/lookup.php) kategori içeriklerini anlık getirir.


================================================================
BÖLÜM 3: ALAN GRUPLARI / SEKMELER
================================================================

Çok sayıda ilave alan kullanıldığında xcreate içerik formu sekmeli
düzene geçer. Admin panelinden (admin/groups.php) sekme oluşturulur.

Her ilave alan bir grup/sekmeye atanabilir. İçerik düzenleme formu
açıldığında alanlar sekmelere gruplanmış şekilde görünür.

Veritabanı: xcreate_field_groups tablosu.
JS: assets/js/xcreate-group.js
(sürükle-bırak sıralama, xgrp_add, xgrp_remove, xgrp_sync)


================================================================
BÖLÜM 4: SEO ARAÇLARI
================================================================

4.1 TEMEL META ALANLARI
Her içerik için ayrı ayrı tanımlanabilir:
- Meta başlık (title tag)
- Meta açıklama (meta description)
- Canonical URL
- Robots direktifi (index/noindex, follow/nofollow)

4.2 OPEN GRAPH (Sosyal Medya Paylaşım Kartları)
og:title, og:description, og:image, og:type, og:url

4.3 TWITTER CARD
twitter:card, twitter:title, twitter:description, twitter:image

4.4 JSON-LD YAPISAL VERİ
Schema.org uyumlu yapısal veri. Article, Product, Event gibi
şemalarla Google zengin sonuç sisteminde öne çıkma desteği.

4.5 SEO DOSTU URL / SLUG SİSTEMİ
Her içerik için otomatik slug üretimi (class/slug.php).
Başlık girildiğinde slug alanı otomatik dolar, elle düzenlenebilir.
URL yapısı: /icerik/[slug]/
xSEO Router modülüyle entegre çalışır.

4.6 ALAN TEMPLATE TAG REFERANSI (admin/fieldtags.php)
Her alan tipi için .tpl şablonlarında kullanılacak Smarty taglarını
gösteren interaktif admin sayfası. Kategori seçildiğinde o kategoriye
ait alanların hazır tagları ($f_, $fd_, $fl_ ve $field dizi erişimi)
listelenir. Tekrarlanabilir alan örnekleri de gösterilir.


================================================================
BÖLÜM 5: BLOK BUILDER (GÖRSEL BLOK OLUŞTURUCU)
================================================================

5.1 BLOK BUILDER NEDİR?
admin/blockbuilder.php ile gelen görsel araç; sol panel ayarlar,
sağ panel canlı önizleme mimarisiyle çalışır. Kod yazmadan
XOOPS bloklarını görsel olarak tasarlama imkânı sunar.

Oluşturulan bloklar xcreate_blocks tablosuna kaydedilir.
Smarty'de kullanım:
<{xcreate_block id="1"}>
<{xcreate_block name="blok-adi"}>

5.2 DESTEKLENEN 15 BLOK DÜZENI
--------------------------------

GRID — Izgara
Belirtilen sütun sayısında kart ızgarası.
Kapak görseli, başlık, özet, tarih.

LIST — Liste
Dikey liste. Küçük thumbnail + metin yan yana.

MAGAZINE — Dergi Düzeni
İlk içerik büyük featured kart; diğerleri küçük liste.
Gazete/dergi ana sayfası görünümü.

MASONRY — Tuğla Duvar
CSS columns ile Pinterest benzeri ızgara.
Farklı yükseklikteki içerikler akıllıca sıralanır.

CAROUSEL — Karusel
Otomatik geçişli içerik karuseli. Önceki/sonraki butonları.

SLIDER — Tam Genişlik Slider
Hero tarzı tam genişlik görsel slider.
Başlık, özet ve bağlantı butonu katmanı.

ACCORDION — Akordiyon
İçerikleri açılır/kapanır paneller şeklinde listeler.

CARD FLIP — Kart Döndürme
Mouse hover'da 3D dönen kart efekti.
Ön: görsel + başlık. Arka: özet + bağlantı butonu.

KANBAN — Kanban Panosu
İçerikleri kategorilere göre kanban sütunlarına yerleştirir.
Proje yönetimi ve iş takibi için uygundur.

TABLE — Veri Tablosu
İçerikleri tablo satırlarında listeler.
Sütunlar seçilebilir; sıralanabilir başlıklar (xcreate-table.js).

TICKER — Haber Bandı
Yatay kayan haber bandı (CSS ticker/marquee).

TIMELINE — Zaman Çizelgesi
İçerikleri kronolojik akış çizelgesinde gösterir.
Sol/sağ dönüşümlü yerleşim.

MAP PINS — Harita Noktaları
MAP tipi ilave alanı bulunan içerikleri Leaflet.js haritasında
pin olarak gösterir. Her pine tıklandığında içerik özeti açılır.

FILTER — Filtreli Liste (ayrı blok — xcreate_filter_block.php)
Kullanıcı seçilen alanlara göre içerikleri filtreler.
AJAX ile sayfa yenilenmeden sonuç güncellenir.

RECENT — Son İçerikler (xcreate_blocks.php)
Yeni eklenen içerikleri basit liste şeklinde gösterir.

5.3 BLOCK BUILDER AJAX ENDPOINTLERİ
ajax/blockbuilder_save.php — blok kaydetme
ajax/blockbuilder_load.php — blok yükleme
ajax/blockbuilder_delete.php — blok silme
ajax/blockbuilder_fields.php — kategori alanlarını getirme


================================================================
BÖLÜM 6: WIDGET BLOKLARI (10 ADET)
================================================================

Tümü xcreate_widgets.php üzerinden yönetilir. XOOPS blok sistemine
tam entegre; admin panelinden aktifleştirilerek herhangi bir blok
konumuna yerleştirilebilir.

W1 — Son İçerikler (Recent) : En yeni içerikler
W2 — En Çok Görüntülenen (Pop.) : Görüntülenmeye göre sıralı
W3 — En Yüksek Puanlı : Derecelendirme puanına göre, yıldız göstergesiyle
W4 — Rastgele (Random) : Her yüklemede farklı içerikler
W5 — Öne Çıkan (Featured) : featured=1 işaretli içerikler
W6 — Kategori Grubu : Kategorinin adı, açıklaması, içerik sayısı
W7 — İstatistik Sayacı : Toplam içerik, görüntülenme sayıları
W8 — Slider : Görsel kaydırıcı; geçiş süresi ayarlanabilir
W9 — Etiket Bulutu : Sıklığa göre boyutlandırılmış etiket bulutu
W10 — Son Etkinlik (Activity) : Son içerik hareketleri kronolojik akış

Her widget için limit ve kategori filtresi ayarlanabilir.


================================================================
BÖLÜM 7: GELİŞMİŞ ARAMA VE OTOTAMAMLAMAPage
================================================================

7.1 ARAMA SİSTEMİ (search.php + xcreate_search.tpl)
Eş zamanlı arama: başlık, özet, tam içerik, etiketler,
metin tipli ilave alan değerleri.
Sonuç sıralama: tarih, görüntülenme veya puan.
Kategori bazlı filtreleme arama sonuçlarında da çalışır.

7.2 OTOTAMAMLAMAPage (ajax/search_suggest.php)
Arama kutusuna yazılmaya başlandığında AJAX ile anlık öneriler.
Hem içerik başlıklarını hem etiketleri önerir.


================================================================
BÖLÜM 8: DERECELENDİRME SİSTEMİ
================================================================

- 1'den 5'e yıldız derecelendirmesi (class/rating.php)
- AJAX tabanlı oy gönderme (ajax/rating.php) — sayfa yenilenmez
- Kullanıcı başına tek oy kontrolü (IP + oturum)
- Her içerik için ortalama puan ve toplam oy sayısı takibi
- Stiller: assets/css/xcreate-rating.css
- JS: assets/js/xcreate-rating.js
- W3 widget'ı ile en yüksek puanlılar otomatik listelenir


================================================================
BÖLÜM 9: YORUM SİSTEMİ (XOOPS NATIVE)
================================================================

xcreate, XOOPS'un yerleşik yorum sistemiyle tam entegre çalışır.

xoops_version.php ayarları:
hasComments = 1
comments.itemName = 'item_id'
comments.pageName = 'item.php'
Callback: xcreate_com_approve, xcreate_com_update

Yorum dosyaları:
comment_new.php, comment_post.php, comment_edit.php,
comment_reply.php, comment_delete.php
include/comment_functions.php — callback fonksiyonları


================================================================
BÖLÜM 10: İLETİŞİM FORMU MOTORU (contact.php)
================================================================

xcreate, her kategori için bağımsız iletişim formu oluşturabilir.
submit.php'den tamamen bağımsız çalışır.

Kategori bazlı ayarlar:
cat_mail_notify = 1 → mail gönder
cat_mail_to = alıcı adresi (virgülle birden fazla)
cat_mail_reply = Reply-To ({field_eposta} gibi alan adı da olabilir)
cat_mail_subject = mail konusu ({field_konu} ile dinamik konu)
cat_success_msg = başarılı gönderim mesajı

Kullanım: /modules/xcreate/contact.php?cat_id=X

Bu sayede xcreate ayrı bir iletişim formu modülüne ihtiyaç duymadan
form özelliğini karşılayabilir.


================================================================
BÖLÜM 11: İÇE VE DIŞA AKTARMA
================================================================

DIŞA AKTARMA — admin/export.php
Tüm içerikler veya seçili kategoriler iki formatta aktarılır:
CSV: Excel, Sheets, LibreOffice ile açılabilir.
JSON: API entegrasyonu ve yedekleme için.

İÇE AKTARMA — admin/import.php
CSV veya JSON dosyaları yüklenir. Sihirbaz:
— Dosya yapısını doğrular
— Sütunları alanlarla eşleştirir (mapping)
— Yinelenen kayıtları tespit eder
— Hatalı satırları raporlar, geçerli satırları yükler

VERİ GÖÇÜ — sql/migrate_from_customfields.sql
xcreate, customfields modülünden göçü destekler.
RENAME TABLE komutlarıyla mevcut tablolar xcreate tablolarına
dönüştürülür. Template dosya adları da otomatik güncellenir.


================================================================
BÖLÜM 12: SMARTY ENTEGRASYONu VE PLUGİNLER
================================================================

12.1 function.xcreate.php — Temel Smarty Etiketi
Herhangi bir XOOPS şablonunda xcreate içeriklerine erişim:

<{xcreate category="haberler" limit="5" order="date"}>

Parametreler: category, limit, order (date/views/rating/random),
featured (1/0), tag.

12.2 function.xcreate_block.php — Block Builder Smarty Etiketi
Görsel Blok Builder ile oluşturulan blokları çağırır:

<{xcreate_block id="1"}>
<{xcreate_block name="blok-adi"}>

12.3 Smarty Plugin Yönetimi (admin/plugin.php)
Her iki Smarty eklentisinin XOOPS smarty3_plugins klasörüne
kurulum ve kaldırma işlemi admin arayüzünden yapılır.
Durum bilgisi, kullanım örnekleri ve açıklamalar görüntülenir.

12.4 Şablon Erişim Yöntemleri
Kısa alias:
{$f_alan_adi} — ham değer
{$fd_alan_adi} — render edilmiş HTML (görsel, harita, embed)
{$fl_alan_adi} — alan etiketi

Dizi erişimi:
{$field.alan_adi.value} — ham değer
{$field.alan_adi.display} — render edilmiş HTML
{$field.alan_adi.label} — etiket

Döngüsel erişim:
{foreach from=$fields item=fld}
{$fld.label}: {$fld.values|@implode:', '}
{/foreach}


================================================================
BÖLÜM 13: HAZIR ŞABLON SETLERİ
================================================================

Ana Şablonlar:
xcreate_index.tpl — Ana liste sayfası
xcreate_item.tpl — İçerik detay sayfası
xcreate_submit.tpl — İçerik gönderme formu
xcreate_contact.tpl — İletişim formu
xcreate_search.tpl — Gelişmiş arama sayfası

Hazır İçerik Tipi Şablonları (templates/information/):
full.tpl, short.tpl — Genel tam/kısa görünüm
game_full.tpl, game_short.tpl— Oyun içeriği
movie_fragman.tpl — Film fragman
movie_list.tpl — Film listesi
tips_full.tpl, tips_short.tpl— İpucu içeriği
modules_full.tpl — Modül tanıtım
xcreate_tanitim-tr.html — Türkçe tanıtım belgesi
xcreate_tanitim_en.html — İngilizce tanıtım belgesi

Blok Şablonları (templates/blocks/):
15 blok düzeni için ayrı .tpl dosyası
10 widget için ayrı .tpl dosyası

Özel Şablonlar (templates/custom/):
Sitenize özel kopyalanabilir örnek şablonlar:
ornek.tpl, tips_blok.tpl, tips_sag_blok.tpl, topgames.tpl


================================================================
BÖLÜM 14: DEBUG VE LOG SİSTEMİ
================================================================

class/logger.php — XcreateLogger sınıfı:
- Günlük log dosyaları: /modules/xcreate/logs/debug_YYYY-MM-DD.log
- Log seviyeleri: INFO, ERROR, DEBUG
- Hem dosyaya hem PHP error_log'a yazar
- getLogContent($lines): son N satırı okuma
- Logs klasörü .htaccess ile web erişimine kapatılmıştır

Admin debug sayfaları:
admin/debug_log.php — log içeriğini admin panelinde görüntüle
admin/debug_cats.php — kategori verilerini debug et
admin/debug_items.php — içerik verilerini debug et
admin/demo.php — demo içerik oluşturma aracı


================================================================
BÖLÜM 15: VERİTABANI YAPISI
================================================================

Kurulumda oluşturulan tablolar:
xcreate_categories — Kategoriler
xcreate_items — İçerik kayıtları (slug, SEO, rating dahil)
xcreate_fields — İlave alan tanımları
xcreate_field_options — Select/checkbox/radio seçenekleri
xcreate_field_values — İlave alan değerleri
xcreate_ratings — Derecelendirme kayıtları
xcreate_field_groups — Alan grubu/sekme tanımları
xcreate_blocks — Block Builder blok kayıtları

Otomatik oluşturulan:
xcreate_field_cats — Alan-kategori çoklu ilişki tablosu
(getFieldsByCategory() ilk çağrısında
oluşturulur; mevcut veriler geçirilir)

SQL güncelleme dosyaları:
update_seo_slugs.sql — Slug sütunları
update_seo_meta.sql — SEO meta sütunları
update_blockbuilder.sql — Blok builder tablosu
update_comments.sql — Yorum entegrasyonu
update_conditional_fields.sql — Koşullu alan sütunları
update_field_multicats.sql — Çoklu kategori ataması
update_lookup_field.sql — Lookup alan sütunları
update_v1.5.sql — 1.5 sürümü güncellemeleri
migrate_from_customfields.sql — customfields modülü göç betiği


================================================================
BÖLÜM 16: MODÜl AYARLARI
================================================================

xoops_version.php üzerinden yapılandırılan seçenekler:

items_per_page (varsayılan: 10)
Sayfa başına gösterilen içerik sayısı.

allow_user_submit (varsayılan: 1)
Üye kullanıcıların içerik gönderebilmesi.

upload_maxsize (varsayılan: 2048 KB)
Dosya yükleme maksimum boyutu.

upload_allowed_ext (varsayılan: jpg,jpeg,png,gif,pdf,doc,docx,...)
İzin verilen dosya uzantıları, virgülle ayrılmış.


================================================================
BÖLÜM 17: KURULUM VE YAPILANDIRMA
================================================================

1. xcreate.zip paketini indirin.
2. xcreate/ klasörünü /modules/ dizinine yükleyin.
3. XOOPS Admin > Modül Yönetimi > xcreate > Yükle.
4. Kurulum sql/mysql.sql'i çalıştırarak tabloları oluşturur.
5. Admin > xcreate > Ayarlar'dan temel yapılandırmayı yapın.
6. Admin > xcreate > Kategoriler'den ilk kategorinizi oluşturun.
7. Admin > xcreate > Alanlar'dan kategoriye ilave alanlar ekleyin.
8. Admin > xcreate > Alan Grupları ile form sekmelerini oluşturun.
9. Admin > xcreate > Blok Builder ile bloklar tasarlayın.
10. Admin > xcreate > Plugin'den Smarty eklentilerini kurun.
11. XOOPS blok yönetiminden widget'ları aktifleştirip konumlandırın.

customfields modülünden geçiş yapıyorsanız:
sql/migrate_from_customfields.sql betiğini çalıştırın.


================================================================
BÖLÜM 18: GELİŞTİRİCİ NOTLARI
================================================================

18.1 AJAX GÜVENLİĞİ
Tüm AJAX dosyaları mainfile.php'yi ob_start()/ob_end_clean()
wrapper'ı ile yükler. Bu, XOOPS debug logger HTML'inin JSON
çıktısını bozmasını önler.

18.2 AJAX ENDPOINTLERİ
ajax/rating.php — Yıldız derecelendirme
ajax/search_suggest.php — Autocomplete önerileri
ajax/lookup.php — Lookup alan içerik listesi
ajax/filter_block.php — Filtre bloğu sorgusu
ajax/fileinfo_upload.php — FILEINFO alan dosya yükleme
ajax/fileinfo_download.php — İndirme sayacı artırma
ajax/get_cat_fields.php — Kategori ilave alanlarını getirme
ajax/blockbuilder_*.php — Block Builder CRUD işlemleri

18.3 xPLUGINS ENTEGRASYONu
xPlugins hook/filter/shortcode mimarisiyle entegre çalışır.
İçerik kaydı öncesi/sonrası özel işlemler tetiklenebilir.

18.4 xSEO ROUTER ENTEGRASYONu
xcreate + xSEO Router birlikte XOOPS'ta SEO dostu URL sağlar.
xSEO Router xcreate slug'larını yakalar, doğru içeriğe yönlendirir.
Sunucu tarafı mod_rewrite kuralı gerekmez.

18.5 GÜVENLİK ÖNLEMLERİ
- Tüm kullanıcı girdileri htmlspecialchars ve XoopsRequest ile
temizlenir
- Tüm form gönderimleri XOOPS token doğrulamasından geçer
- SQL enjeksiyonuna karşı quoteString ve intval kullanımı
- Dosya yükleme: tip ve boyut doğrulaması
- .htaccess ile logs/ ve uploads/xcreate/ korunur


================================================================
SONUÇ
================================================================

Xcreate, XOOPS platformuna modern, esnek ve kapsamlı bir içerik yönetim katmanı ekler. 30 alan tipi, 15 blok düzeni, 10 widget, görsel blok oluşturucu, iletişim formu motoru, derecelendirme, XOOPS native yorum sistemi, SEO araçları, içe/dışa aktarma, debug loglama, Smarty eklentileri ve customfields'tan göç desteğiyle neredeyse her türlü web sitesinin içerik ihtiyacını karşılayabilir.