إنشاء البرامج النصية وتفعيلها

تتم كتابة البرامج النصية في Shopify Scripts API. تُعد واجهة برمجة التطبيقات (API) هذه إصدارًا من لغة البرمجة Ruby، ولذلك فإنك تحتاج إلى خبرة في البرمجة بلغة Ruby. استخدم تطبيق Script Editor لإنشاء برامجك النصية، وتعديلها، واختبارها، ونشرها.

متطلبات الخطة

اعتبارًا من 30 يونيو 2026، تم إيقاف Shopify Scripts. وتم إلغاء تنشيط أي نصوص Scripts كانت لا تزال منشورة في متجرك ولم تعد تعمل. لإعادة إنشاء هذه التخصيصات، انتقل إلى Shopify Functions. تعرّف على المزيد حول الانتقال من Shopify Scripts إلى Shopify Functions.

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

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

القنوات المدعومة

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

• التطبيقات المخصصة المُنشأة باستخدام Storefront API، وJavaScript Buy SDK، وMobile Buy SDKs (لنظامي التشغيل Android وiOS)
• التطبيقات المخصصة التي تُنشئ عمليات الدفع
• أدوات إنشاء تطبيقات الأجهزة المحمولة Tapcart، وPlobal Apps، وVajro

ملاحظة

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

يمكنك العثور على أمثلة للبرامج النصية الشائعة في قوالب البرامج النصية المتوفرة في تطبيق Script Editor. ولعرض هذه القوالب، ستحتاج إلى إنشاء برنامج نصي.

إنشاء برنامج نصي

لإنشاء برنامج نصي:

راجع Shopify Scripts API كمرجع لكتابة رموز البرامج النصية.

1. افتح تطبيق Script Editor. تعرض صفحة نظرة عامة على البرامج النصية (Scripts) قائمة بالبرامج النصية لمتجرك.
2. انقر على إنشاء برنامج نصي (Create script) لبدء إنشاء برنامج نصي جديد.
3. في مربع الحوار تحديد قالب البرنامج النصي :
   1. اختر نوع البرنامج النصي الذي ترغب في إنشائه.
   2. اختر قالبًا كنموذج لنقطة البداية، أو اختر قالبًا فارغًا (Blank template) للبدء في كتابة برنامج نصي من الصفر.
   3. انقر على إنشاء برنامج نصي لإنشاء برنامج نصي بالنوع الذي اخترته.

      نصيحة

      يحدد نوع البرنامج النصي الذي تختاره هنا (عناصر الأسطر (Line items)، أو أسعار الشحن (Shipping rates)، أو بوابات الدفع (Payment gateways)) نوع البرنامج النصي، والطرق التي يمكن للبرنامج النصي استخدامها.

4. في مربع **العنوان** (Title)، أدخل اسمًا للبرنامج النصي. استخدِم اسمًا وصفيًا حتى تتمكن من معرفة وظيفة البرنامج النصي في لمحة. 5. انقر على **الرمز** (Code) لفتح وحدة تحكم **الرمز المصدري للغة Ruby** (Ruby source code). 6. أدخل الرمز الخاص ببرنامجك النصي. استخدِم [وثائق Shopify Scripts API](/manual/checkout-settings/script-editor/shopify-scripts) كمرجع. 7. انقر على **تشغيل البرنامج النصي** (Run script) لتشغيل البرنامج النصي. 8. عند الانتهاء: * انقر على **حفظ كمسودة** (Save draft) لحفظ مسودة غير منشورة من البرنامج النصي * انقر على **حفظ ونشر** (Save and publish) لإنشاء البرنامج النصي ونشره.

الخطوات التالية

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