تخصيص أو إزالة زر شراء أو مجموعة مضمّنة أو عربة تسوق مضمّنة

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

يعرض زر الشراء منتجاً باستخدام زر شراء. وتعرض المجموعة المضمّنة منتجات متعددة. بينما تعرض عربة التسوق المضمّنة عربة تسوق مستقلة يمكن للعملاء استخدامها عبر الصفحات.

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

فهم كود تضمين زر الشراء (Buy Button)

يتكون كل زر شراء من أجزاء منفصلة تُسمى المكوّنات. المكوّن هو قسم مسمى في كود التضمين يتحكم في جزء واحد من تجربة زر الشراء. على سبيل المثال، عند إضافة منتج مع سلة إلى صفحة الويب الخاصة بك، يُنشئ كود التضمين المكوّنات التالية:

• مكوّن product، الذي يعرض معلومات المنتج وزر الشراء
• مكوّن cart، الذي يعرض محتويات السلة
• مكوّن toggle للسلة، الذي يعرض الأيقونة التي تفتح السلة

إذا كان مكوّن المنتج يفتح نافذة منبثقة لتفاصيل المنتج، فإن كود التضمين يُنشئ مكوّنين إضافيين: مكوّن modal للنافذة المنبثقة نفسها ومكوّن modalProduct لمعلومات المنتج داخل النافذة المنبثقة.

في المقتطف البرمجي التالي، هناك مكوّنات منفصلة لـ product وcart:

ShopifyBuy.UI.onReady(client).then(function (ui) {
  ui.createComponent('product', {
    id: 12345,
    options: {
      product: {
        buttonDestination: 'cart',
        contents: {
          description: true
        },
        text: {
          button: 'Add to Cart'
        },
        styles: {
          button: {
            'background-color': 'blue'
          }
        }
      },
      cart: {
        styles: {
          button: {
            'background-color': 'orange'
          }
        }
      }
    }
  });
});

يتم تكوين كل مكوّن من خلال كائن تكوين في كود التضمين. الكائن هو مجموعة منظمة من الإعدادات، يتم تنسيقها كقائمة من أزواج المفتاح والقيمة:

• المفتاح هو اسم الإعداد، مثل buttonDestination.
• القيمة هي ما يتم تعيين الإعداد إليه، مثل 'cart'.

يشبه الكائن جدول البيانات: يتوافق كل مفتاح مع اسم عمود، وتتوافق كل قيمة مع محتويات الخلية. لتغيير مظهر أو سلوك أزرار الشراء، قم بتعديل المفاتيح والقيم داخل كائنات التكوين.

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

تخصيص أنماط المكوّنات

يحتوي كل مكوّن على كائن تكوين متداخل styles يتحكم في مظهر المكوّن. الكائن المتداخل هو كائن موضوع داخل كائن آخر.

يستخدم كائن styles لغة CSS، وهي اللغة المستخدمة لوصف كيفية تنسيق عناصر صفحة الويب مرئيًا. يمثل كل مفتاح من المستوى الأعلى في كائن styles عنصرًا في المكوّن، مثل العنوان أو الزر. وضمن هذا المفتاح، كل مفتاح متداخل هو خاصية CSS (على سبيل المثال، background-color أو border)، والقيمة هي قيمة CSS.

options: {
  product: {
    styles: {
      button: {
        'background-color': 'red',
        'border-radius': '5px'
      }
    }
  }
}

يمكن إضافة أي خاصية CSS صالحة إلى styles. تأكد من إحاطة أسماء الخصائص التي تحتوي على شرطات بعلامات اقتباس.

لمزيد من المعلومات حول تخصيص CSS، اعرض وثائق المطوّرين.

مكوّنات المجموعة المضمّنة

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

يتم تكوين بعض المفاتيح، مثل نص المكوّن، من خلال كائنات متداخلة. على سبيل المثال، نص زر الصفحة التالية موجود داخل كائن text الخاص بمكوّن productSet:

options: {
  productSet: {
    text: {
      nextPageButton: 'Continue'
    }
  }
}

استبدال رابط سلة تضمين المنتج بنافذة منبثقة لتفاصيل المنتج

