برنامه‌نویس وردپرس برای اتصال API الوپیک

### عنوان پروژه **استخدام برنامه‌نویس وردپرس/WooCommerce برای اتصال API الوپیک به مارکت‌پلیس MrPets.ir** برای توسعه و تکمیل قابلیت ارسال سفارش‌ها در مارکت‌پلیس چندفروشندگی، به یک برنامه‌نویس دورکار مسلط به وردپرس، ووکامرس، دکان (Dokan) و PHP نیاز داریم. هدف پروژه، اتصال کامل و پایدار سرویس الوپیک به فرایند ثبت، محاسبه هزینه و ارسال سفارش‌ها در مارکت‌پلیس است؛ به‌صورتی که هر فروشنده بتواند سفارش‌های مربوط به خود را از طریق الوپیک مدیریت کند. --- ## شرح پروژه وب‌سایت MrPets.ir یک مارکت‌پلیس چندفروشندگی مبتنی بر **WordPress + WooCommerce + Dokan** است. در این پروژه باید افزونه/ماژولی توسعه یا سفارشی‌سازی شود که امکانات زیر را فراهم کند: 1. **ثبت و مدیریت موقعیت مکانی فروشندگان** - دریافت و ذخیره آدرس و مختصات جغرافیایی (Latitude / Longitude) هر فروشنده؛ - امکان انتخاب موقعیت فروشگاه از طریق نقشه در پنل فروشنده دکان؛ - اعتبارسنجی اطلاعات آدرس و مختصات. 2. **دریافت و مدیریت آدرس مشتری در تسویه‌حساب** - نمایش/انتخاب آدرس‌های ثبت‌شده مشتری؛ - امکان ثبت آدرس جدید و تعیین موقعیت دقیق روی نقشه؛ - ذخیره مختصات مکانی آدرس برای استفاده در محاسبه کرایه و ثبت سفر. 3. **محاسبه هزینه ارسال الوپیک در Checkout** - دریافت استعلام هزینه ارسال از API الوپیک بر مبنای مبدا فروشنده و مقصد مشتری؛ - نمایش شفاف روش ارسال و مبلغ آن در صفحه تسویه‌حساب؛ - اعمال هزینه حمل به سفارش؛ - مدیریت سناریوی سفارش چندفروشنده‌ای، به‌گونه‌ای که هزینه ارسال هر فروشنده/بسته به‌درستی محاسبه و نمایش داده شود. 4. **ایجاد سفر پس از پرداخت موفق** - پس از پرداخت موفق سفارش، سفر/درخواست پیک به‌صورت خودکار از طریق API الوپیک ثبت شود؛ - ثبت شناسه سفر، وضعیت، مبلغ و سایر اطلاعات ضروری در متای سفارش؛ - جلوگیری از ثبت تکراری سفر در صورت تکرار Callback پرداخت یا خطاهای موقت. 5. **مدیریت و پیگیری سفر** - مشاهده اطلاعات سفر الوپیک در پنل مدیریت سفارش؛ - قابلیت دریافت و به‌روزرسانی وضعیت سفر؛ - در صورت امکان، نمایش اطلاعات پیک و وضعیت ارسال برای مشتری و فروشنده؛ - قابلیت لغو سفر مطابق محدودیت‌ها و پاسخ API الوپیک. --- ## نیازمندی‌های فنی متقاضی باید در موارد زیر تجربه عملی و قابل ارائه داشته باشد: - تسلط به **PHP** و استانداردهای توسعه افزونه وردپرس؛ - تسلط به **WordPress، WooCommerce و Hookهای آن**؛ - تجربه کار با **Dokan Multivendor** و ساخت/توسعه امکانات در داشبورد فروشنده؛ - تسلط به طراحی و مصرف **REST API**، مدیریت توکن، Headerها، درخواست‌های HTTP و مدیریت خطا؛ - تجربه اتصال درگاه‌های حمل‌ونقل، پیک یا سرویس‌های لجستیکی مزیت محسوب می‌شود؛ - آشنایی با **AJAX، JavaScript، jQuery** و کار با نقشه/مختصات جغرافیایی؛ - توانایی طراحی ساختار مناسب برای ذخیره اطلاعات سفارش، فروشنده، آدرس و سفر با استفاده از WooCommerce Order Meta و User Meta؛ - رعایت اصول امنیتی شامل: - استفاده از Nonce و بررسی سطح دسترسی؛ - محافظت از کلیدها و توکن‌های API؛ - اعتبارسنجی و پاک‌سازی ورودی‌ها؛ - جلوگیری از ثبت تکراری درخواست سفر؛ - توسعه کد تمیز، قابل نگهداری، مستندسازی‌شده و سازگار با نسخه‌های جدید وردپرس و ووکامرس. --- ## خروجی‌های مورد انتظار - افزونه اختصاصی یا توسعه اصولی افزونه موجود، بدون وابستگی غیرضروری به تغییرات مستقیم در هسته قالب/افزونه‌ها؛ - تنظیمات مدیریتی برای واردکردن کلید/API Key الوپیک و پارامترهای موردنیاز؛ - قابلیت ثبت مختصات فروشندگان و مشتریان؛ - محاسبه آنلاین هزینه ارسال در Checkout؛ - ثبت خودکار سفر پس از پرداخت موفق؛ - پنل/بخش مدیریتی برای مشاهده اطلاعات و وضعیت سفر؛ - ثبت Log مناسب برای خطاهای API و امکان عیب‌یابی؛ - مستند نصب، تنظیمات و راهنمای استفاده؛ - تحویل کامل سورس‌کد از طریق Git یا فایل افزونه قابل نصب؛ - تست روی محیط آزمایشی قبل از استقرار روی سایت اصلی. --- ## نکات مهم همکاری - پروژه به‌صورت **دورکاری و مرحله‌ای** انجام می‌شود. - اولویت با فردی است که نمونه‌کار واقعی در WooCommerce، Dokan یا اتصال APIهای حمل‌ونقل داشته باشد. - لازم است پیش از شروع، ساختار سفارش‌های چندفروشنده‌ای Dokan و سناریوهای ارسال بررسی و راهکار پیشنهادی ارائه شود. - پرداخت می‌تواند بر اساس فازهای مشخص پروژه انجام شود: 1. تحلیل و طراحی فنی 2. ثبت موقعیت فروشنده و مشتری 3. استعلام و محاسبه هزینه ارسال 4. ایجاد و مدیریت سفر پس از پرداخت 5. تست، رفع اشکال و مستندسازی لطفاً هنگام ارسال پیشنهاد، نمونه‌کار مرتبط، برآورد زمان، مبلغ پیشنهادی و توضیح مختصر درباره تجربه خود در WooCommerce/Dokan/API را ارسال کنید.