لاگ تغییرات

نمایش ساختار کامل صفحه در ویرایشگر

**مشکل قبلی:** ویرایشگر فقط بلوک‌های سفارشی را نشان می‌داد — بلوک‌های پیش‌فرض سایت (هدر، هیرو، آمار و...) نمایش داده نمی‌شدند. کاربر نمی‌توانست ببیند بلوک جدیدش کجا قرار می‌گیرد.

**رفع:** ویرایشگر حالا **ساختار کامل صفحه** را نشان می‌دهد:

برای هر صفحه، بلوک‌های سیستمی متفاوت است:

ایجاد صفحات جدید

ویرایش عنوان و آدرس صفحات سفارشی

فایل‌های تغییر یافته

---


---

رفع بلوک‌های صفحه اصلی + صفحه قانون

**مشکل:** بلوک‌هایی که در ویرایشگر برای صفحه «home» اضافه می‌شدند نمایش داده نمی‌شدند — چون home.php و law-detail.php متد PageBlocks::render() را فراخوانی نمی‌کردند.

**رفع:**

بازنویسی کامل ویرایشگر صفحات

**مشکل قبلی:**

**رفع:**

تست‌ها

| Test | Result |
|------|--------|
| Homepage renders PageBlocks | ✓ PageBlocks::render('home') |
| Law detail renders PageBlocks | ✓ PageBlocks::render('law-detail') |
| Page editor auto-loads blocks | ✓ |
| Add block via UI | ✓ (3 blocks after add) |
| Delete block via UI | ✓ (2 blocks after delete) |
| Inline edit toggles | ✓ |
| 6 page tabs visible | ✓ |
| 8 block type buttons | ✓ |
| Fetch URLs work with XTransformPort | ✓ peUrl() helper |

فایل‌های تغییر یافته

---

رفع شمارش مواد در پنل ادمین

ویرایشگر صفحات زنده (Live Editor)

**بازنویسی کامل** ویرایشگر صفحات به‌صورت زنده (inline):

#### ویرایش مستقیم (بدون مودال)

#### حذف همیشه قابل دسترس

#### دکمه‌های کنترل

#### نوع بلوک جدید: کارت اطلاعات (info_card)

صفحه تماس با ما اکنون قابل ویرایش

نتایج تست

| Test | Result |
|------|--------|
| Admin dashboard article count | ✓ Uses Settings::liveArticleCount() |
| Page editor shows 4 contact blocks | ✓ پست الکترونیک، ساعات، گزارش، AI |
| Each block has edit + delete buttons | ✓ Always visible |
| Inline edit form toggles | ✓ ✏️ button opens form inline |
| Contact page renders info cards | ✓ 4 cards from DB |
| Email mailto link works | ✓ mailto:info@divan.qanun |
| Hours display correctly | ✓ "۹:۰۰ تا ۱۷:۰۰" |
| Page selector tabs (about/contact) | ✓ |

فایل‌های تغییر یافته

---

رفع تب‌بندی تنظیمات (تک‌ردیفه)

حذف متن «حساب تست» از فرم ورود

کپچای ریاضی (Anti-Spam)

**کلاس جدید App\Helpers\Captcha** — کپچای ریاضی سبک بدون وابستگی خارجی:

به ۳ فرم اضافه شد:

بازطراحی صفحه «درباره ما»

ویرایشگر منوی هدر (WordPress-like)

**قبل:** فیلد متنی با فرمت عنوان|/مسیر در هر خط.
**بعد:** ویرایشگر ساختاریافته با کارت آیتم‌ها:

ویرایشگر ستون‌های فوتر (WordPress-like)

**قبل:** ستون‌های ثابت «دسترسی سریع» و «منابع» در فایل کد.
**بعد:** ویرایشگر ساختاریافته:

ویرایشگر صفحات (CMS) — جدید!

