پرش به مطلب اصلی

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

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

مای پاتریس از چه endpointهایی استفاده می‌کند؟​

کارendpoint
تست اتصالGET /wp-json/payava-patris/v1/mypatris/summary (همین صفحه)
اشخاص و مانده‌حسابPOST /wp-json/payava-patris/v1/mypatris/persons
صورت‌حساب هر شخصPOST /wp-json/payava-patris/v1/mypatris/statements
کالاها و قیمت‌هاPOST /wp-json/payava-patris/v1/products، مشترک با فروشگاه

مشتری حساب خود را چطور می‌بیند؟​

هر شخص با username شناخته می‌شود. وقتی مشتری وارد سایت شد، اشخاصی را نشان دهید که username آن‌ها با نام کاربری مشتری یا mobile آن‌ها با موبایل حساب مشتری برابر است. صورت‌حساب با code شخص پیدا می‌شود.

پیش‌نیازها​

Endpoint​

GET /wp-json/payava-patris/v1/mypatris/summary

هدرها​

نامنوعالزامیتوضیح
X-Payava-Keystringبلهکلید API حساب پاتریس.

پیاده‌سازی در وردپرس​

پاتریس یار هنگام «تست اتصال» در بخش مای پاتریس، اول GET /wp-json/payava-patris/v1/ping و بعد همین endpoint را صدا می‌زند. فقط موفق بودن پاسخ مهم است.

GET /mypatris/summary
function my_patris_mypatris_summary()
{
global $wpdb;
$persons = $wpdb->prefix . 'my_patris_persons';
$bills = $wpdb->prefix . 'my_patris_bills';
return [
'ok' => true,
'plugin' => 'my-patris-connector-1.0.0',
'persons' => (int) $wpdb->get_var("SELECT COUNT(*) FROM {$persons}"),
'statements' => (int) $wpdb->get_var("SELECT COUNT(DISTINCT person_code) FROM {$bills}"),
'lines' => (int) $wpdb->get_var("SELECT COUNT(*) FROM {$bills}"),
];
}

نمونه پاسخ موفق​

200 OK
{ "ok": true, "plugin": "custom-1.0.0", "persons": 120, "statements": 95, "lines": 4310 }
نامنوعالزامیتوضیح
okbooleanبلههمیشه true.
pluginstringخیرنسخه‌ی پیاده‌سازی شما.
personsintegerخیرتعداد اشخاص ذخیره‌شده.
statementsintegerخیرتعداد اشخاصی که صورت‌حساب دارند.
linesintegerخیرتعداد کل ردیف‌های صورت‌حساب.

کدهای خطا​

نامنوعالزامیتوضیح
401payava_patris_unauthorized—کلید نادرست است.
404——مسیر وجود ندارد. پاتریس یار مای پاتریس را روی این سایت فعال نمی‌کند.

نکته‌ها​

دو ماژول برای یک سایت

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

  • صفحه‌ی «حساب من در پاتریس» را فقط به کاربر واردشده نشان دهید. مانده و صورت‌حساب اطلاعات مالی مشتری است.
  • مبلغ‌ها به واحد پاتریس هستند. برای نمایش، بر همان ضریب قیمت تقسیم کنید.