كتلة Subscription upgrade هي كتلة فرعية تتداخل داخل Cart items. وهي تحث المتسوقين على تحويل عنصر سطر مؤهل ذي شراء لمرة واحدة إلى اشتراك مباشرة من السلة، محوّلة الشراء لمرة واحدة إلى إيرادات متكررة عند نقطة القرار، وتتيح للمتسوقين المشتركين بالفعل تغيير خطتهم أو إلغاءها على ذلك السطر.
السلوك
- تظهر على الأسطر المؤهلة فقط. تقرأ الكتلة خطط بيع المنتج ولا تعرض شيئًا على سطر ليس لمنتجه خطط اشتراك.
- لا تُعرض أبدًا على هدايا المكافآت. الاشتراك في هدية مجانية ممنوحة تلقائيًا سيجرّدها من حالة المكافأة، لذا يُكبح الحث على تلك الأسطر.
- على سطر شراء لمرة واحدة، تعرض دعوة الترقية.
- على سطر مشترك بالفعل، تعرض محدد خطط بالإضافة إلى خيار “الرجوع إلى الشراء لمرة واحدة”.
الإعدادات
الموضع والحدود
- الأصل: تتداخل داخل Cart items فقط.
- الحد الأقصى: 1 لكل سلة.
- لا تُضاف افتراضيًا. غير مقفلة، لذا يمكنك إزالتها أو إخفاؤها.
القالب المخصص
view.state أيهما. لا يكون view أبدًا null داخل قالب مخصص: عندما لا يكون للسطر خطط، لا تعرض الكتلة شيئًا ولا يُستدعى قالبك.
كل إدخال في
view.plans هو { id: number, name: string, discountPercent: number }.
استخدم
onChange لعنصر <select> و selectPlan للأزرار. يعالج onChange بالفعل القيمة الدلالية oneTimeValue؛ إذا وصلت معالجك الخاص بعنصر <select>، فعليك المقارنة مع oneTimeValue واستدعاء selectPlan(null) بنفسك.