راهنمای راه‌اندازی Cron Job (برای هاست اشتراکی cPanel)
========================================================

فقط و فقط یک Cron Job لازم دارید. همه‌ی کارها (پیامک انقضا، نردبان اتوماتیک هر روز ساعت ۹ صبح،
و پاک‌سازی) در یک فایل واحد (cron/run.php) انجام می‌شود و با اجرای ساعتی همین یک کرون، همه‌چیز
خودکار کار می‌کند. نیازی به چند Cron Job جدا برای «پیامک» یا «نردبان» نیست.

قدم ۱ — تعیین یک کلید امنیتی (CRON_KEY)
----------------------------------------
فایل inc/config.php (که من دست نمی‌زنم چون در لیست فایل‌های ممنوعه بود) الان این خط را دارد:

    define('CRON_KEY', 'CHANGE_ME_long_random_string');

این مقدار پیش‌فرض و ناامن است. لطفاً خودتان این خط را با یک رشته‌ی تصادفی و طولانی جایگزین کنید،
مثلاً (یکی از این دو روش را به دلخواه انتخاب کنید):

  روش «الف» (ساده‌تر، توصیه می‌شود — PHP-CLI لازم ندارد):
    define('CRON_KEY', '654ad2126d2fb1b9e70545d7681947249050b916fb95a28f');
    (این رشته را فقط به‌عنوان نمونه ساختم؛ می‌توانید همین را استفاده کنید یا رشته‌ی تصادفی خودتان را بگذارید.)

قدم ۲ — ساخت Cron Job در cPanel
----------------------------------------
۱. وارد cPanel شوید → بخش «Cron Jobs» را باز کنید.
۲. در قسمت «Common Settings» گزینه‌ی «Once Per Hour» (هر ساعت یک‌بار) را انتخاب کنید
   (یا دستی این مقادیر را بزنید: Minute=0، Hour=*، Day=*، Month=*، Weekday=*)
۳. در قسمت «Command» یکی از دو حالت زیر را — بسته به اینکه هاست‌تان PHP-CLI دارد یا نه — وارد کنید:

   حالت «الف» (اگر PHP-CLI روی هاست در دسترس است — بهتر و سریع‌تر؛ اکثر هاست‌های cPanel دارند):
     /usr/local/bin/php /home/modirp/public_html/cron/run.php

     اگر این دستور خطا داد (یعنی مسیر php درست نیست)، از بخش «Select PHP Version» در cPanel
     آدرس دقیق PHP نسخه‌ی خودتان را پیدا کنید (معمولاً چیزی شبیه این می‌شود):
     /opt/cpanel/ea-php82/root/usr/bin/php /home/modirp/public_html/cron/run.php

   حالت «ب» (اگر PHP-CLI در دسترس نبود یا مطمئن نیستید — این را امتحان کنید، همیشه کار می‌کند):
     wget -q -O /dev/null "https://modirp.ir/cron/run.php?key=CRON_KEY_خودتان"

     به‌جای CRON_KEY_خودتان همان مقداری را بگذارید که در قدم ۱ در inc/config.php ست کردید.

۴. روی «Add New Cron Job» کلیک کنید.

همین! از این به بعد هر ساعت یک‌بار به‌صورت خودکار اجرا می‌شود و:
  • آگهی‌های منقضی‌شده را به وضعیت «نیاز به تمدید» می‌برد و پیامک یادآوری می‌فرستد (حداکثر یک پیامک
    به ازای هر کاربر در هر ۳۰ روز).
  • هر روز ساعت ۹ صبح، تاریخ آگهی‌هایی که «نردبان اتوماتیک» فعال دارند را به‌روز می‌کند.

نکته: اگر دوست دارید مطمئن شوید کرون درست کار می‌کند، چند ساعت بعد از ساختنش، آدرس زیر را با
مرورگر باز کنید و ببینید خروجی متنی (نه خطا) می‌بینید یا نه:
  https://modirp.ir/cron/run.php?key=CRON_KEY_خودتان
(این فقط برای تست دستی است؛ خود Cron Job نیازی به این کار ندارد.)
