ارتقا

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

1. روش ارتقا از طریق SSH

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

2. روش ارتقای سنتی

   مهم

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

   مهم

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

   1. وب‌سایت خود را از طریق پنل مدیریت ← سیستم ← حالت تعمیر و نگهداری، در حالت تعمیر و نگهداری قرار دهید و به عنوان کاربر مدیر از سیستم خارج نشوید.
   2. حافظه پنهان (کش) وب‌سایت را از طریق پنل مدیریت ← پاک‌سازی حافظه پنهان، پاک کنید.
   3. آخرین نسخه را از ژاکت دانلود کنید.
   4. فایل فشرده (ZIP) دانلود شده را در پوشه ریشه (root folder) وب‌سایت خود آپلود کنید.
   5. فایل فشرده (ZIP) (که آپلود کرده‌اید) را با جایگزین کردن فایل‌های قدیمی، در پوشه ریشه وب‌سایت استخراج (extract) کنید. اطمینان حاصل کنید که هرگز فایل‌های /.env و /storage/installed را حذف یا جایگزین نکنید.
   6. (اگر افزونه‌ای نصب کرده‌اید) آن‌ها را به آخرین نسخه خود به‌روزرسانی کنید.
   7. به آدرس https://domain.tld/upgrade مراجعه کرده و روی دکمه «اکنون ارتقا بده» (Upgrade Now) کلیک کنید (اطمینان حاصل کنید که به عنوان مدیر وارد شده‌اید).
   8. پس از تکمیل به‌روزرسانی، وب‌سایت شما به طور خودکار فعال خواهد شد و به صفحه اصلی هدایت می‌شوید.

نکات ارتقا

مهم

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

مهم

اگر سرور یا ارائه‌دهنده هاستینگ شما از نوعی حافظه پنهان فایل (مانند supercacher، opcache، cloudflare cache و غیره) استفاده می‌کند، لازم است پس از به‌روزرسانی، آن حافظه پنهان را پاک کنید، در غیر این صورت ممکن است برخی از تغییرات اعمال شده در به‌روزرسانی به درستی کار نکنند.

اگر خطایی مربوط به کد خرید (Purchase Code) دریافت کردید، باید:

• کد خرید (لایسنس) خود را از برگه دانلود‌ها در حساب کاربری ژاکت بردارید.
• یک ورودی جدید برای کد خرید خود در فایل /.env به این صورت اضافه کنید: PURCHASE_CODE=yourpurchasecode یا به پنل مدیریت خود وارد شوید ← راه‌اندازی (Setup) ← تنظیمات عمومی (General Settings) ← برنامه (Application) ← کد خرید (Purchase Code) و این بخش را ویرایش کنید تا کد خرید خود را اضافه نمایید.