**جدول جدید page_blocks** + کلاس App\Helpers\PageBlocks:
- text — متن (HTML مجاز، sanitized)
- html — کد HTML دلخواه (با احتیاط)
- video — ویدیو از YouTube/Aparat (auto-embed)
- image — تصویر از URL
- heading — عنوان بزرگ
- quote — نقل‌قول (سبک استایل)
- warning — هشدار (پس‌زمینه زرد)

#### مسیرهای ادمین

#### رابط کاربری

پشتیبانی از ویدیو

نتایج تست

| Test | Result |
|------|--------|
| Settings tabs single-row | ✓ flex-wrap: nowrap |
| 6 tabs (not 7) | ✓ removed «مدیریت مواد» |
| Login has no demo text | ✓ |
| Captcha renders on login | ✓ |
| Captcha renders on register | ✓ |
| Captcha renders on contact | ✓ |
| About page less crowded | ✓ 9 features (was 12) |
| Header menu editor renders | ✓ items + submenus |
| Footer column editor renders | ✓ columns + links |
| Add header item dynamically | ✓ addHeaderItem() works |
| Page editor /admin/pages works | ✓ renders + saves |
| Create video block → renders on /about | ✓ iframe with youtube embed |

فایل‌های تغییر یافته

---

رفع پین فهرست مواد (TOC Pin)

**مشکل قبلی:** وقتی روی دکمه «پین فهرست» کلیک می‌کردید، خود لیست مواد هم باز می‌شد که فضای زیادی می‌گرفت.
**رفع:** حالا فقط نوار عنوان «فهرست مواد» پین می‌شود. کاربر روی عنوان کلیک می‌کند تا لیست مواد باز شود.

رفع شمارش مواد در صفحه تنظیمات

**مشکل قبلی:** در ویجت «آمار هوش مصنوعی» در صفحه تنظیمات، تعداد کل مواد از COUNT(*) استفاده می‌شد که شامل ردیف‌های تکراری هم بود.
**رفع:** حالا از COUNT(DISTINCT CONCAT(law_id, '-', number)) استفاده می‌شود (همان روش صفحه اصلی).

صفحه تنظیمات با تب‌بندی کامل (Tabs)

**مشکل قبلی:** همه تنظیمات در یک صفحه بلند به‌صورت پشت سر هم بود که خواندن و پیدا کردن تنظیمات خاص را سخت می‌کرد.
**راه‌حل:** صفحه تنظیمات به ۷ تب مجزا تقسیم شد:
1. **عمومی** — نام سایت، توضیحات، رنگ‌ها، حالت نگهداری
2. **آمار صفحه اصلی** — انتخاب بلوک‌های آماری + اعداد تقریبی
3. **مدیریت مواد** — حذف مواد تکراری + آمار مواد یکتا (با badge وقتی تکراری وجود دارد)
4. **هوش مصنوعی** — فعال‌سازی، ارائه‌دهنده، کلید API، تست اتصال
5. **سئو و گوگل** — Google Search Console، Google Analytics، OpenGraph
6. **هیدر و فوتر** ← جدید
7. **پشتیبان‌گیری** — دانلود فایل دیتابیس

ویژگی‌ها:

سفارشی‌سازی کامل هیدر و فوتر (جدید)

#### منوی هیدر قابل تنظیم

#### فوتر قابل تنظیم
- نقش طراح: «طراح و برنامه‌نویس» (قابل تغییر)
- نام طراح: «حامد بنائی» (پیش‌فرض)
- لینک بله: https://ble.ir/irsalam
- لینک تلگرام: https://t.me/irsalam

کلاس App\Helpers\Settings — متدهای جدید

صفحه «درباره ما» کامل و جامع

صفحه /about بازنویسی کامل شد:
- دکمه «ارتباط در بله» → لینک بله طراح
- دکمه «ارتباط در تلگرام» → لینک تلگرام طراح
- دکمه «فرم تماس» → صفحه تماس
- نام طراح: «حامد بنائی — طراح و برنامه‌نویس»

تنظیمات جدید (اضافه شده به update.php)

نتایج تست

