المساعدة
تسجيل الدخول

متطلبات وقيود Shopify Scripts

توجد بعض القيود على Shopify Scripts لتعزيز الأمان وللتأكد من إمكانية تشغيل النصوص البرمجية بغض النظر عن عدد العملاء الذين يستخدمون متجرك في أي وقت. ضع القيود التالية في الاعتبار إذا كنت تطور نصوصًا برمجية لمتجر Shopify الخاص بك.

في هذه الصفحة

المتجر الإلكتروني وStorefront API

عندما تقوم بإنشاء نص برمجي أو تعديله، فإنك تختار ما إذا كان سيتم تشغيله فقط في متجرك الإلكتروني، أو في متجرك الإلكتروني وفي التطبيقات التالية:

لكي تعمل النصوص البرمجية، يجب أن يحتوي موقعك الإلكتروني على وظيفة سلة مشتريات مدمجة، لذلك لا يمكنك استخدام النصوص البرمجية مع أزرار الشراء أو قناة مبيعات Facebook and Instagram by Meta.

النصوص البرمجية المنشورة

لا يمكن نشر سوى نص برمجي واحد لكل نوع من النصوص البرمجية في كل مرة. على سبيل المثال، يمكنك نشر نص برمجي لعناصر الأسطر ونص برمجي لأسعار الشحن، لكن لا يمكنك نشر نصين برمجيين لعناصر الأسطر في الوقت نفسه.

الحد الأقصى لعدد Shopify Scripts

يمكنك إنشاء ما يصل إلى 200 من Shopify Scripts.

مسودات الطلبات

لا تعمل النصوص البرمجية لعناصر الأسطر والنصوص البرمجية لأسعار الشحن والنصوص البرمجية للمدفوعات مع مسودات الطلبات أو عملية الدفع الخاصة بمسودات الطلبات.

الحقول الوصفية

لا يمكن لـ Shopify Scripts الوصول إلى الحقول الوصفية.

سمات سلة المشتريات/الدفع

لا يمكن لـ Shopify Scripts الوصول إلى سمات سلة مشتريات Shopify Liquid. يمكنك إضافة هذه السمات إلى صفحات سلة المشتريات لجمع معلومات إضافية من عملائك، ولكن لا يمكنك إنشاء نص برمجي يستخدمها.

أكواد الخصم

يمكن للنصوص البرمجية الوصول إلى معلومات حول ما إذا كان كود الخصم مُطبقًا، ومبلغ الخصم، ونوعه، مثل مبلغ ثابت أو نسبة مئوية أو شحن. ولا يمكن للنصوص البرمجية الوصول إلى كيفية تطبيق كود الخصم، على سبيل المثال ما إذا كان مخصصًا لسلة المشتريات أو لعنصر سطر معين. وهذا يعني أن النصوص البرمجية لا يمكنها الوصول إلى الإجماليات بعد الخصم أو الخصومات التلقائية.

لا تتوافق النصوص البرمجية لعناصر الأسطر والشحن التي تصل إلى الخصومات المطبقة على سلة المشتريات مع مجموعات الخصم. لا يمكن للطريقة .discount_code إرجاع سوى كود خصم واحد. سلال المشتريات التي تتضمن أكواد خصم متعددة باستخدام مجموعات الخصم غير مدعومة.

عناصر الأسطر

لا يمكن للنصوص البرمجية إضافة عناصر إلى سلة المشتريات أو زيادة سعر عنصر.

أسعار الشحن

لا يمكن للنصوص البرمجية زيادة سعر الشحن.

تعدد العملات

قد لا تعمل نصوصك البرمجية مع خاصية تعدد العملات كما هو متوقع. لضمان عمل نصوصك البرمجية مع سلال المشتريات أو عمليات الدفع بأي عملة غير العملة الأساسية لمتجرك، يتعين عليك ترحيل نصوصك البرمجية إلى Shopify Functions.

التعابير النمطية

لا تُدعم مطابقة التعابير النمطية. إذا كنت تنشئ نصًا برمجيًا لعنصر سطر، فقد تتمكن من استخدام إحدى الطرق التالية كحل بديل:

القوالب

