Files.ir WordPress Backup Plugin v1.3.0

Files.ir WordPress Backup v1.3.0 — Release Notes

First stable production release on master. Major upgrade from the legacy v1.0.2 codebase.

---

خلاصه تغییرات

این انتشار، بازنویسی کامل افزونه از تک‌فایل ۱.۰.۲ به یک معماری ماژولار و حرفه‌ای است.
مشکل اصلی HTTP 413 (Request Entity Too Large) برای آپلود فایل‌های بزرگ کاملاً برطرف
شده و امکانات بازیابی، زمان‌بندی پیشرفته و UI تب‌بندی‌شده اضافه شده است.

---

برجسته‌ترین تغییرات نسبت به v1.0.2

پشتیبانی از API جدید Files.ir (Uploads-new)

• استفاده از endpoint /uploads-new/* با پشتیبانی session-based از همه‌ی مودها:
  • s3-single برای فایل‌های زیر ۱۰۰ مگابایت
  • s3-multipart برای فایل‌های بزرگ‌تر، با تقسیم خودکار به chunkهای ۲۰ مگابایتی
  • پشتیبانی forward-compat از مودهای tus و single
• مدیریت خودکار parentId برای ساخت پوشه‌ی مقصد در Files.ir
• در تست واقعی: فایل ۶۰۰ مگابایتی در ۳۶ ثانیه با ۳۱ تکه آپلود شد (در پلن سامان فایلز) ✅

معماری ماژولار

• ساختار جدید با ۸ کلاس مستقل:
  • FDU_Backup_Database — خروجی‌گیری دیتابیس (mysqldump یا PHP)
  • FDU_Backup_Files — ساخت آرشیو ZIP/TAR.GZ
  • FDU_Uploader_V2 — کلاینت API جدید
  • FDU_Folder_Manager — مدیریت پوشه مقصد
  • FDU_Restore_Manager — بازیابی از بکاپ
  • FDU_Scheduler — زمان‌بندی WP-Cron با self-ping
  • FDU_Logger — سیستم لاگ
  • FDU_Admin — UI تب‌بندی‌شده

امکان بازیابی (Restore)

• بازیابی دیتابیس و فایل‌ها از:
  • بکاپ‌های محلی روی هاست
  • بکاپ‌های ذخیره‌شده در Files.ir (دانلود + بازیابی)
• ساخت بکاپ امنیتی خودکار قبل از هر بازیابی
• پشتیبانی از mysql CLI و PHP-based import به‌صورت خودکار

امکانات بکاپ پیشرفته

• بکاپ دیتابیس: mysqldump یا fallback خودکار به PHP
• بکاپ فایل‌ها: ZIP یا TAR.GZ، با مسیرهای include/exclude قابل تنظیم
• شامل کردن یا نکردن wp-config.php و .htaccess
• الگوهای exclude با glob patterns

زمان‌بندی پیشرفته

• اجرای روزانه یا هفتگی در ساعت/دقیقه دلخواه
• پشتیبانی از Worker URL برای cron سرور (دور زدن WP-Cron)
• Self-ping برای اطمینان از اجرای رویدادها در سایت‌های کم‌بازدید
• بازتنظیم خودکار زمان‌بندی پس از هر اجرا

رابط کاربری مدرن

• پنل تنظیمات با ۶ تب: API، دیتابیس، فایل‌ها، زمان‌بندی، بازیابی، پیشرفته
• سکشن «پوشه مقصد در Files.ir» با نمایش وضعیت و دکمه بازنشانی
• لاگ مشاهده‌ای داخل پنل ادمین

پاکسازی و بهبودهای پایداری

• حذف کد آپلود chunked قدیمی که عملاً کار نمی‌کرد (~۱۷۰ خط کد مرده پاک شد)
• پیش‌فرض «نگه‌داشتن کپی محلی» به غیرفعال تغییر کرد (cloud به‌عنوان منبع اصلی)
• مدیریت بهتر خطاهای API و نمایش پیام‌های واضح‌تر
• لاگ‌های مفصل با درصد پیشرفت برای آپلودهای بزرگ
• فلگ rollback اضطراری (use_legacy_uploader) برای بازگشت به API قدیمی در صورت نیاز

---

برای کاربران فعلی (مهاجرت از v1.0.2)

این یک ارتقای بزرگ است. توصیه می‌شود:

1. ابتدا یک بکاپ دستی از کل افزونه قبلی بگیرید
2. پس از نصب نسخه جدید، به تنظیمات → Files.ir Backup → API بروید و توکن خود را وارد کنید
3. به تنظیمات → Files.ir Backup → پیشرفته بروید و مسیر پوشه مقصد را تنظیم کنید (پیش‌فرض: wp-backups)
4. در تب زمان‌بندی ساعت اجرا را تنظیم کنید
5. در تب API دکمه «آپلود فایل تستی» را بزنید تا اتصال تأیید شود

---

محدودیت‌های شناخته‌شده

• سقف حجم فایل: Files.ir بسته به پلن کاربر سقف حجم برای هر فایل اعمال می‌کند
  (مثلاً پلن سامان: ۱ گیگابایت). برای سایت‌های بزرگ‌تر، در نسخه‌های بعدی امکان
  تقسیم بکاپ به آرشیوهای کوچک‌تر بر اساس مسیر اضافه خواهد شد.

---

الزامات

• WordPress 5.6 یا بالاتر
• PHP 7.4 یا بالاتر
• اکستنشن cURL فعال
• توکن API از Files.ir (از قسمت Account Settings)

---

گزارش مشکلات

اگر به مشکلی برخوردید، لطفاً با اطلاعات زیر یک issue باز کنید:

• نسخه WordPress و PHP
• خروجی لاگ افزونه (تب پیشرفته → بخش لاگ‌ها)
• شرح دقیق مشکل و مراحل بازتولید