راهنمای جامع و تخصصی رفع مشکل افزونه ناپ کامرس

پیش‌نیازهای عیب‌یابی قبل از هر اقدامی

پیش از هر اقدامی برای رفع مشکل افزونه ناپ کامرس، مطمئن شوید که موارد زیر را در دسترس دارید:

• دسترسی به پنل هاست – از طریق cPanel، DirectAdmin یا File Manager.
• دسترسی به پنل مدیریت وردپرس – در صورتی که خطا اجازه ورود می‌دهد.
• دسترسی به پایگاه داده – از طریق phpMyAdmin یا ابزار مشابه.
• پشتیبان کامل – از فایل‌ها و دیتابیس قبل از هر تغییر.
• اطلاعات درگاه پرداخت – کلیدهای API، مرچنت آیدی و سایر اطلاعات احراز هویت.

خطاهای رایج در نصب و فعال‌سازی افزونه

خطای عدم سازگاری با نسخه ووکامرس

یکی از رایج‌ترین خطاها هنگام نصب افزونه ناپ کامرس، پیام "این افزونه با نسخه فعلی ووکامرس سازگار نیست" است. این خطا معمولاً به دلیل به‌روز نبودن ووکامرس یا استفاده از نسخه قدیمی ناپ کامرس رخ می‌دهد.

راه‌حل‌های پیشنهادی:

1. به‌روزرسانی ووکامرس – به مسیر پیشخوان → بروزرسانی‌ها بروید و ووکامرس را به آخرین نسخه بروزرسانی کنید.
2. دانلود نسخه جدید ناپ کامرس – از وب‌سایت رسمی توسعه‌دهنده، آخرین نسخه افزونه را دانلود و نصب کنید.
3. بررسی نیازمندی‌های سیستم – مطمئن شوید که سرور شما از PHP 7.4 یا بالاتر پشتیبانی می‌کند.

خطای فعال‌سازی افزونه (فایل هدر نامعتبر)

گاهی پس از آپلود افزونه، با پیام "فایل هدر افزونه نامعتبر است" مواجه می‌شوید. این مشکل معمولاً به دلیل آپلود ناقص یا خرابی فایل‌های افزونه رخ می‌دهد.

مراحل رفع این مشکل:

1. افزونه را به صورت دستی از طریق افزونه‌ها → افزودن جدید → بارگذاری افزونه آپلود کنید.
2. فایل زیپ را از منبع معتبر دانلود کنید و از سالم بودن آن اطمینان حاصل نمایید.
3. اگر مشکل ادامه داشت، افزونه را از طریق FTP در مسیر /wp-content/plugins/ نصب کنید.

مشکلات اتصال به درگاه‌های پرداخت

خطای اتصال به درگاه (Connection Timeout)

یکی از رایج‌ترین شکایت‌ها، خطای "اتصال به درگاه پرداخت ناموفق بود" یا "درگاه پاسخ نمی‌دهد" است.

دلایل احتمالی و راه‌حل‌ها:

دلیل اول: تنظیمات نادرست کلیدهای API

کلیدهای API خود را از پنل درگاه پرداخت مجدداً بررسی کنید. معمولاً این کلیدها شامل Merchant ID، Terminal ID و کلید خصوصی هستند.

دلیل دوم: مسدود بودن IP سرور توسط درگاه

برخی درگاه‌های پرداخت، IP سرور شما را مسدود کرده‌اند. با پشتیبانی درگاه تماس بگیرید و IP سرور خود را برای لیست سفید ارسال کنید.

دلیل سوم: فعال نبودن SSL (گواهی امنیتی)

برای اتصال به اکثر درگاه‌ها، وجود گواهی SSL الزامی است. از فعال بودن SSL روی دامنه خود اطمینان حاصل کنید.

خطای بازگشت ناموفق (Callback Error)

پس از پرداخت موفق، مشتری به صفحه خطا هدایت می‌شود یا سفارش به روز نمی‌شود.

راه‌حل‌ها:

1. بررسی آدرس بازگشت – در تنظیمات درگاه پرداخت، آدرس بازگشت (Callback URL) را بررسی کنید. معمولاً به صورت site.com/wc-api/nap-commerce/ است.
2. بررسی تنظیمات پیوند یکتا – به تنظیمات → پیوندهای یکتا بروید و گزینه نام پست‌ها را انتخاب کرده و تغییرات را ذخیره کنید.
3. غیرفعال کردن کش – اگر از افزونه کش استفاده می‌کنید، صفحه پرداخت و بازگشت را از کش خارج کنید.

مشکلات مربوط به محاسبه حمل‌ونقل و مالیات

محاسبه اشتباه هزینه ارسال

گاهی هزینه حمل‌ونقل به درستی محاسبه نمی‌شود یا مبلغ صفر نمایش داده می‌شود.

