# Elan Skripti - Versiya Tarixi

## v1.10.0 (Cari)
- **Son baxılanlar tarixi** - İstifadəçilərin son baxdığı elanların saxlanması və göstərilməsi
- **Satıcı əlaqə sorğuları** - Alıcıların satıcıya sorğu göndərmə sistemi
- **Google OAuth inteqrasiyası** - Google hesabı ilə giriş dəstəyi
- **Tema idarəetməsi** - Admin paneldən rəng və loqo dəyişmə imkanı
- **Media idarəetməsi** - Elanlar üçün şəkil/kover idarəsi və avtomatik thumbnail
- **Audit log sistemi** - Bütün admin əməliyyatlarının qeydə alınması
- **İdxal/ixrac sistemi** - CSV formatında elanların ixracı
- **Ödənişli xidmətlər** - VIP, Premium və Boost paketləri idarəsi
- **Reklam slot idarəsi** - 5 fərqli reklam zonasının idarə edilməsi
- **Instant axtarış** - 2 hərf yazdıqda real-time axtarış təklifləri
- **Şərh sistemi toggle** - Şərhləri aktiv/deaktiv etmə imkanı
- **Məzmun limitləri** - Başlıq, təsvir, şəkil və video ölçü limitləri
- **Admin şifrə dəyişmə** - Tək clicksiz admin şifrəsi yeniləmə
- **Toplu elan əməliyyatları** - Seçilmiş elanları toplu təsdiq/ləğv/silmə
- **İstifadəçi flag idarəsi** - Business, Dealer, Telefon təsdiq statusları
- **Fayl inteqritet yoxlanışı** - Kritik faylların imza ilə qorunması və çəkilmə aşkarlanması
- **CSRF qoruması** - Bütün formalar üçün token əsaslı qorumə
- **Rate limiting** - Brute-force və spam hücumlarına qarşı qorumə
- **Bildirişlər sistemi** - İstifadəçilərə real-time bildirişlər göstərmə
- **Demo rejimi** - Təhlükəsiz demo rejimi əlavə edildi

## v1.9.0
- **Global mesaj sistemi (showMsg)** - Toast notifikasiya sistemi ilə uğur və xəta mesajları
- **Yenilənmiş breadcrumb formatı** - "Ana səhifə - Kateqoriya - Mağaza - Elan adı" formatı
- **Listing səhifəsi 500 xətası düzəldildi** - Session idarəetməsi və include problemləri həll edildi
- **Debug kodları təmizləndi** - İstehsal üçün əlavə edilmiş debug echo-ları silindi
- **Shell_top.php təkmilləşdirildi** - Rekursiv çağırış problemi aradan qaldırıldı
- **Admin panel mobil menyu** - Mobil versiyada sol tərəfdən çıxan slayd menyu sistemi
- **İcazə yoxdur mesajı təkrarı düzəldildi** - Admin panelə girişdə iki dəfə mesaj göstərmə problemi həll edildi

## v1.8.0
- **VIP elan sistemi** - Ödənişli VIP elanlar üçün xüsusi bölmə və vurgulama
- **Avtomatik vaxt bitməsi** - Elanların müddətinin avtomatik kontrolü
- **Təkrar elan yoxlanışı** - Eyni məzmunlu elanların bloklanması
- **Admin panel statistikası** - Real-time qrafik və hesabatlar
- **API endpoint-ləri** - Xarici əlaqələr üçün JSON API
- **Bulk əməliyyatlar** - Toplu elan silmə və redaktə etmə
- **Moderator qeydləri** - Elanlar üzərində admin qeydləri
- **Yüksək keyfiyyətli şəkil** - WebP format dəstəyi və progressive loading

## v1.7.0
- **Premium mağaza paketləri** - Mağazalar üçün müxtəlif ödəniş planları
- **Balans və ödəniş tarixi** - Tam ödəniş izləmə və faktura sistemi
- **Bank kartı inteqrasiyası** - Onlayn ödəniş qapısı (gateway)
- **Promo kod sistemi** - Endirim kuponları və kampaniyalar
- **Reklam banner yerləri** - Admin tərəfindən idarə olunan reklam zonaları
- **SEO analitika** - Axtarış motoru indeksləmə statistikası
- **XML ixrac** - Elanların XML formatında ixracı

## v1.6.0
- **Mağaza (shop) sistemi** - Şəxsi mağaza səhifələri və kataloq
- **Mağaza abunəliyi** - Aylıq/illik mağaza paketləri
- **Elan statistikası** - Baxış sayı, favori və əlaqə statistikası
- **İstifadəçi reytinqi** - Satıcı reputasiya sistemi
- **Təhlükəsiz əlaqə** - Telefon nömrəsinin maskalanması
- **Şərhlər və rəylər** - Elanlar üzərində şərh sistemi
- **Paylaşma düymələri** - Sosial şəbəkələrdə paylaşma inteqrasiyası

