راهنمای نصب ربات پروژه یاب و فریلنسری

با این راهنما، ربات خود را در کمتر از ۱۰ دقیقه نصب و فعال کنید.

این راهنما به صورت **زنده** عمل می‌کند. برای شروع، اطلاعات کلیدی ربات خود را در **«مرکز پیکربندی»** زیر وارد کنید. با این کار، تمام دستورات و فایل‌های نمونه در ادامه راهنما به صورت خودکار برای شما شخصی‌سازی می‌شوند تا فرآیند نصب سریع و بدون خطا باشد.

🚀 مرکز پیکربندی زنده

قدم ۱: آپلود سورس و تنظیم PHP

در این مرحله، فایل‌های ربات را روی هاست خود بارگذاری کرده و نسخه PHP را تنظیم می‌کنید.

  1. وارد cPanel هاست خود و سپس به بخش File Manager بروید.
  2. وارد پوشه public_html شوید.
  3. فایل project.zip را Upload کرده و سپس آن را Extract کنید.
نسخه PHP الزامی: 8.2
هاست شما باید از نسخه PHP 8.2 پشتیبانی کند. در cPanel، این نسخه معمولاً با نام ea-php82 شناخته می‌شود. لطفاً از طریق بخش MultiPHP Manager در سی‌پنل، نسخه PHP دامنه یا پوشه مربوط به ربات را روی ea-php82 تنظیم کنید.
نکته مهم: این سورس کد شامل پوشه vendor است و شما **نیازی به نصب Composer ندارید**.

قدم ۲: ساخت دیتابیس

دیتابیس، محل ذخیره‌سازی اطلاعات کاربران، آگهی‌ها و تراکنش‌های ربات شماست.

  1. در cPanel به MySQL® Databases بروید.
  2. یک **دیتابیس جدید (Create New Database)** و یک **کاربر جدید (Add New User)** با رمز عبور قوی بسازید.
  3. در بخش "Add User To Database"، کاربر را به دیتابیس متصل کرده و دسترسی ALL PRIVILEGES را به او بدهید.
  4. اطلاعات دیتابیس را در **مرکز پیکربندی** بالای صفحه وارد کنید تا در مراحل بعد از آن استفاده شود.

قدم ۳: ایمپورت جداول SQL

در این مرحله، ساختار جداول مورد نیاز ربات را به دیتابیس خالی خود اضافه می‌کنید.

  1. در cPanel به phpMyAdmin بروید.
  2. دیتابیس خود را از منوی سمت چپ انتخاب کنید.
  3. به تب Import رفته، فایل sql table.sql را انتخاب و روی Import (یا Go) کلیک کنید.

قدم ۴: پیکربندی فایل .env

این فایل، شناسنامه ربات شماست و تمام اطلاعات کلیدی و محرمانه را در خود نگه می‌دارد.

  1. در File Manager، وارد پوشه project شوید.
  2. فایل .env را برای ویرایش باز کنید (اگر وجود نداشت، .env.example را به .env تغییر نام دهید).
فایل .env شما آماده است! محتوای زیر بر اساس اطلاعاتی که در «مرکز پیکربندی» وارد کردید، ساخته شده است. آن را کپی کرده و در فایل .env خود جایگزین کنید.

قدم ۵: تنظیم وبهوک (فعال‌سازی ربات)

این آدرس، پل ارتباطی بین سرور تلگرام و ربات شماست. با اجرای این آدرس در مرورگر، ربات شما آنلاین و آماده دریافت دستورات می‌شود.

توجه: آدرسی که در فیلد APP_URL وارد می‌کنید باید آدرس اینترنتی (عمومی) پوشه project شما باشد، نه آدرس داخلی سرور (مانند public_html).

آدرس زیر به صورت خودکار برای شما ساخته شده است. آن را کپی کرده و در نوار آدرس مرورگر خود اجرا کنید.

پس از اجرا، باید یک پیام موفقیت با فرمت {"ok":true,"result":true,"description":"Webhook was set"} مشاهده کنید.

قدم ۶: تنظیمات نهایی از پنل ادمین

بسیار مهم

تبریک! ربات شما نصب شده است. اما قبل از استفاده عمومی، یک قدم مهم باقی مانده است.

  1. به ربات خود در تلگرام بروید و دستور /start را ارسال کنید.
  2. چون شما ادمین اصلی هستید، دکمه «👑 پنل مدیریت» برای شما نمایش داده می‌شود. وارد آن شوید.
  3. به بخش **«⚙️ تنظیمات ربات»** بروید.
  4. تمام گزینه‌ها را بررسی کرده و مطابق با نیاز خود تنظیم کنید:
    • **هزینه آگهی:** مبلغ مورد نظر برای ثبت هر آگهی را وارد کنید (می‌توانید صفر بگذارید).
    • **جایزه دعوت:** مبلغ هدیه برای هر زیرمجموعه را مشخص کنید.
    • **کانال اصلی:** آیدی کانال عمومی (`@username`) یا خصوصی (`-100...`) خود را برای انتشار آگهی‌ها وارد کنید.
    • **آیدی پشتیبانی:** آیدی تلگرام خود را برای ارتباط کاربران وارد کنید.
نکته کلیدی: تا زمانی که این تنظیمات را انجام ندهید، ممکن است بخش‌هایی از ربات مانند انتشار آگهی یا پشتیبانی به درستی کار نکنند.

⚠️ قوانین استفاده و لایسنس سورس کد

با خرید و استفاده از این سورس کد، شما با قوانین زیر موافقت می‌کنید:

🚀 ربات شما آماده است!

تمام مراحل با موفقیت به پایان رسید. ربات «پروژه یاب و فریلنسری» شما آنلاین و آماده خدمت‌رسانی است. در صورت نیاز به راهنمایی یا بروز مشکل، از طریق راه‌های ارتباطی که هنگام خرید دریافت کرده‌اید، با ما در تماس باشید.