| Test | Result |
|------|--------|
| TOC pin: list NOT auto-open | ✓ toc_open: false after pin |
| TOC pin: header sticky | ✓ position: sticky |
| Click pinned header opens list | ✓ toc_open: true |
| Settings page tabbed | ✓ 7 tabs all work |
| Active tab persists in localStorage | ✓ |
| Dedupe badge on «مدیریت مواد» tab | ✓ (when dupArticles > 0) |
| Header menu customizable | ✓ Renders 3+ items |
| Footer designer credit | ✓ Shows حامد بنائی + Bale + Telegram |
| About page comprehensive | ✓ 12 features + 3 steps + contact CTA |
| Save settings persists | ✓ verified via DB query |

فایل‌های تغییر یافته

---

رفع باگ بحرانی شمارش مواد در MySQL

**علت باگ:** کوئری COUNT(DISTINCT law_id || '-' || number) در SQLite درست کار می‌کرد (concat) اما در MySQL || عملگر OR منطقی است، بنابراین به‌جای تعداد واقعی مواد، ۱ یا ۲ برمی‌گرداشت.

**راه‌حل:** همه کوئری‌های || به CONCAT(law_id, '-', number) تغییر یافتند که در هر دو SQLite و MySQL درست کار می‌کند. ۴ مکان اصلاح شد:

دکمه‌های اکشن آیکون-فقط در موبایل + Tooltip

کنترل اندازه فونت مواد (A- A A+)

پین کردن فهرست مواد در موبایل (Sticky TOC)

- فهرست مواد (<details>) باز می‌شود
- به position: sticky; top: 56px تبدیل می‌شود (زیر هدر سایت)
- هنگام اسکرول، بالای صفحه می‌ماند
- برچسب دکمه به «حذف پین» تغییر می‌کند
- Toast پیام موفقیت نمایش داده می‌شود

سیستم سئوی کامل (SEO)

#### متا تگ‌های استاندارد

#### OpenGraph (Facebook، WhatsApp، Telegram)

#### Twitter Card

#### JSON-LD Structured Data

#### robots.txt

#### sitemap.xml
- صفحه اصلی (priority 1.0)
- صفحات استاتیک (categories, timeline, compare, tags, about, contact)
- همه قوانین منتشرشده (priority 0.8)
- **URLهای مستقیم هر ماده قانونی**: /law/{slug}/article/{N} (priority 0.5)
- همه دسته‌بندی‌ها (priority 0.6)
- همه برچسب‌ها (priority 0.4)

#### URLهای دوستدار سئو برای مواد قانونی

#### ادغام Google Search Console
- فیلد Google Search Console verification — کد تأیید مالکیت
- فیلد Google Analytics 4 — شناسه اندازه‌گیری (G-XXXXXXXX)
- فیلد OpenGraph default image — تصویر پیش‌فرض برای اشتراک‌گذاری
- فیلد Twitter handle — @username
- فیلد Keywords — کلمات کلیدی پیش‌فرض

#### Google Analytics 4

نتایج تست

| Test | Result |
|------|--------|
| Article count in MySQL | ✓ CONCAT() works |
| Mobile action buttons (icon-only at 375px) | ✓ 5 labels hidden |
| Tooltip on click | ✓ Shows for 2s |
| Font-size A+ | 15.2px → 16.8px ✓ |
| TOC sticky position after pin | static → sticky ✓ |
| Title on law page | <title>قانون ... · دیوان قانون</title> ✓ |
| Canonical URL | <link rel="canonical"> ✓ |
| JSON-LD BreadcrumbList | ✓ ۳ levels (خانه/دسته/قانون) |
| JSON-LD Legislation | ✓ With datePublished |
| robots.txt | ✓ 200 OK with sitemap link |
| sitemap.xml | ✓ 630 URLs (laws + articles + categories + tags) |
| Article deep-link /law/slug/article/N | ✓ 301 redirect to #article-N |
| Google Search Console meta | ✓ Renders when set |
| Google Analytics script | ✓ Loads gtag.js when GA ID set |

