مقاله ووکامرس

ووکامرس ۱۱.۳.۱ برای توسعه‌دهنده‌ها؛ قبل از آپدیت این نقاط را تست کنید

ووکامرس ۱۱.۳.۱ یک patch امنیتی مهم است، اما برای توسعه‌دهنده‌ها چند تغییر در Store API، templateها، REST permission و queryهای سفارشی دارد که باید قبل از آپدیت بررسی شوند.

حمید اعراب توسعه‌دهنده ارشد بک‌اند وردپرس و ووکامرس
انتشار
زمان مطالعه
۳ دقیقه مطالعه

حمید اعراب ۱ آذر ۱۴۰۵ ۳ دقیقه مطالعه

کاور ترمینالی WooCommerce 11.3.1 با چک‌لیست آپدیت
فهرست مطالب (8)

ووکامرس ۱۱.۳.۱ در ۱۹ نوامبر ۲۰۲۶ منتشر شد و تمرکز اصلی آن امنیت checkout، account، permissionها و handling داده است. برای فروشگاهی که افزونه اختصاصی، headless frontend یا queryهای analytics دارد، آپدیت فقط یک کلیک نیست؛ چند نقطه مشخص باید روی staging تست شوند.

۱. Headless و CORS: درخواست credentialed را دوباره تست کنید

در ۱۱.۳.۱، درخواست‌های Store API که از origin دیگری با credential ارسال می‌شوند باید از origin مجاز WordPress بیایند. اگر storefront جداگانه دارید و cookie لاگین را به Store API می‌فرستید، allowlist origin را بررسی کنید. درخواست‌های Cart Token بدون credentials از این تغییر مستثنا هستند.

۲. قالب جدید My Account ممکن است override شما را تحت تأثیر بگذارد

جریان تأیید ایمیل در My Account یک template جدید با نام myaccount/form-confirm-email.php دارد. اگر child theme یا theme شما پوشه WooCommerce را override می‌کند، template status و warningهای قدیمی بودن templateها را چک کنید.

۳. REST endpoint قدیمی permission سخت‌گیرانه‌تری دارد

endpoint قدیمی wc-admin options حالا capability manage_woocommerce می‌خواهد. integrationهایی که با role سفارشی فقط برای سفارش‌ها کار می‌کنند ممکن است 403 بگیرند. به‌جای بالا بردن بی‌دلیل permission، دقیقاً capability موردنیاز workflow را بازبینی کنید.

۴. رفتار on_sale با include/exclude در ۱۱.۳ تغییر کرده

از ۱۱.۳، ترکیب on_sale با include یا exclude نتیجه قابل‌پیش‌بینی‌تری می‌دهد: فیلترها واقعاً با هم اعمال می‌شوند. اگر frontend یا sync شما به رفتار عجیب قبلی تکیه کرده، test fixture بسازید و response را مقایسه کنید.

GET /wp-json/wc/store/v1/products?on_sale=true&include=10,13

۵. SQL سفارشی Analytics و payment_method

در ۱۱.۳ ستون payment_method به wc_order_stats اضافه شده است. اگر با فیلترهای woocommerce_analytics_clauses_* جدول wc_orders را join می‌کنید و نام ستون را بدون table prefix نوشته‌اید، MySQL می‌تواند خطای ambiguous column بدهد. این مورد روی گزارش Orders خودش را به شکل جدول خالی نشان می‌دهد.

۶. Database update را بخشی از deployment بدانید

نسخه ۱۱.۳ و ۱۱.۳.۱ database update دارند. روی فروشگاه بزرگ، migration و index build را در maintenance plan حساب کنید، backup بگیرید و بعد از update queue/background actionها را مانیتور کنید.

چک‌لیست کوتاه من

  1. Backup دیتابیس و فایل‌ها.
  2. Clone یا staging با همان PHP/MySQL production.
  3. تست classic و block checkout.
  4. تست Store API و headless originها.
  5. بررسی template overrides.
  6. بررسی queryهای product و analytics SQL.
  7. بعد از آپدیت، error log و Action Scheduler را کنترل کنید.

منابع

$ ./request_review

همین مشکل را در فروشگاه خودتان دارید؟

توسعه‌دهنده ارشد WordPress و WooCommerce برای معماری، اتصال سیستم‌ها و حل مسائل پیچیده production.

درخواست بررسی فنی

دیدگاه‌ها

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *