تنظیم افزونه ناپ کامرس | راهنمای جامع پیکربندی و شخصی‌سازی

پیش‌نیازهای تنظیم افزونه در ناپ کامرس

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

دسترسی مدیر (ادمین) با مجوز کافی

برای دسترسی به بخش تنظیمات افزونه‌ها، باید به عنوان مدیر (ادمین) وارد پنل مدیریت فروشگاه خود شده باشید. همچنین ممکن است نیاز به مجوزهای خاصی مانند Manage plugins داشته باشید تا بتوانید تنظیمات را تغییر دهید [citation:12].

نصب و فعال‌سازی افزونه

به طور واضح، افزونه مورد نظر باید قبلاً نصب و فعال (Enabled) شده باشد. اگر افزونه به تازگی نصب شده، ممکن است نیاز به راه‌اندازی مجدد برنامه (Restart application) داشته باشد تا در لیست افزونه‌ها نمایش داده شود [citation:4].

بررسی وابستگی‌ها (Dependencies)

برخی افزونه‌ها برای کارکرد صحیح به افزونه‌های دیگری وابسته هستند. برای مثال، افزونه Smart Payment Rules Manager به افزونه NopAdvance Core وابسته است و بدون آن کار نمی‌کند [citation:2]. بنابراین، پیش از تنظیم افزونه اصلی، از نصب و فعال‌سازی افزونه‌های وابسته اطمینان حاصل کنید.

دسترسی به صفحه تنظیمات افزونه (Configuration Page)

پس از اطمینان از پیش‌نیازها، نوبت به ورود به صفحه تنظیم افزونه ناپ کامرس می‌رسد. دو راه اصلی برای دسترسی به این صفحه وجود دارد:

روش اول: از طریق لیست افزونه‌های محلی (Local plugins)

این رایج‌ترین روش است. مراحل زیر را دنبال کنید:

• به پنل مدیریت فروشگاه خود بروید.
• از منوی اصلی به مسیر Configuration > Local plugins بروید [citation:4][citation:10].
• در لیست افزونه‌ها، افزونه مورد نظر خود را پیدا کنید.
• روی دکمه Configure (پیکربندی) در کنار نام افزونه کلیک کنید [citation:4][citation:10].

نکته: اگر دکمه Configure در کنار افزونه وجود ندارد، به این معنی است که آن افزونه نیازی به تنظیمات خاصی ندارد و به صورت پیش‌فرض کار می‌کند [citation:4].

روش دوم: از طریق منوی اختصاصی افزونه

برخی افزونه‌ها پس از نصب، یک آیتم منوی جدید به پنل مدیریت اضافه می‌کنند. برای مثال، افزونه Smart Payment Rules Manager یک منوی اختصاصی در مسیر NopAdvance > Plugins > Smart Payment Rules Manager ایجاد می‌کند [citation:2]. در این حالت، می‌توانید مستقیماً از آن منو وارد صفحه تنظیمات شوید.

مراحل پیکربندی (تنظیم) افزونه

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

تنظیمات عمومی (Global Settings)

بسیاری از افزونه‌ها دارای یک سری تنظیمات کلی هستند که رفتار اصلی افزونه را کنترل می‌کنند. برای مثال، در افزونه Smart Payment Rules Manager، تنظیمات زیر وجود دارد [citation:2]:

• فعال (Enable): با فعال کردن این گزینه، افزونه در کل فروشگاه فعال می‌شود و قوانین تعیین شده در هنگام تسویه‌حساب (Checkout) اعمال می‌شوند.
• ثبت وقایع در صورت عدم نمایش روش پرداخت (Log on no payment methods): این گزینه باعث می‌شود که در صورت عدم نمایش هیچ روش پرداختی به مشتری به دلیل اعمال قوانین، یک خطا در لاگ ثبت شود.

پس از تغییر هر یک از این تنظیمات، حتماً روی دکمه ذخیره (Save) کلیک کنید تا تغییرات اعمال شوند [citation:2].

ایجاد و مدیریت قوانین (Rules)

بسیاری از افزونه‌های پیشرفته مانند افزونه‌های پرداخت، ارسال یا بازاریابی، امکان تعریف قوانین (Rules) را برای کنترل دقیق‌تر رفتار خود فراهم می‌کنند. در افزونه Smart Payment Rules Manager، بخش Payment Rules به شما امکان می‌دهد قوانینی برای نمایش یا مخفی کردن روش‌های پرداخت بر اساس شرایط مختلف تعریف کنید [citation:2].

