ضمّن Alter Product في موقعك: WordPress + WooCommerce أو API

توفّر الإضافة وظائف جاهزة لـ WordPress وWooCommerce. وتتيح API بناء اتصال مخصص بمنصة أخرى أو تطبيق headless أو نظام قائم لإدارة الطلبات.

اختر الأداة وفق ما يحتاج العميل إلى فعله في الموقع. جهّز التصميم وقواعد التخصيص مسبقًا في Designer.

يتطلب تضمين Alter Product في موقعك اشتراك Business نشطًا أو خطة أعلى تشمل هذه الميزة. ينطبق ذلك على إضافة WordPress + WooCommerce وعلى التكامل المخصص عبر API. لا تشمل خطتا Personal FREE وPersonal التضمين في متجرك.

عند استخدام الإضافة، جهّز WordPress مع WooCommerce مثبتًا ومفعّلًا وحساب Alter Product. تخزين الملفات على استضافتك لا يحل محل الاشتراك المطلوب: يظل Alter Product يوفّر التطبيق ويصرّح بتشغيله.

يعمل Alter Product داخل إطار iframe مضمّن في صفحة المتجر. تقيّد المتصفحات الوصول إلى بعض الميزات التي يستخدمها التطبيق إذا لم توفّر الصفحة سياقًا آمنًا. يشفّر HTTPS الاتصال، وتتيح الشهادة الصالحة للمتصفح التحقق من النطاق.

يتحقق المتصفح أيضًا من الصفحة التي تحتوي على iframe. لذلك لا يكفي أن يكون عنوان تطبيق Alter Product عبر HTTPS إذا كان المتجر يعمل عبر HTTP. يجب أن تستخدم صفحتك التي تضمّن الأداة HTTPS أيضًا. وهذا ناتج عن قواعد أمان المتصفحات للتطبيقات المضمّنة.

يرشدك الاتصال التلقائي خلال تفويض حساب Alter Product وإعداد المتجر. لا تحتاج إلى نقل مفاتيح API يدويًا عند استخدام هذه الطريقة.

في محرر منتج WooCommerce، افتح تبويب Alter Product. أنشئ تصميمًا جديدًا أو اختر تصميمًا قائمًا، ثم افتح Designer. اضبط الطباعة والخيارات المتاحة ومناطق الطباعة لهذا المنتج.

تحفظ الإضافة ملفات النماذج والمكتبات والتصاميم والـ mockups والطلبات في مساحة WordPress. وتُحفظ بيانات مشاريع المولّد ومراجعاتها أيضًا في قاعدة بيانات هذا التثبيت.

يمكنك إضافة موادك واستيراد أصول مختارة من Alter Product. بعد التنزيل تستخدم نسخة محلية. الاستيراد والتحقق من التحديثات وتنزيل الإصدارات الجديدة عمليات منفصلة.

تدير المكتبة والتصاميم في لوحة WordPress بالصلاحيات المناسبة. يستخدم العملاء الأدوات والمواد المتاحة في متجرك دون الوصول إلى التحرير الإداري للمكتبة.

تقرر أي تصميم تربطه بالمنتج، وأين تعرض الأداة المضمّنة، وما خيارات التخصيص التي تتيحها. تحقق أيضًا من الأصول المتاحة في مكتبة Customizer المضمّن. بعد ربط التصميم، قد يكون التضمين مفعّلًا افتراضيًا في صفحة المنتج؛ وتتحكم في عرضه من إعدادات المنتج.

تخزّن الأصول لديك، بينما تُحمّل واجهة الأدوات من Alter Product داخل iframe. تتحقق خدمة Alter Product من وصول الحساب والخطة والجلسات وتوفّر كتالوج الاستيراد. يتطلب التكامل الاتصال بهذه الخدمة.

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

اختر طريقة العرض المناسبة لتخطيط المتجر: أداة داخل صفحة المنتج، أو زر ينقل إلى صفحة مخصصة، أو تضمين عبر الكتل والأكواد القصيرة المتاحة. تؤدي أدوات Viewer وConfigurator وCustomizer أدوارًا مختلفة، فلا يلزم إتاحتها جميعًا في الوقت نفسه.