فایل‌های تغییر یافته

---

رفع مشکل شمارش مواد قانونی

ابزار حذف مواد تکراری (Dedupe)

- نمایش سه عدد: کل ردیف‌های مواد، مواد یکتا (DISTINCT)، ردیف‌های تکراری
- اگر ردیف تکراری وجود داشته باشد، دکمه «حذف مواد تکراری» فعال می‌شود
- با کلیک روی دکمه، ردیف‌های تکراری حذف و جدیدترین نسخه هر ماده نگه داشته می‌شود
- نمایش پیام موفقیت با تعداد ردیف‌های حذف‌شده

بهبودهای ویو موبایل (Mobile-First)

طراحی موبایل کامل بازنویسی شد تا تمرکز روی محتوای قانونی باشد و عناصر اضافه حذف شوند:

#### صفحه جزئیات قانون (Law Detail)
- شماره قانون ($law['number'])
- تعداد بازدید
- تعداد نظرات

#### کارت ماده قانونی (article-card)
- موبایل: ۴۰×۴۰ پیکسل (قبلاً ۴۸×۴۸)
- دسکتاپ: ۵۶×۵۶ پیکسل
- rounded-lg در موبایل، rounded-xl در دسکتاپ
- تعداد واژه‌ها (hidden sm:inline-block)
- تعداد بازدید ماده (hidden sm:inline-flex)
- **موبایل: فقط آیکون** (متن با hidden sm:inline مخفی می‌شود)
- دسکتاپ: آیکون + متن
- این کار فضای قابل‌توجهی آزاد کرد — موبایل قبلاً ۶ دکمه با متن بود، حالا ۶ آیکون فقط.
- gap: gap-1 sm:gap-2 (فشرده‌تر در موبایل)

نتایج تست موبایل (Viewport 375px — iPhone SE)

| سناریو | قبل | بعد |
|--------|-----|-----|
| اندازه badge شماره ماده | ۴۸×۴۸ | ۴۰×۴۰ ✓ |
| padding کارت ماده | ۲۰px | ۱۶px ✓ |
| اندازه فونت عنوان ماده | ۱۶px | ۱۴px ✓ |
| اندازه فونت عنوان قانون | ۳۲-۳۶px | ۲۰px ✓ |
| دکمه‌های اکشن در موبایل | آیکون + متن | فقط آیکون ✓ |
| متادیتای هدر قانون در موبایل | همه نمایش داده می‌شد | شماره قانون + بازدید + نظرات مخفی ✓ |
| متادیتای کارت ماده در موبایل | واژه + دقیقه + سختی + بازدید | فقط دقیقه + سختی ✓ |
| اسکرول افقی | وجود داشت | حذف شد ✓ |

فایل‌های تغییر یافته

---

آمار پویا و قابل کنترل صفحه اصلی

**تغییرات کلیدی:** آمار صفحه اصلی حالا کاملاً پویا، زنده و قابل کنترل از تنظیمات است.

#### ۱. آمار زنده از دیتابیس

#### ۲. اعداد تقریبی (اختیاری)
- 538 → 540+
- 1,243 → 1,200+
- 8,183 → 8,200+

#### ۳. کنترل کامل بلوک‌های آماری
- ✅ قوانین
- ✅ مواد قانونی
- ✅ دسته‌بندی‌ها
- ✅ **کاربران** ← قابل غیرفعال‌سازی برای حفظ حریم خصوصی
- ☐ برچسب‌ها (جدید)
- ☐ بازدید کل (جدید)
- از صفحه اصلی حذف می‌شود
- گرید به‌طور خودکار تنظیم می‌شود (۴/۳/۲ ستونی)
- از خروجی /api/stats هم حذف می‌شود (نشت جلوگیری می‌شود)

#### ۴. کلاس App\Helpers\Settings (جدید)

رفع باگ

---

هوش مصنوعی

تجربه کاربری

قابلیت‌های کاربری

پنل مدیریت

صفحه اصلی

رفع باگ

---