تعليمات التثبيت [WooCommerce]

قبل البدء

تأكد من أن متجرك يفي بالحد الأدنى من المتطلبات:

  • WordPress: 6.4+
  • WooCommerce: 6.0+ (مثبّت ومفعّل)
  • PHP: 8.0+
  • يلزم خادم يدعم HTTPS / SSL لأسباب أمنية
  • يلزم حساب Alter Product (ستستخدم Access Key + Access Token)

مهم: تشغّل الإضافة customizer أو configurator أو viewer داخل iframe معزول، لذا لا تعدّل السلوك الأساسي لإتمام الشراء في WooCommerce.

خطوات التثبيت والإعداد

  1. سجّل الدخول إلى لوحة إدارة WordPress.
  2. في لوحة إدارة WordPress، انتقل إلى إضافات → أضف إضافة جديدة، وابحث عن Alter Product – 3D Configurator for WooCommerce وثبّتها ثم فعّل الإضافة.* اختياري: ارفع ملف ZIP يدويًا وفعّل الإضافة.
  3. في لوحة إدارة WordPress، افتح Alter Product وانقر على اتصال ضمن الاتصال التلقائي.* إعداد يدوي اختياري: أنشئ مفاتيح API في صفحة إعدادات API في Alter Product، وانسخ Access Key وAccess Token، ثم أضف نطاق متجرك في إعدادات التضمين.
  4. اتبع خطوات التثبيت المعروضة لإكمال التهيئة.
  5. أنشئ تصميمك الأول - انتقل إلى صفحة تعديل المنتج في WooCommerce. في علامة تبويب Alter Product، أنشئ تصميمًا جديدًا (أو اختر تصميمًا موجودًا). سيُربط التصميم بالمنتج. حدّد متغيرات مطابقة لمنتج WooCommerce، وفعّل Customizer اختياريًا، ثم احفظ المشروع.

بعد الإعداد

بعد التهيئة، يمكنك:

  • إدارة الأصول، بما فيها المنتجات والمتغيرات والنماذج التسويقية ومكتبة الرسومات والشعارات وقوالب التصميم والخلفيات والبيئات والخطوط
  • استيراد مشاريع من مساحة تخزين Alter Product
  • إنشاء تصاميم المنتجات وإدارتها
  • عرض زر الأداة المختارة للتجارة الإلكترونية في صفحات متجر WooCommerce العامة أو صفحات المنتجات
  • تضمين Viewer / Configurator / Customizer في صفحات منتجات WooCommerce أو صفحات WordPress
  • ربط منتجات WooCommerce بتصاميم Alter Product
  • السماح للعملاء بتخصيص المنتجات (النصوص والصور والتخطيطات ورموز QR وغيرها)
  • مزامنة التهيئة المختارة مع سلة WooCommerce

استكشاف الأخطاء وإصلاحها

  • فشل اختبار API: تحقق من Access Key / Access Token واتصال خادمك بـ https://alterproduct.com/public-api في Alter Product → الحالة.
  • مشكلات تنزيل الأصول: انتقل إلى Alter Product → الحالة وتأكد من أن خادمك يفي بالمتطلبات في جدول موارد الخادم.
  • iframe فارغ / لا يوجد تواصل: تأكد من إضافة نطاق متجرك في Alter Product ضمن إعدادات التجارة الإلكترونية → التكامل، أو تحقق من استخدام خادمك HTTPS بشهادة SSL صالحة.
  • مشكلة في الروابط الدائمة: إذا عرضت صفحات Customizer أو Configurator أو Viewer رسالة غير موجود، فانتقل إلى الإعدادات → الروابط الدائمة وانقر على حفظ التغييرات لتحديث قواعد إعادة كتابة الروابط.
  • الإضافة إلى السلة لا تعمل: تأكد من اكتمال ربط المنتج وتفعيل إجراءات التجارة الإلكترونية في الأداة المضمّنة.