اتصال در پاتریس یار و رفع مشکل
پس از نصب و تنظیم افزونه، سایت را در پاتریس یار به عنوان اتصال «WordPress (افزونهی پاتریس یار)» ثبت میکنید. این صفحه مراحل ثبت و رفع خطاهای رایج را میگوید.
سایت را چطور در پاتریس یار ثبت کنم؟
- در پاتریس یار به بخش «فروشگاه اینترنتی» (یا «مای پاتریس») بروید و «+ افزودن اتصال» را بزنید.
- در «نوع اتصال» گزینهی «WordPress (افزونهی پاتریس یار)» را انتخاب کنید.
- در «آدرس سایت» آدرس اصلی سایت را وارد کنید، مثلاً
https://shop.example.com. - در «کلید اتصال» همان کلید
ppk_را وارد کنید که در افزونه ذخیره کردهاید. - روش سفارش را مطابق تنظیم افزونه انتخاب کنید: «دریافت مستقیم از همین اتصال» یا «دریافت از طریق سرور پاتریس». اگر فقط قیمت و موجودی لازم است، «از این اتصال سفارش دریافت نشود».
- «بهروزرسانی قیمت و موجودی کالاها در این اتصال» را در صورت نیاز روشن کنید.
- «تست اتصال» را بزنید.
خطاهای رایج
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| مسیر اتصال روی سایت پیدا نشد (404) | خطای تست | — | افزونه فعال نیست، یا «پیوندهای یکتا» روی «ساده» است. پیوند یکتا را روی گزینهای غیر از «ساده» بگذارید. |
| کلید API پذیرفته نشد | خطای تست | — | کلید پاتریس یار با کلید ذخیرهشده در افزونه یکی نیست. هر دو را دوباره کپی کنید. |
| خطای ۴۰۱ یا ۴۰۳ با وجود کلید درست | خطای تست | — | یک افزونهی امنیتی یا فایروال، REST API را برای درخواستهای بدون ورود مسدود کرده است. مسیر /wp-json/payava-patris/ را در آن مجاز کنید. |
| سایت فعلاً درخواست بیشتری نمیپذیرد (429) | خطای همگامسازی | — | فایروال یا CDN درخواستها را محدود کرده است. پاتریس یار دور بعد دوباره تلاش میکند. |
| هشدار یکی نبودن روش سفارش | پیام تست | — | روش افزونه و پاتریس یار را یکی کنید. |
افزونهی امنیتی REST API را مسدود کرده است؛ چه کنم؟
بهتر است مسیر را در تنظیمات همان افزونهی امنیتی مجاز کنید. اگر REST API را با کد خودتان محدود کردهاید، مسیرهای پاتریس یار را استثنا کنید. افزونه خودش کلید هر درخواست را بررسی میکند:
functions.php: استثنا کردن مسیرهای پاتریس یار
add_filter('rest_authentication_errors', function ($result) {
$route = isset($GLOBALS['wp']->query_vars['rest_route']) ? (string) $GLOBALS['wp']->query_vars['rest_route'] : '';
if (strpos($route, '/payava-patris/v1/') === 0) {
return $result; // checked by the plugin with X-Payava-Key
}
if (!is_user_logged_in()) {
return new WP_Error('rest_forbidden', 'REST API is limited to logged-in users.', ['status' => 401]);
}
return $result;
});
نکتهها
- درخواستها از IP اینترنت رایانهی فروشگاه میآیند، نه از سرور پایاوا. محدودیت IP روی REST API نگذارید، مگر رایانهی فروشگاه IP ثابت داشته باشد.
- چالشهای JavaScript فایروالها و CDNها (مثلاً صفحهی «در حال بررسی مرورگر») درخواستهای پاتریس یار را رد میکنند. مسیر
/wp-json/payava-patris/را از آنها مستثنا کنید.