مراحل عیب‌یابی:

1. بررسی تنظیمات حمل‌ونقل – به ووکامرس → تنظیمات → حمل‌ونقل بروید و روش‌های حمل‌ونقل را بررسی کنید.
2. بررسی مناطق حمل‌ونقل – مطمئن شوید که منطقه ارسال مشتری در مناطق تعریف شده وجود دارد.
3. بررسی وزن و ابعاد محصولات – اگر هزینه بر اساس وزن است، وزن محصولات را به درستی وارد کنید.

خطای محاسبه مالیات

مالیات به درستی محاسبه نمی‌شود یا اصلاً اعمال نمی‌شود.

راه‌حل‌های پیشنهادی:

1. فعال کردن مالیات در ووکامرس – به ووکامرس → تنظیمات → مالیات بروید و گزینه فعال‌سازی مالیات را روشن کنید.
2. بررسی کلاس‌های مالیاتی – مطمئن شوید که کلاس مالیاتی صحیح به محصولات اختصاص داده شده است.
3. بررسی نرخ مالیات – نرخ مالیات را برای استان و کشور مورد نظر به درستی وارد کنید.

مشکلات مربوط به تخفیف‌ها و کدهای هدیه

کد تخفیف اعمال نمی‌شود

مشتریان گزارش می‌دهند که کد تخفیف را وارد می‌کنند اما تخفیف اعمال نمی‌شود.

دلایل و راه‌حل‌ها:

دلیل اول: انقضای کد تخفیف

تاریخ انقضای کد تخفیف را بررسی کنید. ممکن است کد منقضی شده باشد.

دلیل دوم: محدودیت حداقل مبلغ

مبلغ سبد خرید ممکن است کمتر از حداقل مبلغ تعیین شده برای کد تخفیف باشد.

دلیل سوم: تداخل با سایر تخفیف‌ها

بررسی کنید که آیا تخفیف دیگری با این کد تداخل دارد یا خیر. گاهی تخفیف‌ها قابل جمع شدن نیستند.

تخفیف درصدی به اشتباه محاسبه می‌شود

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

راه‌حل:

ترتیب اعمال تخفیف‌ها را در تنظیمات افزونه بررسی کنید. معمولاً گزینه‌ای برای تعیین اولویت تخفیف‌ها وجود دارد.

مشکلات مربوط به ایمیل‌ها و اعلان‌ها

ایمیل‌های تأیید سفارش ارسال نمی‌شوند

پس از ثبت سفارش، ایمیل تأیید برای مشتری ارسال نمی‌شود.

مراحل عیب‌یابی:

1. بررسی تنظیمات SMTP – از تنظیمات صحیح SMTP در وردپرس اطمینان حاصل کنید.
2. بررسی تنظیمات ایمیل در ناپ کامرس – به بخش تنظیمات اعلان‌های افزونه بروید و مطمئن شوید که ایمیل‌ها فعال هستند.
3. بررسی پوشه اسپم – گاهی ایمیل‌ها به پوشه اسپم ارسال می‌شوند.
4. نصب افزونه ایمیل‌لاگ – از افزونه‌های لاگ‌گیری ایمیل مانند WP Mail Logging استفاده کنید تا خطاهای ارسال را مشاهده کنید.

اعلان‌های پیامکی ارسال نمی‌شوند

اگر از سرویس پیامکی استفاده می‌کنید و اعلان‌ها ارسال نمی‌شوند:

راه‌حل‌ها:

1. بررسی اعتبار سرویس پیامکی – مطمئن شوید که حساب شما فعال است و موجودی کافی دارد.
2. بررسی تنظیمات API – کلید API و شماره خط ارسال‌دهنده را مجدداً بررسی کنید.
3. بررسی الگوی پیامک – الگوی پیامک را با استانداردهای سرویس‌دهنده تطبیق دهید.

مشکلات عملکردی و سرعت

کند بودن بارگذاری صفحه پرداخت

صفحه پرداخت به کندی بارگذاری می‌شود و مشتریان را آزار می‌دهد.

راه‌حل‌های بهینه‌سازی:

1. استفاده از کش – از افزونه‌های کش مانند WP Rocket یا W3 Total Cache استفاده کنید.
2. بهینه‌سازی تصاویر – تصاویر صفحه پرداخت را بهینه کنید.
3. کاهش تعداد درگاه‌های فعال – تعداد درگاه‌های پرداخت فعال را کاهش دهید تا زمان بارگذاری کمتر شود.
4. استفاده از CDN – از شبکه توزیع محتوا برای بارگذاری سریع‌تر فایل‌های استاتیک استفاده کنید.

مصرف بالای حافظه سرور

اگر سرور شما منابع محدودی دارد، افزونه ناپ کامرس ممکن است مصرف حافظه بالایی داشته باشد.

