۱پیشنیازهای نصب
- وردپرس ۵.۸ یا جدیدتر
- ووکامرس ۷.۱ یا جدیدتر
- PHP نسخه ۷.۴ یا جدیدتر
- فعال بودن افزونه PHP به نام
mbstring - دسترسی خروجی HTTPS به
omapi.tipax.ir - نام کاربری، رمز عبور و API Key حساب تیپاکس
۲نصب افزونه
نصب با فایل ZIP
- در مدیریت وردپرس وارد مسیر «افزونهها ← افزودن افزونه تازه» شوید.
- روی «بارگذاری افزونه» بزنید و فایل ZIP افزونه را انتخاب کنید.
- «هماکنون نصب نمایید» و سپس «فعالکردن افزونه» را بزنید.
- پس از فعالسازی، منوی «حمل با تیپاکس» باید در مدیریت وردپرس دیده شود.
نصب با FTP
پوشه استخراجشده افزونه را در مسیر زیر بارگذاری و سپس از بخش افزونههای وردپرس فعال کنید:
/wp-content/plugins/delivery-services-tipax-shipping/
۳مسیر سریع راهاندازی
برای راهاندازی صحیح، ترتیب زیر را تغییر ندهید:
۴اتصال حساب تیپاکس
- گزینه فعالبودن روش حمل تیپاکس را روشن کنید.
- نام کاربری حساب تیپاکس را دقیقاً وارد کنید.
- رمز عبور حساب تیپاکس را وارد کنید.
- API Key را بدون فاصله اضافی در ابتدا یا انتها وارد کنید.
- روی «ذخیره تنظیمات» بزنید.
۵بررسی اتصال و محیط
پس از ذخیره اطلاعات اتصال، «شروع بررسی» را اجرا کنید. موارد زیر باید موفق باشند:
- فعال بودن روش حمل تیپاکس
- ارتباط با پورت ۴۴۳ سرور تیپاکس
- برقراری TLS/SSL
- نسخه مناسب وردپرس، ووکامرس و PHP
- فعال بودن cURL
- اعتبارسنجی API Key
- دریافت آدرسهای حساب تیپاکس
۶ثبت و انتخاب آدرس فرستنده
- روی «بروزرسانی لیست آدرسها» بزنید تا آدرسهای حساب تیپاکس دریافت شوند.
- اگر آدرسی ندارید، «افزودن آدرس جدید» را انتخاب و فرم را کامل کنید.
- در جدول آدرسها، آدرس مناسب فروشگاه را «بهعنوان مبدا سایت» انتخاب کنید.
- کنار آدرس انتخابی باید عبارت «مبدای فعلی سایت» نمایش داده شود.
این مبدا برای استعلام نرخ، تشخیص مسیر درونشهری یا بینشهری و ثبت سفارش در تیپاکس استفاده میشود.
۷افزودن تیپاکس به ناحیه حملونقل
- ناحیهای را که مشتریان آن باید تیپاکس را ببینند باز کنید؛ برای مثال «ایران» یا استانهای موردنظر.
- روی «افزودن روش حملونقل» بزنید.
- روش «تیپاکس» را انتخاب و اضافه کنید.
- مطمئن شوید سوییچ روش تیپاکس در همان ناحیه فعال است.
- این کار را برای هر Zone دیگری که باید تیپاکس داشته باشد تکرار کنید.
افزودن تیپاکس به یک Zone، سایر روشهای حمل همان Zone را حذف یا غیرفعال نمیکند. ووکامرس میتواند چند روش حمل را همزمان مدیریت کند.
۸تنظیم شهرهای تیپاکس
فهرست شهرهای تیپاکس مستقیماً در Checkout کلاسیک، Elementor و Checkout Block نمایش داده میشود.
فیلد شهر قالب یا افزونه حمل دیگر باقی میماند و افزونه هنگام استعلام، شهر را به شناسه تیپاکس تبدیل میکند.
مدیریت شهرها
- با «بروزرسانی شهرها» آخرین فهرست را از تیپاکس دریافت کنید.
- با فیلتر استان و جستوجوی شهر، موارد موردنظر را سریعتر پیدا کنید.
- اگر ارسال تیپاکس به شهری را نمیخواهید، همان شهر را غیرفعال کنید.
- شهر غیرفعال همچنان میتواند در Checkout دیده شود، اما روش حمل تیپاکس برای آن ارائه نمیشود.
۹تنظیمات اصلی افزونه
اطلاعات فرستنده و لیبل
- نام کامل و تلفن فرستنده را وارد کنید.
- در صورت نیاز لوگوی فروشگاه را برای چاپ لیبل انتخاب کنید.
- طرح لیبل را از میان «تمام اطلاعات»، «بدون فرستنده»، «فقط بارکد» یا «بدون شماره فرستنده» انتخاب کنید.
مدل پرداخت کرایه
| مدل | رفتار | نکته مهم |
|---|---|---|
| پسکرایه | کرایه توسط تیپاکس از گیرنده دریافت میشود. | مبلغ نمایشدادهشده صرفاً اطلاعرسانی است و به پرداخت آنلاین اضافه نمیشود. |
| پرداخت فرستنده | کل کرایه تیپاکس با روش اعتباری، کیف پول یا نقدی از فرستنده تسویه میشود. | مبلغی که از مشتری میگیرید میتواند رایگان، ثابت یا برابر نرخ تیپاکس باشد. |
| COD تیپاکس | مبلغ سفارش برای دریافت در محل به تیپاکس ارسال میشود. | در Checkout تیپاکس، درگاه COD اختصاصی افزونه استفاده میشود. |
بستهبندی و ابعاد
- در حالت «پیشفرض»، وزن متوسط و ابعاد طول، عرض و ارتفاع را بر حسب کیلوگرم و سانتیمتر وارد کنید.
- برای بسته پیشفرض کمتر از ۲ کیلوگرم بسته ۵۰۷، از ۲ تا ۳۰ کیلوگرم بسته ۵۰۴ و بیشتر از ۳۰ تا ۸۰ کیلوگرم بسته ۵۲۱ استفاده میشود.
- اگر بستهبندی مشخصی انتخاب کنید، ابعاد همان بسته از فهرست تیپاکس استفاده میشود.
- سفارشهای سنگین در صورت نیاز به چند بسته تقسیم میشوند.
نوع جمعآوری
یکی از گزینههای «جمعآوری در محل مشتری» یا «جمعآوری در نمایندگی» را مطابق قرارداد خود انتخاب کنید.
ثبت آنلاین یا آفلاین در Checkout
Checkout هیچ سفارشی به تیپاکس ارسال نمیکند. سفارش باید بعداً از منوی سفارشات با «ثبت در تیپاکس» ثبت شود.
ثبت بهصورت آنلاین انجام میشود؛ اگر پاسخ تیپاکس از Timeout عبور کند، سفارش برای ثبت دستی ذخیره میشود.
ثبت لاگ
فقط هنگام عیبیابی «ثبت لاگ» را روشن کنید. وقتی خاموش باشد، منوی لاگ نمایش داده نمیشود و فایل لاگ نباید با رویدادهای جدید بزرگتر شود.
۱۰آزمایش نهایی Checkout
پس از ذخیره تنظیمات، یک محصول واقعی را با وزن، قیمت و موجودی معتبر به سبد اضافه کنید و Checkout را در پنجره ناشناس مرورگر آزمایش کنید.
کشور، استان، شهر، کدپستی، آدرس و موبایل را کامل کنید.
با انتخاب استان، فهرست شهر باید در همان بار اول لود شود.
روش تیپاکس باید برای Zone و شهر فعال نمایش داده شود.
مبلغ نمایشدادهشده را با مدل پرداخت انتخابی مقایسه کنید.
در حالت COD، درگاه اختصاصی تیپاکس باید قابل انتخاب باشد.
یک سفارش کامل ثبت و نتیجه را در منوی سفارشات افزونه بررسی کنید.
۱۱مدیریت روزمره سفارشها
- فقط سفارشهای دارای روش ارسال تیپاکس در نمای اصلی دیده میشوند.
- برای سفارش آفلاین یا ناموفق از «ثبت در تیپاکس» یا «ثبت مجدد در تیپاکس» استفاده کنید.
- پیش از ثبت مجدد میتوانید مبدا، وزن، بستهبندی و ابعاد را بازبینی کنید.
- وضعیت سفارشهای قابل رهگیری را تکی یا گروهی بروزرسانی کنید.
- لیبل را تکی یا با انتخاب چند سفارش چاپ کنید.
- مرسوله ثبتشده و قابل ابطال را از همان صفحه ابطال کنید.
- با فیلتر تاریخ، سفارشهای قدیمیتر از بازه پیشفرض را مشاهده کنید.
وضعیت مرسولههای قابل بروزرسانی هر ۲۴ ساعت نیز بهصورت خودکار بررسی میشود.
۱۲رهگیری برای مشتریان
شورتکد رهگیری
یک برگه جدید بسازید و شورتکد زیر را در بلوک Shortcode قرار دهید:
[tipax_tracking]
کاربر میتواند کد رهگیری حروفی یا شماره قرارداد عددی تیپاکس را وارد کند. افزونه نوع کد را تشخیص میدهد و سرویس مناسب را فراخوانی میکند.
حساب کاربری ووکامرس
در «حساب کاربری من» بخش «رهگیری مرسولات در تیپاکس» برای مشتری نمایش داده میشود.
۱۳رفع اشکال سریع
| نشانه | مواردی که باید بررسی شوند |
|---|---|
| تیپاکس در Checkout نیست | روش تیپاکس به Zone اضافه و فعال باشد؛ آدرس مشتری داخل همان Zone باشد؛ شهر غیرفعال نشده باشد؛ اتصال و مبدا معتبر باشند. |
| فیلد شهر متنی است | در تنظیمات افزونه گزینه «فقط شهرهای پشتیبانیشده تیپاکس» را روشن کنید؛ کش صفحه و افزونههای بهینهساز را پاک کنید. |
| شهرها لود نمیشوند | Network مرورگر، nonce، پاسخ AJAX، کش JavaScript و بروز بودن افزونه را بررسی کنید؛ سپس شهرها را از منوی شهرها بروزرسانی کنید. |
| سرویس برای شهر موجود نیست | کش شهرها را بروزرسانی و نام استان/شهر را کنترل کنید. در سایتهای دارای افزونه حمل دیگر، نگاشت شهر باید به شناسه تیپاکس برسد. |
| آدرسهای تیپاکس دریافت نمیشوند | API Key، نام کاربری، رمز عبور، HTTPS خروجی و وجود آدرس در حساب تیپاکس را بررسی کنید. |
| سفارش در تیپاکس ثبت نشده | حالت آفلاین و Timeout را بررسی و سفارش را از منوی سفارشات بهصورت دستی ثبت کنید. |
| خطای بستهبندی | وزن و ابعاد محصول، بسته انتخابی و محدودیتهای حداقل/حداکثر آن بسته را بررسی کنید. |
| درگاه COD دیده نمیشود | COD را در تنظیمات افزونه فعال کنید، روش حمل انتخابشده تیپاکس باشد و کش Checkout را پاک کنید. |
۱۴چکلیست تحویل نهایی
- افزونه نصب و فعال است.
- اطلاعات اتصال ذخیره شده است.
- بررسی اتصال بدون خطای اصلی انجام شده است.
- یک آدرس بهعنوان مبدا سایت انتخاب شده است.
- تیپاکس به Zoneهای موردنظر اضافه شده است.
- شهرهای تیپاکس بروزرسانی شدهاند.
- مدل تسویه و COD مشخص شدهاند.
- وزن، ابعاد و بستهبندی تنظیم شدهاند.
- سفارش آزمایشی در موبایل و دسکتاپ ثبت شده است.
- کد رهگیری و چاپ لیبل بررسی شدهاند.