## v1.5.0
- **Yadda saxlanan axtarışlar** - Axtarış parametrlərini yadda saxlama
- **Axtarış filtrləri** - Qiymət aralığı, yer, kateqoriya filtrləri
- **Favorilər siyahısı** - Seçilən elanları favoriyə əlavə etmə
- **Elan müqayisəsi** - Bir neçə elanı yan-yana müqayisə etmə
- **Xəbər bildirişləri** - Yeni elanlar haqda e-poçt bildirişləri
- **Mobil tətbiq dəstəyi** - API üçün mobil optimallaşdırma

## v1.4.0
- **Çoxlu şəkil yükləmə** - Hər elan üçün 10+ şəkil
- **Şəkil gələjsi (gallery)** - Lightbox və zoom funksiyası
- **Video əlavə etmə** - YouTube/Vimeo link inteqrasiyası
- **Xəritə inteqrasiyası** - Google Maps ilə yer göstərmə
- **Avtomatik ünvan tamamlama** - Ünvan yazarkən təkliflər
- **Sahə validasiyası** - Formalar üçün client-side validation

## v1.3.0
- **Elan redaktə etmə** - Paylaşılan elanları düzəliş etmə
- **Elan yeniləmə (bump)** - Elanı yuxarı sıraya qaldırma
- **Vaxt uzatma** - Elan müddətinin artırılması
- **Çox kateqoriya dəstəyi** - Bir elanın bir neçə kateqoriyada olması
- **Etiket (tag) sistemi** - Açar sözlər ilə axtarışı asanlaşdırma
- **Admin təsdiqi** - Elanların admin təsdiqindən sonra yayınlanması

## v1.2.0
- **Şəxsi kabinet** - İstifadəçi profili və elan idarəetməsi
- **Elan silmə** - Paylaşılan elanları silmə imkanı
- **Mesajlaşma** - Alıcı və satıcı arasında chat sistemi
- **Telefon doğrulama** - SMS ilə nömrə təsdiqi
- **E-poçt doğrulama** - Aktivləşdirmə linki ilə təsdiq
- **Şifrə bərpası** - Unudulmuş şifrəni bərpa etmə

## v1.1.0
- **Qeydiyyat sistemi** - Tam istifadəçi qeydiyyatı və girişi
- **Elan paylaşma** - Yeni elan yaratma forması
- **Kateqoriya strukturu** - Çoxsəviyyəli kateqoriyalar
- **Axtarış funksiyası** - Əsas axtarış imkanı
- **Pagination** - Səhifələrə bölünmüş elan siyahısı
- **Responsive dizayn** - Mobil uyğun interfeys

## v1.0.0
- **Əsas elan funksionallığı** - Elan yerləşdirmə və görüntüləmə
- **Sadə kateqoriyalar** - Əsas bölmələr üzrə filtr
- **Qonaq girişi** - Qeydiyyatsız baxış imkanı
- **Əlaqə forması** - Satıcı ilə əlaqə üçün form
- **Lisenziya sistemi** - Avtomatik lisenziya yoxlanışı
- **Quraşdırma sihirbazı** - Asan quraşdırma prosesi

---

**Müəllif:** Muğalov Ramin (store.mugalov.com)

# Elan Platformu — Klassifayds Skripti

Bu skript müasir elan saytıdır: sürətli axtarış, dinamik kateqoriyalar, ödənişli vurğulama xidmətləri, mağaza profilləri və idarəetmə paneli ilə tam həll təqdim edir.

## Başlıca Xüsusiyyətlər
- İstifadəçi qeydiyyatı və giriş (CSRF qoruması, rate-limit, "remember me" tokenləri).
- Elan əlavə etmə, redaktə və silmə; kateqoriyalar və atributlara uyğun dinamik form.
- Media yükləmə (şəkil/video), əsas şəkil, sıralama.
- Elanların təsdiqi/reddi (moderasiya) və bildirişlər.
- Ödənişli xidmətlər: VIP, Premium, irəli çəkmə (raise), boost.
- Favoritlər və şərhlər, saxlanmış axtarışlar.
- Mağazalar (shop) bölməsi, istifadəçi vitrinləri.
- Axtarış və filtrlər, trend və son baxılanlar “discovery” blokları.
- Bildirişlər (in‑app), oxundu/oxunmadı idarəsi.
- Bülleten (newsletter) abunəsi.
- SEO: sitemap, slug, əsas meta.
- Admin panel: statistika, şikayətlər, kateqoriyalar, istifadəçilər, moderasiya.
- Quraşdırıcı (install.php) və avtomatik sxem (schema) migrasiyası.

## İstifadəçi Tərəfi
- Elan yerləşdirmə: kateqoriya və atributlara uyğun dinamik forma.
- Axtarış və filtrlər: qiymət, şəhər/rayon, vəziyyət, təcili, və s.
- VIP/Premium/İrəli çəkmə ilə elanların vurğulanması.
- Favoritlər, rəy və şərhlər.
- Mağaza səhifələri və istifadəçi vitrinləri.
- Bildirişlər səhifəsi: oxunmamış sayı, oxundu işarələmə.