كيّف عرض المنتج مع علامتك التجارية. تدير في الإضافة الخلفيات والشعارات المحلية وإعدادات مظهر الأدوات المضمّنة. يعتمد توفر الخيارات الفردية على الخطة.

يختار العميل المتغير ويجهّز التخصيص. تربط الإضافة التكوين والتصميم المحفوظ بعنصر السلة، ثم بطلب WooCommerce. تساعد الـ mockups المتاحة على تمييز الطباعة المطلوبة.

اضبط الاتصال بالمزوّد المختار في إعدادات الإضافة. ثم اربط المنتج والمتغيرات ومواضع الطباعة بكتالوج المزوّد، وجهّز الملفات وأرسل طلب WooCommerce للتنفيذ.

يمكنك إعداد اتصالك الخاص بمزوّد AI واستخدام ميزات إنشاء الصور أو تحسينها أثناء العمل على التصميم. تنتقل طلبات الإضافة من WordPress إلى المزوّد المختار وتُحتسب على حسابك لدى ذلك المزوّد.

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

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

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

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

تتشارك الأدوات المضمّنة داخل المتجر نفسه الحد الشهري للجلسات. يُحسب العداد بصورة مستقلة لكل متجر حسب الأشهر التقويمية بتوقيت UTC. وتزيد جلسات Designer ومولّد النماذج المضمّنين الجديدة في لوحة WordPress هذا العداد أيضًا. تنزيل نموذج متاح عبر API الاستيراد وحده لا يفتح جلسة محرر.

بعد بلوغ الحد، يرفض النظام إصدار جلسات إضافية. هذا حد استخدام ضمن الاشتراك؛ راجع خطتك لمعرفة الحصة الحالية.

تعتمد Public API على طلبات HTTP وبيانات JSON. لذلك يمكنك كتابة تكاملك بلغة وبيئة الخادم الخلفي لديك. لا تحتاج إلى إعادة بناء المتجر على WordPress لتضمين أدوات Alter Product.

فيما يلي أمثلة على تقنيات إنشاء الاتصال من جانب الخادم. تنفّذ في كل منها المراحل نفسها: تفويض API وإنشاء جلسة الأداة وربط المنتجات والسلة والطلبات بنظامك.

في المتصفح، يمكنك استخدام React أو Vue أو Angular أو HTML وJavaScript العاديين. يناسب TypeScript تنفيذ الاتصال أيضًا. تضمّن الصفحة iframe وتعالج أحداث postMessage وتتصل بخادمك الخلفي.

تتولى الواجهة الأمامية مظهر الصفحة وتفاعلات السلة، بينما يتولى الخادم الخلفي استدعاءات Public API الموثّقة. في أطر العمل التي تجمع الطبقتين، مثل Next.js، ضع إدارة المفاتيح الدائمة وإنشاء الجلسات في الجزء الخاص بالخادم فقط.

يمكنك الاحتفاظ بعملية الدفع ونظام المدفوعات وCMS ومسار تنفيذ الطلبات لديك. أثناء التنفيذ، تربط هذه العناصر ببيانات التصميم وأحداث أداة Alter Product المختارة.

يوفّر Alter Product الأدوات ثلاثية الأبعاد وبيانات التصاميم وآليات الجلسات. يربط خادمك الخلفي هذه العناصر بالمنتجات وحسابات العملاء والسلة وإدارة الطلبات. ويمكنك إنشاء نقاط نهاية وسيطة لواجهتك الأمامية دون كشف بيانات وصول Alter Product في المتصفح.

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

تجد المعلمات والأمثلة في تعليمات التضمين. تشرح فصول postMessage الاتصال بالصفحة، وتصف وثائق API العمليات التي ينفّذها الخادم الخلفي.

بعد إعداد منتج واحد، مرّ بجميع الخطوات. ثم طبّق طريقة الإعداد التي تحققت منها على بقية منتجات الكتالوج.