به‌روزرسانی فقط نصب فایل جدید نیست. پیش از شروع باید راه بازگشت داشته باشید و بدانید پس از پایان، کدام بخش‌های سایت را بررسی کنید.
این راهنما برای سایتی است که جم پک را از قبل نصب کرده است. برای نصب اولیه و ثبت لایسنس، از راهنمای نصب و فعال‌سازی استفاده کنید.
۱. پیش از شروع، وضعیت فعلی را ثبت کنید
ابتدا مشخص کنید چه چیزی قرار است تغییر کند و بعد از تغییر، چه نتیجه‌ای را انتظار دارید.
- نسخه نصب‌شده و نسخه مقصد را برای پیگیری داخلی یادداشت کنید.
- توضیحات انتشار فایل مقصد را بخوانید؛ اگر تغییر یا نیازمندی مؤثری دارد، قبل از ادامه آن را بررسی کنید.
- فهرست ماژول‌های فعال و تنظیمات مهم را ثبت کنید.
- یک نمونه از عملکرد بخش‌های اصلی داشته باشید؛ مثلاً نمایش تاریخ، ورود حساب آزمایشی یا محاسبه مبلغ سبد.
- پشتیبان فایل‌ها و پایگاه داده را تهیه کنید و مسیر بازگردانی آن را مشخص کنید.
- اگر لازم است، یک خروجی جدا از تنظیمات جم پک نیز نگه دارید. روش آن در راهنمای مدیریت و انتقال تنظیمات آمده است.
خروجی تنظیمات، جای پشتیبان کامل را نمی‌گیرد. ممکن است اطلاعات اتصال در خروجی نباشند و این فایل، سفارش‌ها، فایل‌های افزونه یا تمام داده‌های عملیاتی سایت را پوشش نمی‌دهد.
فایل خروجی را عمومی نکنید. پیش از اشتراک‌گذاری، محتوای آن را بررسی کنید؛ فایل بدون اطلاعات ورود هم ممکن است اطلاعات خصوصی داشته باشد.
زمان مناسب برای فروشگاه
بازه‌ای انتخاب کنید که بتوانید نتیجه را بلافاصله بررسی کنید. در صورت توقف سفارش‌گیری، از روش مشخص فروشگاه برای اطلاع‌رسانی و مدیریت سفارش‌های در حال پرداخت استفاده کنید.
به‌روزرسانی هم‌زمان جم پک، ووکامرس، قالب و چند افزونه دیگر، پیدا کردن علت مشکل را دشوار می‌کند. ابتدا وابستگی‌های ضروری را در محیط آزمایشی آماده کنید و تغییرها را جداگانه ثبت و بررسی کنید.
۲. به‌روزرسانی را از پیشخوان بررسی کنید
به‌روزرسانی جم پک از مسیر معمول وردپرس انجام می‌شود. اعلان نسخه جدید را در «پیشخوان ← به‌روزرسانی‌ها» یا فهرست افزونه‌های نصب‌شده بررسی کنید.
- صفحه به‌روزرسانی‌ها را باز کنید.
- اگر نیاز به بررسی تازه دارید، گزینه بررسی دوباره به‌روزرسانی‌ها را بزنید؛ عنوان ترجمه‌شده آن ممکن است در محیط شما کمی متفاوت باشد.
- به فهرست افزونه‌ها برگردید و اعلان مربوط به جم پک را بررسی کنید.
- اگر به‌روزرسانی ارائه شده، توضیحات و پیام کنار آن را بخوانید.
- اگر فایل دانلود در دسترس نیست، پیش از تلاش دوباره وضعیت لایسنس و پیام همان ردیف را بررسی کنید.
پیداشدن نسخه جدید با اجازه دانلود آن متفاوت است. ممکن است اعلان نسخه جدید را ببینید، اما فروشگاه برای سایت فعلی لینک بسته ارائه نکند.
اگر لایسنس منقضی باشد، پیام تمدید نمایش داده می‌شود. اگر لایسنس فعال است اما لینک دانلود دریافت نشده، ابتدا لایسنس را دوباره بررسی کنید؛ این خطا لزوماً به خرید یا تمدید نیاز ندارد.
بررسی دوباره به‌روزرسانی‌ها و «بررسی مجدد» در صفحه لایسنس، دو کار متفاوت‌اند. برای اصلاح وضعیت لایسنس، راهنمای نصب و ثبت لایسنس را دنبال کنید؛ سپس بررسی به‌روزرسانی‌ها را دوباره انجام دهید.
۳. به‌روزرسانی پیشنهادی را انجام دهید
بعد از آماده‌بودن پشتیبان و محیط:
- در ردیف جم پک، گزینه به‌روزرسانی را بزنید؛ یا در صفحه به‌روزرسانی‌ها، فقط جم پک را انتخاب و عملیات را اجرا کنید.
- تا نمایش نتیجه نهایی صبر کنید. هم‌زمان از تب دیگر نصب یا به‌روزرسانی همان افزونه را شروع نکنید.
- پیام موفقیت یا متن کامل خطا را ثبت کنید.
- در فهرست افزونه‌ها، نسخه نصب‌شده و فعال‌بودن جم پک را بررسی کنید.
- صفحه تنظیمات جم پک را دوباره باز کنید و به بخش بررسی نتیجه بروید.
پس از پیام موفقیت، ورود، ثبت سفارش و سایر قابلیت‌های مورد استفاده را هم آزمایش کنید. این پیام فقط نتیجه جایگزینی فایل‌ها را نشان می‌دهد.
پیش از به‌روزرسانی افزونه‌ها، داشتن پشتیبان نیز در راهنمای رسمی مدیریت افزونه‌های وردپرس توصیه شده است.
۴. اگر فایل ZIP معتبر دارید، آن را جایگزین کنید
اگر فایل ZIP به‌روزرسانی را از منبع رسمی و با مجوز دریافت کرده‌اید، آن را از بخش بارگذاری افزونه جایگزین کنید.
- از «افزونه‌ها ← افزودن افزونه تازه»، بخش «بارگذاری افزونه» را باز کنید.
- فایل ZIP معتبر جم پک را انتخاب کنید.
- نصب را شروع کنید.
- اگر وردپرس افزونه موجود را شناسایی کرد، نام افزونه، فایل فعلی و فایل بارگذاری‌شده را در صفحه مقایسه بررسی کنید.
- فقط اگر مقصد درست است، گزینه جایگزینی نسخه فعلی با فایل بارگذاری‌شده را بزنید.
- پس از پایان، نسخه نصب‌شده، وضعیت فعال‌بودن و نتیجه عملکرد سایت را بررسی کنید.
اگر وردپرس به‌جای شناسایی افزونه موجود، قصد ایجاد یک افزونه جدا دارد یا مقصد جایگزینی روشن نیست، ادامه ندهید. ساختار بسته و مسیر نصب فعلی باید بررسی شوند؛ برای رفع آن، نام پوشه‌ها را حدسی تغییر ندهید و نسخه قبلی را حذف نکنید.
گزینه جایگزینی فایل موجود، بخشی از مسیر بارگذاری و جایگزینی افزونه در وردپرس است. نام دقیق دکمه تابع ترجمه محیط شماست.
۵. نتیجه را با همان سناریوهای قبل بررسی کنید
پس از به‌روزرسانی، ماژول‌های مورد استفاده سایت را بررسی کنید؛ فعال‌کردن همه قابلیت‌ها برای آزمون لازم نیست.
| بخش مورد استفاده | بررسی پیشنهادی |
|---|---|
| تنظیمات جم پک | صفحه باز شود و مقادیر مهم با یادداشت پیش از به‌روزرسانی تطبیق داشته باشند. |
| تقویم شمسی | نمونه تاریخ ثبت‌شده پیش از تغییر، همچنان همان تاریخ را با نمایش مورد انتظار نشان دهد. |
| ورود و حساب کاربری | حساب آزمایشی بتواند وارد شود و مسیر ورود مدیریت در دسترس بماند. |
| سبد خرید و نشانی | مبلغ، قوانین مورد استفاده و انتخاب نشانی در نوع صفحه واقعی فروشگاه بررسی شوند. |
| پرداخت | طبق راهنمای درگاه، یک سناریوی کنترل‌شده بررسی شود؛ بازشدن صفحه پرداخت به‌تنهایی کافی نیست. |
| پیامک و اعلان‌ها | فقط رویداد موردنیاز با حساب و شماره آزمایشی بررسی شود؛ از ارسال گروهی ناخواسته جلوگیری کنید. |
| فاکتور یا اپلیکیشن | یک سفارش یا سناریوی نمونه را در مسیر واقعی استفاده بررسی کنید. |
نمونه بررسی یک فروشگاه
فرض کنید فروشگاه از تقویم شمسی، قوانین سبد خرید و درگاه زیبال استفاده می‌کند.
پیش از تغییر، تاریخ یک سفارش، نتیجه یک سبد مشخص و وضعیت ورود حساب آزمایشی را ثبت کنید. پس از به‌روزرسانی، همان نمونه‌ها را دوباره بررسی کنید و آزمون پرداخت را طبق راهنمای زیبال انجام دهید.
اگر تاریخ درست است اما پرداخت نتیجه مورد انتظار ندارد، به‌روزرسانی را برای همه بخش‌ها ناموفق اعلام نکنید. مشکل را به مسیر پرداخت محدود کنید و بررسی‌های همان درگاه را ادامه دهید.
تنظیمات قبلی چه می‌شوند؟
به‌روزرسانی معمول با حذف افزونه فرق دارد. با این حال، حفظ تنظیمات را از روی نتیجه واقعی بررسی کنید و به یک وعده کلی تکیه نکنید.
هنگام تکمیل تنظیمات پیش‌فرض، افزونه مقادیر موجود را حفظ می‌کند و گزینه‌های جدید را اضافه می‌کند. با این حال، بعضی به‌روزرسانی‌ها ممکن است ساختار تنظیمات را تغییر دهند یا اطلاعات قدیمیِ بلااستفاده را حذف کنند. تنظیمات مهم را پس از به‌روزرسانی بررسی کنید.
پس از به‌روزرسانی، کلیدهای اتصال، وضعیت ماژول‌ها و تنظیمات مؤثر را با یادداشت قبل تطبیق دهید. برای رفع یک مشکل، بدون بررسی فایل و اثر آن، کل خروجی تنظیمات را دوباره وارد نکنید؛ ورود فایل می‌تواند تنظیمات فعلی را جایگزین کند.
مشکلات رایج و روش بررسی آن‌ها
نسخه جدید در پیشخوان نمایش داده نمی‌شود
- نسخه نصب‌شده و وجود انتشار جدید را از منبع رسمی بررسی کنید.
- از صفحه به‌روزرسانی‌های وردپرس، بررسی دوباره را اجرا کنید؛ تازه‌کردن ساده صفحه همیشه معادل بررسی تازه نیست.
- وضعیت لایسنس و دامنه فعلی را در پنل جم پک مرور کنید.
- اگر پیام ارتباطی دارید، از مدیر هاست بخواهید ارتباط خروجی با
gempack.ir، DNS و ارتباط امن را بررسی کند. - ابزارهایی را که درخواست‌های خروجی پیشخوان را محدود می‌کنند بررسی کنید. تغییر آزمایشی آن‌ها را در محیط تست، یک‌به‌یک انجام دهید.
اگر ارتباط با سرویس به‌روزرسانی ناموفق باشد، ممکن است اعلان نسخه جدید نمایش داده نشود. در این حالت، نسخه نصب‌شده را با آخرین انتشار رسمی مقایسه کنید.
اعلان هست، اما دانلود یا دکمه به‌روزرسانی در دسترس نیست
پیام ردیف افزونه و وضعیت لایسنس را بررسی کنید. لایسنس منقضی، نبودن مجوز دانلود یا دریافت‌نشدن لینک بسته می‌توانند بررسی‌های متفاوتی لازم داشته باشند.
اگر لایسنس فعال است، آن را صرفاً برای آزمون حذف نکنید. ابتدا بررسی مجدد لایسنس و سپس بررسی تازه به‌روزرسانی‌ها را انجام دهید. اگر مشکل باقی ماند، پیام و زمان رخداد را برای پشتیبانی آماده کنید.
دانلود یا بازکردن بسته شکست می‌خورد
متن خطا مشخص می‌کند بررسی از کجا شروع شود. خطای ارتباط یا پایان زمان انتظار با خطای فایل نامعتبر یکسان نیست.
- ارتباط خروجی و دسترسی به فایل دانلود را از سمت هاست بررسی کنید.
- اگر بسته دستی دارید، مطمئن شوید فایل ZIP واقعی افزونه است؛ صفحه ورود یا خطای دانلود نباید به‌جای فایل ذخیره شده باشد.
- از پشتیبانی هاست بخواهید محدودیت بارگذاری و فضای آزاد برای دریافت و بازکردن فایل را بررسی کند.
- لینک کامل دانلود را عمومی نفرستید؛ ممکن است اطلاعات مجوز در آن باشد.
فایل‌ها کپی نمی‌شوند یا دسترسی فایل خطا می‌دهد
از مدیر هاست بخواهید مالکیت فایل‌ها، مجوز نوشتن، فضای آزاد و گزارش خطای همان عملیات را بررسی کند. برای حل سریع، مجوز باز و عمومی به تمام فایل‌های سایت ندهید.
چند روش جایگزینی را هم‌زمان اجرا نکنید. ابتدا معلوم شود عملیات قبلی پایان یافته و کدام فایل‌ها نصب شده‌اند.
افزونه فعال است، اما منو یا یک ماژول در دسترس نیست
به‌ترتیب بررسی کنید:
- آیا فایل درست نصب شده و افزونه در فهرست فعال است؟
- آیا حساب شما دسترسی لازم به جم پک دارد؟
- آیا بسته رمزگذاری‌شده به Loader مناسب نیاز دارد و پیام مرتبطی نمایش داده شده است؟
- آیا قابلیت به ووکامرس، مجوز Pro یا سرویس بیرونی وابسته است؟
- آیا پیام خطا یا هشدار در پنل دیده می‌شود؟
برای مسیر گزینه‌ها از راهنمای محیط و مدیریت ماژول‌ها استفاده کنید. در دسترس نبودن یک بخش، دلیل کافی برای پاک‌کردن تمام تنظیمات نیست.
صفحه یا فرم پس از به‌روزرسانی درست کار نمی‌کند
ابتدا مشخص کنید مشکل در پیشخوان، صفحه عمومی یا فقط یک فرم است. اگر مشکل به ظاهر یا اجرای فرم محدود است، فایل‌های ذخیره‌شده مرورگر و ابزارهای بهینه‌سازی را هم بررسی کنید.
در محیط آزمایشی، تأخیر یا ادغام جاوااسکریپت را موقتاً خاموش کنید و همان سناریو را دوباره اجرا کنید. تغییر را ثبت کنید؛ اگر بی‌اثر بود، آن را برگردانید و سراغ بررسی بعدی بروید.
پاک‌کردن حافظه موقت، جای بررسی خطای PHP یا ناقص‌بودن فایل‌ها را نمی‌گیرد. مسیر دقیق رفع مشکل به پیام و بخش درگیر وابسته است.
خطای جدی رخ داده یا ورود به پیشخوان ممکن نیست
عملیات را تکرار نکنید. زمان رخداد و پیام را ثبت کنید و از مدیر فنی یا پشتیبانی هاست بخواهید گزارش خطای PHP و کامل‌بودن فایل‌های افزونه را بررسی کند.
اگر مدیر فنی برای بازیابی دسترسی، جم پک را موقتاً غیرفعال می‌کند، افزونه را حذف نکنید. غیرفعال‌سازی امکانات آن را متوقف می‌کند و ممکن است بر ورود سفارشی، پرداخت یا اعلان‌ها اثر بگذارد. هم‌زمان راه ورود مدیر و وضعیت فروشگاه را بررسی کنید.
این راهنما بازگشت خودکار سایت یا حفظ همه مسیرهای ورود پس از غیرفعال‌سازی را تضمین نمی‌کند. بازیابی را با مدیر فنی و پشتیبان موجود انجام دهید.
اگر بازگشت به وضعیت قبل لازم شد
تعویض فایل افزونه و بازگردانی کامل سایت، دو تصمیم متفاوت‌اند. فایل قبلی ممکن است با داده‌هایی که پس از به‌روزرسانی تغییر کرده‌اند سازگار نباشد؛ صرف نصب فایل قدیمی تضمین بازگشت کامل نیست.
قبل از بازگردانی:
- وضعیت فعلی و داده‌های ایجادشده بعد از پشتیبان را ثبت و در صورت امکان حفظ کنید.
- مشخص کنید مشکل فقط به فایل مربوط است یا تغییر داده نیز رخ داده است.
- با مدیر فنی، روش بازگردانی مناسب و اثر آن بر سایت را تعیین کنید.
- پس از بازیابی، همان آزمون‌های ورود و عملیات اصلی را دوباره انجام دهید.
در فروشگاه، بازگردانی پایگاه داده قدیمی می‌تواند سفارش‌ها، پرداخت‌ها و تغییرات جدید را از سایت کنار بگذارد. قبل از آن، داده‌های جدید و تطبیق آن‌ها با تراکنش‌های واقعی باید مدیریت شوند. چندبار بازگردانی حدسی، راه رفع مشکل نیست.
برای پیگیری پشتیبانی چه اطلاعاتی آماده کنیم؟
- مرحله‌ای که مشکل رخ داده: بررسی نسخه، دانلود، جایگزینی فایل یا استفاده پس از به‌روزرسانی؛
- زمان رخداد و متن کامل خطا با حذف اطلاعات حساس؛
- مشخصات محیط و فایل مبدأ و مقصد در گزارش خصوصی؛
- نوع بسته و وضعیت Loader در صورت رمزگذاری؛
- ماژول درگیر و مراحل کوتاه بازتولید مشکل؛
- تغییرهای دیگری که هم‌زمان انجام شده‌اند و نتیجه آزمون محیط آزمایشی.
کلید لایسنس، گذرواژه، اطلاعات سرویس‌ها، اطلاعات مشتریان و لینک کامل دانلود را در تیکت یا تصویر عمومی نگذارید. برای ارسال اطلاعات حساس فقط از مسیر امن و مورد توافق پشتیبانی استفاده کنید.
قدم‌های بعدی
- نیازمندی‌ها و سازگاری جم پک برای بررسی محیط و محدودیت‌ها؛
- آشنایی با محیط جم پک و مدیریت ماژول‌ها برای یافتن بخش درگیر؛
- تنظیمات مشترک درگاه‌های پرداخت برای ادامه بررسی مشکلات پرداخت؛
- مرکز پیامک ووکامرس برای بررسی اتصال و رویدادهای پیامکی؛
- مدیریت، انتقال تنظیمات و کنترل دسترسی برای خروجی تنظیمات و سیاست حذف.