## Admin Panel
- Dashboard: ümumi say göstəriciləri və qrafik.
- Elan idarəetməsi: status dəyişmə, toplu təsdiq/ləğv/silmə, redaktə.
- Kateqoriyalar və atributlar: əlavə et, sırala, tərcümə et.
- İstifadəçilər: rol, təsdiq, ixrac.
- Şikayətlər və rəy idarəetməsi.
- Ödəniş ayarları: provider seçimi (PayPal, Kapital, Stub).
- Marketinq: kuponlar və kampaniyalar.
- SEO ayarları: route üzrə title/description/canonical.

## Qurulum
1. PHP və MySQL mühiti hazırlayın (NGINX/Apache).
2. public/ qovluğunu veb kök (document root) kimi konfiqurasiya edin.
3. Brauzerdə public/install.php açın və addımları izləyin:
- DB məlumatlarını daxil edin (ad, istifadəçi, şifrə).
- Admin hesabı yaradın.
- Base URL daxil edin.
4. Uğurla bitdikdə app/config.local.php avtomatik yazılır. Yazıla bilməsə, ekranda göstərilən məzmunu fayla əllə köçürün.

## Günlük İstifadə
- Elan əlavə edin, təsdiqdən keçdikdən sonra dərhal yayın.
- VIP/Premium/İrəli çəkmə paketləri ilə elanlarınızı önə çıxarın.
- Bildirişləri real vaxtda alın və oxundu kimi işarələyin.

## Təhlükəsizlik və Keyfiyyət
- CSRF qoruması: bütün POST əməliyyatlarında token tələb olunur.
- SQL: PDO + prepared statements (emulate off), utf8mb4.
- Sessiya və cookie parametrləri: Secure/HttpOnly/SameSite.
- Rate-limit: giriş və qeydiyyat cəhdləri məhdudlaşdırılır.

## Qaydalar və Bloklama
- Müdaxilə qadağası: Skriptin mənbə koduna və ya təhlükəsizlik mexanizmlərinə icazəsiz müdaxilə qadağandır.
- Özünü deaktiv etmə: Pozuntu və ya lisenziya uyğunsuzluğu aşkar edildikdə sistem girişləri bloklayır və xidmət özünü deaktiv rejiminə keçir (istifadəçilər license.php səhifəsinə yönləndirilir). Məlumatlar silinmir, ödəniş/lisenziya bərpa edildikdə xidmət yenidən aktivləşir.
- Mərkəzləşdirilmiş bloklama: Uzaq serverdən “disable” siqnalı göndərildikdə skript dərhal qeyri‑aktiv vəziyyətə alınır.

## Ödəniş Gecikməsi
- Lisenziya müddəti bitdikdə və ya ödəniş gecikdikdə sayta girişlər məhdudlaşır, idarəetmə və istifadəçi paneli bloklana bilər.
- Ödəniş bərpa edildikdə status avtomatik aktivləşir və xidmət normal fəaliyyətə qayıdır.

## Stil və Brendləmə
- Admin panel → Sayt ayarları bölməsindən aşağıdakıları idarə edin:
- Rənglər: tema primary/secondary
- Logo mətni və logo şəkli
- Şrift ailəsi
- Dəyişikliklər dərhal UI elementlərinə tətbiq olunur (başlıq, düymələr, vurğular).

## Güncəlləmələr
- Skript modulyar qurulub: kateqoriya/atribut i18n, ödəniş provayderləri, bildirişlər və SEO ayrı modullar kimidir.
- Gələcək versiyalarla uyğun şəkildə funksional genişləndirmələr əlavə edilə bilər. Yeniləmələr tətbiq edilərkən mövcud verilənlər bazası və ayarlar saxlanılır (schema migrasiyası mövcuddur).

## Brendləmə
- Tema rəngi, loqo və şriftləri admin paneldən dəyişdirin.

## Qovluq Quruluşu
- app/ — konfiqurasiya, DB bağlantısı, təhlükəsizlik, migrasiya və köməkçi funksiyalar
- public/ — saytın səhifələri (index, search, listing, admin, və s.)
- public/api/ — AJAX/JSON API endpointləri
- public/inc/ — şablon başlıq/footerlər (shell_top.php, shell_bottom.php)
- public/db/schema.sql — verilənlər bazası sxemi (install zamanı istifadə olunur)

## Versiya və Tələblər
- PHP 8.1+, MySQL 5.7+/8.0+
- cURL (bəzi inteqrasiyalar üçün), file_uploads aktiv

---
Bu sənəd alıcı üçün icmal xarakterlidir: saytın imkanlarını və idarəetməsini qısa şəkildə təqdim edir.