به‌روزرسانی

نکته بسیار مهم: پیش از شروع فرآیند به‌روزرسانی در هر دو روش، حتماً از تمامی فایل‌ها و پایگاه داده (Database) وب‌سایت خود نسخه پشتیبان (Backup) تهیه کنید.

روش به‌روزرسانی از طریق SSH

این روش برای کاربرانی که دسترسی ترمینال دارند سریع‌تر و امن‌تر است:

1. حالت تعمیر و نگهداری: وب‌سایت خود را از مسیر پنل مدیریت ← سیستم ← حالت تعمیر و نگهداری، غیرفعال کنید. (توجه: از حساب مدیریت خود خارج نشوید).
2. پاک‌سازی کش: حافظه پنهان را از مسیر پنل مدیریت ← پاک‌سازی حافظه پنهان، پاک کنید.
3. دریافت نسخه جدید: آخرین نسخه اسکریپت را از پنل کاربری خود دانلود کنید.
4. آپلود: فایل ZIP دانلود شده را در پوشه ریشه (Root) وب‌سایت آپلود کنید.
5. تغییر نام: نام فایل آپلود شده را به website.zip تغییر دهید.
6. اجرای دستور استخراج: از طریق ترمینال وارد پوشه ریشه شوید و دستور زیر را اجرا کنید: unzip -o website.zip -x ".htaccess" -x "public/.htaccess" -x "public/css/custom.css"
7. حفاظت از فایل‌های حساس: هرگز فایل‌های /.env و /storage/installed را حذف یا جایگزین نکنید.
8. به‌روزرسانی افزونه‌ها: اگر افزونه‌ای نصب کرده‌اید، آن‌ها را نیز به آخرین نسخه ارتقا دهید.
9. پایان عملیات: به آدرس https://domain.tld/upgrade بروید و روی دکمه «اکنون ارتقا بده» (Upgrade Now) کلیک کنید. پس از اتمام، سایت به طور خودکار فعال شده و به صفحه اصلی هدایت می‌شوید.

روش به‌روزرسانی سنتی (دستی)

اگر دسترسی SSH ندارید، این مراحل را دنبال کنید:

پشتیبان‌گیری از تغییرات ظاهری

اگر سفارشی‌سازی CSS انجام داده‌اید، از فایل /public/css/custom.css خود نسخه پشتیبان تهیه کنید و پس از به‌روزرسانی، محتوای آن را با آخرین نسخه جایگزین (overwrite) کنید. (اگر هیچ‌گونه سفارشی‌سازی CSS انجام نداده‌اید، می‌توانید از این مرحله صرف‌نظر کنید).

پشتیبان‌گیری از ترجمه‌ها

اگر ترجمه‌ای انجام داده‌اید، از فایل‌های زبان خود در پوشه /lang/ نسخه پشتیبان تهیه کنید و پس از به‌روزرسانی، محتوای آنها را ادغام کنید. (اگر هیچ ترجمه‌ای انجام نداده‌اید، می‌توانید از این مرحله صرف‌نظر کنید).

1. آماده‌سازی سایت: مطابق روش قبل، سایت را در حالت تعمیر قرار داده و کش را پاک کنید.
2. جایگزینی فایل‌ها: فایل ZIP نسخه جدید را در ریشه سایت استخراج (Extract) کرده و اجازه دهید فایل‌های قدیمی جایگزین شوند. (مراقب باشید فایل‌های .env و installed تغییر نکنند).
3. اجرای ارتقا: به آدرس domain.tld/upgrade مراجعه کرده و دکمه «اکنون ارتقا بده» (Upgrade Now) را بزنید.

نکات مهم به‌روزرسانی

امنیت داده‌ها

در طول فرآیند ارتقا، هیچ‌یک از کاربران، آگهی‌ها، تنظیمات یا فایل‌های آپلود شده حذف نخواهند شد.

کش سرور

اگر از سرویس‌هایی مثل Cloudflare، OPcache یا SuperCacher استفاده می‌کنید، حتماً پس از ارتقا کش آن‌ها را پاک کنید تا تغییرات جدید به درستی نمایش داده شوند.

خطای کد خرید (Purchase Code)

اگر با خطای لایسنس مواجه شدید، کد خرید خود را در فایل /.env مقابل متغیر PURCHASE_CODE= قرار دهید یا از مسیر پنل مدیریت ← راه‌اندازی (Setup) ← تنظیمات عمومی (General Settings) ← برنامه (Application) ← کد خرید (Purchase Code) آن را وارد کنید.

اخطار

• استثناء برای نسخه ۷.۱.۰:

  • شما باید قبل یا بعد از اجرای لینک ارتقا، پوشه /storage/app/public/app/default/ را روی سرور خود آپلود/جایگزین کنید.

• در نسخه‌های ۵.۱ و بالاتر:

  • شما باید تمام افزونه‌های خریداری شده (add-ons) را با استفاده از کد خرید آن‌ها از طریق پنل مدیریت ← افزونه‌ها، فعال کنید.

• (فقط) اگر وب‌سایت شما روی نسخه ۴.۸ یا پایین‌تر اجرا می‌شود، دانستن این نکته مهم است که:

  • قبل از شروع ارتقا، باید تمام محتویات پوشه /public/uploads/ را به پوشه /storage/app/public/ منتقل کنید.

• (فقط) اگر وب‌سایت شما روی نسخه ۴.۳ یا پایین‌تر اجرا می‌شود: با ارتقای وب‌سایت خود به نسخه ۴.۴، دانستن نکات زیر حائز اهمیت است:

  • تمام تنظیمات موجود در پنل مدیریت ← تنظیمات را از دست خواهید داد و باید وب‌سایت خود را دوباره پیکربندی کنید.
  • تمام پیام‌های داخلی فعلی (که به آدرس ایمیل گیرندگان نیز ارسال شده‌اند) را از دست خواهید داد.
  • اگر بخواهید گزینه بازبینی آگهی‌ها (تایید آگهی) را دوباره فعال کنید، تمام آگهی‌های موجود به صورت خودکار تایید خواهند شد.
  • لازم است پس از ارتقا، تمام افزونه‌های اسکریپت را (حذف نصب و) مجدداً نصب کنید.
  • تمام داده‌ها و تنظیمات افزونه‌ها را از دست خواهید داد (به جز سوابق تراکنش‌های افزونه‌های پرداخت).

• (فقط) اگر وب‌سایت شما روی نسخه ۳.۴ یا پایین‌تر اجرا می‌شود، قبل از شروع ارتقا باید:

  • این عبارت را به فایل /.env اضافه کنید: APP_VERSION=X.X (مثال: اگر نسخه فعلی شما 3.4 است، APP_VERSION=3.4 را وارد کنید یا برای نسخه 1.4، APP_VERSION=1.4 را وارد کنید).
  • یک عبارت جدید برای کد خرید خود در فایل /.env به این شکل اضافه کنید: PURCHASE_CODE=yourpurchasecode.
  • (در صورت وجود) عبارت DB_PREFIX= را در فایل /.env به DB_TABLES_PREFIX= تغییر دهید.
  • (در صورت وجود) عبارت‌های SESSION_DRIVER=file و SESSION_DOMAIN=.mysite.com را از فایل /.env حذف کنید.