فیلترهای جستجو (Search Filters)

در بخش مدیریت قوانین، معمولاً فیلترهایی برای جستجوی قوانین وجود دارد که شامل موارد زیر است [citation:2]:

• تاریخ شروع و پایان (Start Date / End Date): برای فیلتر قوانین بر اساس بازه زمانی فعال بودن.
• نوع قانون (Rule Type): شامل Allow (مجاز) یا Restrict (محدود) که مشخص می‌کند قانون باعث نمایش یا مخفی شدن روش پرداخت می‌شود.
• روش پرداخت (Payment Method): برای فیلتر قوانین اعمال شده بر روی یک روش پرداخت خاص.
• نوع دستگاه (Device Type): برای فیلتر بر اساس دستگاه کاربر (دسکتاپ، موبایل، همه).
• نام قانون (Rule Name): برای جستجوی قانون بر اساس نام.
• وضعیت فعال بودن (Is Active): برای فیلتر قوانین فعال یا غیرفعال.

افزودن قانون جدید (Add New Rule)

برای ایجاد یک قانون جدید، روی دکمه Add new کلیک کنید. سپس باید اطلاعات زیر را وارد کنید [citation:2]:

• نام قانون (Name): یک نام شناسایی برای قانون (اجباری).
• فعال (Active): برای فعال کردن قانون بلافاصله پس از ذخیره.
• نوع قانون (Rule Type): انتخاب بین Allow (اجازه نمایش) یا Restrict (ممنوعیت نمایش).
• دستگاه (Device Type): انتخاب نوع دستگاهی که قانون برای آن اعمال می‌شود.
• روش پرداخت (Payment Method): انتخاب روش پرداختی که قانون روی آن اعمال می‌شود (اجباری).
• محدود به فروشگاه‌ها (Limited to Stores): در صورت وجود چندین فروشگاه، می‌توان قانون را به فروشگاه‌های خاص محدود کرد.
• بازه زمانی (Date Range): تعیین تاریخ شروع و پایان اعتبار قانون.
• اولویت (Priority): تعیین اولویت قانون. قوانین با عدد اولویت کمتر، زودتر ارزیابی می‌شوند.

تعریف شرایط (Requirements)

پس از ذخیره اطلاعات اولیه قانون، بخش جدیدی به نام Requirements فعال می‌شود. در این بخش می‌توانید شرایط دقیق‌تری تعیین کنید که برای اعمال قانون باید برقرار باشند [citation:2]:

• جمع کل سبد خرید (Order subtotal): اعمال قانون فقط در صورتی که جمع مبلغ سبد خرید (قبل از تخفیف، مالیات و ارسال) در یک بازه مشخص باشد.
• جمع کل نهایی سفارش (Order total): اعمال قانون بر اساس مبلغ نهایی سفارش (شامل مالیات، تخفیف و ارسال).
• نقش مشتری (Customer role): اعمال قانون فقط برای مشتریانی با نقش‌های خاص (مانند ثبت‌نام شده، مهمان، فروشنده).
• کشور صورت‌حساب (Billing country): اعمال قانون بر اساس کشور صورت‌حساب مشتری.
• کشور ارسال (Shipping country): اعمال قانون بر اساس کشور آدرس ارسال.
• ارز مشتری (Customer currency): اعمال قانون بر اساس ارز انتخاب شده توسط مشتری.
• نوع محصول (Product type): اعمال قانون در صورتی که سبد خرید شامل محصولات خاصی باشد.

تنظیمات پیشرفته و شخصی‌سازی

برخی افزونه‌ها دارای تنظیمات پیشرفته‌تری هستند که نیاز به ورود اطلاعات خاصی دارند. برای مثال، افزونه پرداخت Payrexx نیاز به تنظیمات زیر دارد [citation:10]:

• نام نمونه (Instance name): نام نمونه حساب کاربری Payrexx شما.
• کلید API مخفی (API secret key): کلید API که از حساب کاربری Payrexx خود دریافت می‌کنید.