النافذة المنبثقة لتفاصيل المنتج هي نافذة منبثقة تعرض معلومات المنتج. لتوجيه عميلك إلى نافذة منبثقة لتفاصيل المنتج بدلًا من السلة، قم بتعديل كود تضمين زر الشراء في مصدر HTML لصفحة الويب الخاصة بك.

الخطوات:

1. افتح HTML الخاص بالصفحة التي تحتوي على تضمين المنتج الذي تريد تغييره.
2. ابحث عن كائن التكوين product.
3. ابحث عن مفتاح buttonDestination في الكائن:

options: {
      product: {
        buttonDestination: 'cart'
      }
}

4. قم بتغيير قيمة ذلك المفتاح إلى 'modal'، متضمنةً علامات الاقتباس:

options: {
      product: {
        buttonDestination: 'modal'
      }
}

5. احفظ تغييراتك.

تغيير تخطيط تضمين المنتج

يضع التخطيط الأفقي لتضمين المنتج الصورة بجوار تفاصيل المنتج بدلًا من وضعها أعلاها. للتبديل إلى هذا التخطيط، قم بتعديل كود تضمين زر الشراء في مصدر HTML لصفحة الويب الخاصة بك.

الخطوات:

1. افتح HTML الخاص بالصفحة التي تحتوي على تضمين المنتج الذي تريد تغييره.
2. ابحث عن كائن التكوين product.
3. أضف مفتاح layout، ثم قم بتعيين القيمة إلى 'horizontal'. تأكد من أن القيمة تتضمن علامات الاقتباس وأن السطر السابق ينتهي بفاصلة:

options: {
      product: {
        buttonDestination: 'modal',
        layout: 'horizontal'
      }
}

4. احفظ تغييراتك.

تغيير مظهر وسلوك تضمين السلة

لتغيير مظهر أو سلوك السلة، قم بتعديل كائن التكوين cart في كود التضمين الخاص بك.

الخطوات:

1. افتح HTML الخاص بالصفحة التي تحتوي على السلة التي تريد تعديلها.
2. ابحث عن كائن التكوين cart في كود التضمين الخاص بك:

options: {
      cart: {
        startOpen: false
      }
}

3. قم بتعديل مفتاح موجود، أو إضافة مفتاح جديد، لتغيير مظهر السلة أو سلوكها. للحصول على قائمة كاملة بالمفاتيح القابلة للتكوين، اعرض وثائق المطوّرين.
4. احفظ تغييراتك.

حذف زر شراء أو مجموعة مضمّنة أو سلة مضمّنة

لإزالة زر شراء أو مجموعة مضمّنة أو سلة مضمّنة من صفحة الويب الخاصة بك، احذف كود التضمين الخاص بها من مصدر HTML.

الخطوات:

1. افتح مصدر HTML لصفحة الويب التي تحتوي على زر الشراء أو المجموعة المضمّنة أو السلة المضمّنة.
2. احذف كود التضمين بالكامل من مصدر HTML، بدءًا من <script data-shopify-buy-ui> وانتهاءً بـ </script>. فيما يلي مثال على كود تضمين زر الشراء:

<script data-shopify-buy-ui>
   var scriptURL = "https://cndurl.com/buy-button-storefront.js";
    if (window.ShopifyBuy && window.ShopifyBuy.UI) {
      ShopifyBuyInit();
    } else {
      var script = document.createElement('script');
      script.async = true;
      script.src = scriptURL;
      (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(script);
      script.onload = ShopifyBuyInit;
    }

    function ShopifyBuyInit() {
      var client = ShopifyBuy.buildClient({
        apiKey: 'your-api-key',
        domain: 'your-store.myshopify.com',
        appId: '6'
      });

      ShopifyBuy.UI.onReady(client).then(function (ui) {
        ui.createComponent('product', {
          id: 12345,
          options: {
            product: {
              buttonDestination: 'cart',
              contents: {
                description: true
              },
              text: {
                button: 'Add to Cart'
              },
              styles: {
                button: {
                  'background-color': 'blue'
                }
              }
            },
            cart: {
              styles: {
                button: {
                  'background-color': 'orange'
                }
              }
            }
          }
        });
      });
    }
</script>

3. احفظ تغييراتك.