Background Downloader – راهنمای سریع
====================================

نصب بدون تنظیمات پیچیده
-----------------------

1. فایل ZIP را روی هاست آپلود و از حالت فشرده خارج کنید.
2. مرورگر را باز کنید و بروید به:
   https://YOUR-DOMAIN.com/background-downloader/index.php
3. اگر صفحه سفید بود، بروید به:
   https://YOUR-DOMAIN.com/background-downloader/health.php
   تا علت را ببینید (معمولاً دسترسی نوشتن پوشه یا نسخه PHP).

استفاده
-------

1. لینک مستقیم فایل (http یا https) را در کادر وارد کنید.
2. دکمه «افزودن به صف» را بزنید.
3. برای شروع دانلود، صفحه زیر را باز کنید (بدون نیاز به Cron):
   https://YOUR-DOMAIN.com/background-downloader/run-worker.php
4. می‌توانید این صفحه را چند بار باز کنید یا در تب جدا بگذارید.
5. وضعیت از صفحه اصلی قابل مشاهده است.

اختیاری – Cron (اجرای خودکار)
-----------------------------

اگر می‌خواهید Worker خودش هر دقیقه اجرا شود:

* * * * * /usr/local/bin/php /home/USERNAME/public_html/background-downloader/worker-cron.php

مسیر PHP روی هر هاست فرق می‌کند.

نیازمندی‌ها
-----------

- PHP 7.4 یا بالاتر (ترجیحاً 8.x)
- افزونه cURL (تقریباً روی همه هاست‌ها فعال است)
- پوشه storage و downloads قابل نوشتن (معمولاً ۷۵۵)

اگر health.php مورد cURL را FAILED نشان داد، از MultiPHP INI Editor
یا پشتیبانی هاست، php-curl را فعال کنید.

فایل‌های مهم
------------

index.php        صفحه اصلی
api.php          API
run-worker.php   اجرای دستی Worker از مرورگر (بدون Cron)
worker-cron.php  برای Cron
health.php       تشخیص مشکل
downloads/       فایل‌های دانلود شده