پس از وارد کردن این اطلاعات، روی دکمه ذخیره (Save) کلیک کنید تا پیکربندی تکمیل شود [citation:10].

ویرایش تنظیمات و مدیریت افزونه

علاوه بر صفحه Configure، می‌توانید تنظیمات کلی‌تری را برای هر افزونه از طریق دکمه Edit در لیست افزونه‌ها تغییر دهید [citation:4]:

• نام نمایشی (Friendly name): تغییر نامی که در لیست افزونه‌ها نمایش داده می‌شود.
• ترتیب نمایش (Display order): تعیین اولویت نمایش افزونه در لیست.
• فعال بودن (Is enabled): فعال یا غیرفعال کردن افزونه.
• محدود به نقش‌های مشتری (Limited to customer roles): انتخاب نقش‌هایی که می‌توانند از این افزونه استفاده کنند.
• محدود به فروشگاه‌ها (Limited to stores): انتخاب فروشگاه‌هایی که افزونه در آنها فعال باشد.

عیب‌یابی مشکلات رایج در تنظیم افزونه

در فرآیند تنظیم افزونه ناپ کامرس ممکن است با مشکلاتی مواجه شوید. در ادامه به رایج‌ترین آنها و راه‌حل‌هایشان می‌پردازیم.

دکمه Configure در دسترس نیست

دلیل: ممکن است افزونه نیازی به تنظیمات نداشته باشد یا به درستی نصب نشده باشد [citation:4]. همچنین ممکن است افزونه به دلیل عدم تطابق نسخه یا وابستگی‌ها، به درستی بارگذاری نشده باشد.

راه‌حل: از نصب صحیح افزونه و فعال بودن آن اطمینان حاصل کنید. اگر افزونه اخیراً نصب شده، روی دکمه Reload list of plugins کلیک کنید و یا برنامه را مجدداً راه‌اندازی (Restart) کنید [citation:4][citation:11].

تنظیمات ذخیره نمی‌شوند یا خطا می‌دهند

دلیل: ممکن است اطلاعات وارد شده (مانند کلید API) نادرست باشد یا افزونه با مشکلاتی در پایگاه داده مواجه شده باشد.

راه‌حل: اطلاعات وارد شده را دقیقاً مطابق با مستندات افزونه بررسی کنید. همچنین لاگ‌های سیستم را در بخش System > Log بررسی کنید تا خطای خاصی ثبت شده باشد.

افزونه پس از تنظیمات کار نمی‌کند

دلیل: ممکن است افزونه به یک افزونه وابسته (Core) نیاز داشته باشد که نصب یا فعال نیست [citation:2]. همچنین ممکن است تداخلی با سایر افزونه‌ها وجود داشته باشد.

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

تغییرات در تنظیمات اعمال نمی‌شود

دلیل: گاهی کش مرورگر یا کش سیستم باعث می‌شود تغییرات به درستی نمایش داده نشوند [citation:6].

راه‌حل: کش مرورگر خود را پاک کنید. همچنین ممکن است نیاز به غیرفعال و سپس فعال‌سازی مجدد افزونه داشته باشید. در برخی موارد، حذف و نصب مجدد افزونه می‌تواند مشکل را برطرف کند [citation:6].

نکات کلیدی برای تنظیم اصولی افزونه‌ها

• مستندات افزونه را مطالعه کنید: هر افزونه تنظیمات خاص خود را دارد. قبل از هر اقدامی، مستندات آن را به دقت مطالعه کنید.
• از آخرین نسخه افزونه استفاده کنید: نسخه افزونه باید با نسخه ناپ کامرس شما سازگار باشد [citation:1][citation:10].
• تنظیمات را گام‌به‌گام تغییر دهید: تغییرات را یک‌باره اعمال نکنید. هر تنظیم را به صورت جداگانه تست کنید تا در صورت بروز مشکل، علت آن را به راحتی پیدا کنید.
• از محیط تست استفاده کنید: اگر امکان دارد، تنظیمات را ابتدا در یک محیط تست (Staging) انجام دهید تا از بروز مشکل در فروشگاه زنده جلوگیری شود.
• پشتیبان‌گیری کنید: پیش از هر تغییر مهم، از فایل‌ها و پایگاه داده فروشگاه خود پشتیبان تهیه کنید.

جمع‌بندی

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

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

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