# راهنمای ارتقا به دکمه‌های رنگی بومی

این بسته جایگزین، اطلاعات اتصال و مدیر ارسالی شما را در `config/config.php` دارد. برای اینکه تغییرات روی ربات فعال شما اعمال شوند، پوشه‌های جدید را جایگزین کرده و سپس مهاجرت پایگاه داده را فقط یک‌بار اجرا کنید.

> اطلاعات ورود و توکن در این ZIP وجود دارد. فایل را فقط روی دستگاه و هاست مورداعتماد نگه دارید و آن را در گروه، کانال یا مخزن عمومی ارسال نکنید.

## مراحل ارتقا

| گام | اقدام |
| --- | --- |
| 1 | از فایل‌های فعلی و پایگاه داده یک نسخهٔ پشتیبان بگیرید. |
| 2 | فایل ZIP را استخراج و محتویات پوشهٔ `PrizePilotBot` را داخل مسیر فعلی پروژه، یعنی `bet/`، جایگزین کنید. |
| 3 | در phpMyAdmin دیتابیس `pjeogvj_bet` را انتخاب کنید و محتوای `database/migrations/2026_08_26_native_styles_and_module_status.sql` را در تب **SQL** اجرا کنید. |
| 4 | فایل `public/setup_webhook.php` را پس از آپلود حذف کنید؛ نیازی به ثبت دوبارهٔ وبهوک نیست، زیرا نشانی و secret تغییر نکرده‌اند. |
| 5 | با ارسال `/start` منوی جدید رنگی و با ارسال `/panel` دکمهٔ جدید «وضعیت ماژول‌ها» را آزمایش کنید. |

## تغییرات اعمال‌شده

| بخش | نتیجه |
| --- | --- |
| کیبوردهای ربات | فیلد `style` بدون حذف به تلگرام ارسال می‌شود؛ دیگر ایموجی آبی اضافه نمی‌شود. |
| طراحی منوی کاربر | در ردیف‌های دوتایی، دکمهٔ چپ `primary` (آبی) و دکمهٔ راست `success` (سبز) است؛ دکمه‌های تکی `danger` (قرمز) هستند. |
| نام سرویس | عنوان `🔐 VPN` به `🔐 فیلترشکن` تغییر می‌کند. |
| پنل ادمین | وضعیت ماژول‌ها از خلاصهٔ داشبورد خارج شده و در دکمهٔ مستقل `🧩 وضعیت ماژول‌ها` قرار گرفته است. |

> در مستندات رسمی تلگرام، `primary` برای اقدام اصلی، `success` برای اقدام مثبت و `danger` برای اقدام خطرناک به‌عنوان رنگ‌های بومی دکمه معرفی شده‌اند. [1]

## منبع

[1] [Telegram API — Bot Buttons and Button Styles](https://core.telegram.org/api/bots/buttons)