قد تحتاج إلى تحديث قالب Liquid الخاص بك لدعم نصوصك البرمجية وتجنب إرباك عملائك. على سبيل المثال، لا تعرض جميع القوالب خصومات عناصر الأسطر في سلة المشتريات. إذا كانت هذه هي حالتك، فستحتاج إلى تعديل قالبك لعرض خصومات عناصر الأسطر في سلة المشتريات. تعرف على المزيد حول أنواع التعديلات التي يمكنك إجراؤها على قوالب Liquid الخاصة بك.

الموارد

تكون سعة وحدة المعالجة المركزية (CPU) والذاكرة المتاحة للنص البرمجي محدودة. تعتمد الموارد المحجوزة للنص البرمجي على حجم سلة المشتريات ومقدار العمليات الحسابية التي يتطلبها النص البرمجي. تتتبع Shopify حدود هذه الموارد بعناية للتأكد من أنها لا تمنع نصك البرمجي من العمل كما هو مقصود.

عندما تقوم باختبار نص برمجي، تطبع وحدة تحكم Script Editor النسبة المئوية للموارد المخصصة التي يستخدمها النص البرمجي.

الإدخال/الإخراج

باستثناء حالات قليلة، لا تمتلك Shopify Scripts القدرة على الإدخال/الإخراج. وهذا يعني أن النصوص البرمجية لا يمكنها تنفيذ طلبات الويب أو استدعاءات قاعدة البيانات، ولا يمكنها الحصول على مدخلات من المستخدم.

يمكن استخدام طريقة puts لطباعة نص في وحدة التحكم في تطبيق Script Editor.

الوقت والعشوائية

لا يمكن أن تتضمن البرامج النصية عمليات حسابية عشوائية أو تستند إلى الوقت. لا يمكن لـ Shopify Scripts الوصول إلى الكائن Time والعملية rand.

نظراً لأن البرامج النصية تعمل في كل مرة يتم فيها إعادة حساب إجمالي سلة التسوق، فإن البرامج النصية التي تستند إلى الوقت أو إلى إنشاء أرقام عشوائية قد تسفر عن نتائج غير متوقعة أو مربكة إذا قام العميل بتغيير سلة التسوق الخاصة به بشكل متكرر. ومع ذلك، يمكنك جدولة تشغيل البرامج النصية أثناء الفعاليات باستخدام تطبيق Launchpad.

حد أحرف البرنامج النصي

يمكنك إنشاء برامج نصية بحد أقصى 40,960 حرفًا.

طلبات الاشتراك

إذا كانت البرامج النصية لعناصر السطر والشحن تُنشئ خصمًا لمنتج اشتراك، فسيُطبَّق الخصم على عمليات الدفع التالية:

  • عملية الدفع الأولى لطلبات الدفع لكل عملية تسليم فقط، دون تطبيقه على الطلبات المجدولة
  • المبلغ بالكامل لطلب اشتراك مدفوع مسبقًا

تعرّف على المزيد حول الاشتراكات والبرامج النصية.

عمليات الدفع السريع

عند استخدام Shopify Scripts مع عمليات الدفع السريع، يتم تطبيق خصومات الشحن بعد أن يختار العميل طريقة دفع سريع. ولهذا السبب، لا تظهر التغييرات على سعر الطلب على جهاز العميل أو متصفحه. يمكن للعملاء عرض السعر الأصلي في عملية الدفع السريع الخاصة بهم، ولكن سيتم تحصيل السعر الصحيح بعد الخصم منهم.

نقطة البيع (POS) من Shopify

لا تعمل Shopify Scripts مع نقطة البيع (POS) من Shopify.

إعادة تسمية بوابات الدفع

لا يمكنك إعادة تسمية بوابات الدفع التي تحتوي على صور أو شعارات تُعرض كاسم للبوابة. يمكن إعادة تسمية بوابات الدفع التي تحتوي على صور شعار بجوار أسمائها.

الشحن المقسَّم في صفحة الدفع

البرامج النصية للشحن غير متوافقة مع الشحن المقسَّم في صفحة الدفع في Shopify. إذا كنت تستخدم برامج نصية للشحن وتقوم بتفعيل الشحن المقسَّم، فلن يتم عرض الشحنات المقسَّمة لعملائك في صفحة الدفع.