راه‌حل‌ها:

1. افزایش محدودیت حافظه PHP – در فایل wp-config.php خط زیر را اضافه کنید:

define('WP_MEMORY_LIMIT', '256M');

2. غیرفعال کردن گزارش‌گیری غیرضروری – لاگ‌های غیرضروری را غیرفعال کنید.
3. بررسی افزونه‌های تداخلی – برخی افزونه‌ها با ناپ کامرس تداخل دارند و مصرف حافظه را افزایش می‌دهند.

مشکلات امنیتی و احراز هویت

خطای احراز هویت در درگاه پرداخت

پیام "احراز هویت ناموفق" یا "کلید API نامعتبر" نمایش داده می‌شود.

راه‌حل‌ها:

1. بازنشانی کلیدهای API – از پنل درگاه پرداخت، کلیدهای جدید تولید کنید.
2. بررسی کدگذاری کلیدها – مطمئن شوید که کلیدها را با کپی/پیست صحیح وارد کرده‌اید و فاصله اضافی وجود ندارد.
3. بررسی IP سرور – IP سرور خود را با پشتیبانی درگاه چک کنید تا مطمئن شوید در لیست سفید قرار دارد.

حمله کرک یا تلاش‌های مکرر برای پرداخت

تعداد زیادی درخواست پرداخت ناموفق از یک IP خاص دریافت می‌شود.

راه‌حل‌های امنیتی:

1. محدودیت تعداد تلاش‌ها – از افزونه‌های امنیتی مانند Wordfence برای محدود کردن درخواست‌های مکرر استفاده کنید.
2. استفاده از کپچا – در صفحه پرداخت از کپچا استفاده کنید.
3. غیرفعال کردن IP متخلف – IPهای مشکوک را از طریق .htaccess مسدود کنید.

مشکلات مربوط به به‌روزرسانی و مهاجرت

خطا پس از به‌روزرسانی افزونه

پس از به‌روزرسانی افزونه ناپ کامرس، فروشگاه از کار می‌افتد یا خطاهای غیرمنتظره ظاهر می‌شوند.

مراحل عیب‌یابی:

1. پشتیبان‌گیری – قبل از هر اقدامی، از فایل‌ها و دیتابیس پشتیبان بگیرید.
2. غیرفعال کردن سایر افزونه‌ها – تمام افزونه‌ها را غیرفعال کرده و سپس ناپ کامرس را دوباره فعال کنید.
3. برگرداندن به نسخه قبلی – اگر مشکل برطرف نشد، افزونه را به نسخه قبلی برگردانید.
4. پاک کردن کش – کش مرورگر، کش وردپرس و کش سرور را پاک کنید.

مشکل پس از انتقال سایت به هاست جدید

پس از انتقال سایت به هاست دیگر، افزونه ناپ کامرس به درستی کار نمی‌کند.

راه‌حل‌ها:

1. بررسی تنظیمات پایگاه داده – اطلاعات اتصال به دیتابیس را در فایل wp-config.php بررسی کنید.
2. بررسی تنظیمات پیوند یکتا – پیوندهای یکتا را مجدداً ذخیره کنید.
3. بررسی مجوزهای فایل‌ها – مجوزهای پوشه‌ها و فایل‌ها را روی 755 و 644 تنظیم کنید.
4. پاک کردن کش – تمام کش‌ها را پاک کنید.

گزارش‌گیری و عیب‌یابی پیشرفته

فعال‌سازی حالت دیباگ (Debug)

برای مشاهده خطاهای دقیق، حالت دیباگ وردپرس را فعال کنید. در فایل wp-config.php خطوط زیر را اضافه کنید:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

پس از این کار، خطاها در فایل /wp-content/debug.log ذخیره می‌شوند.

بررسی لاگ‌های سرور

لاگ‌های خطای سرور (Error Logs) را بررسی کنید. این لاگ‌ها معمولاً در بخش مدیریت هاست یا در مسیر /var/log/ قابل دسترسی هستند.

استفاده از ابزارهای عیب‌یابی

از افزونه‌هایی مانند Query Monitor یا WP Console برای عیب‌یابی دقیق‌تر استفاده کنید.

جمع‌بندی و نکات پیشگیرانه

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

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

با دنبال کردن راهنماهای ارائه شده در این مقاله جامع، می‌توانید اکثر مشکلات رایج افزونه ناپ کامرس را به سرعت برطرف کرده و تجربه خریدی روان و بدون نقص برای مشتریان خود فراهم آورید. در صورت تداوم مشکل و نیاز به کمک تخصصی‌تر، همیشه می‌توانید از پشتیبانی رسمی افزونه، انجمن‌های وردپرس یا توسعه‌دهندگان حرفه‌ای کمک بگیرید.

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