إنتقل إلى المحتوى الرئيسي

تثبيت استوديو المنتجات على متجر سلة

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


قبل أن تبدأ

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

التطبيق مصمم باللغة العربية أولاً (RTL) ليناسب التجار والعملاء العرب.

المتطلبات

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

الخطوة ١: تثبيت التطبيق من متجر تطبيقات سلة

  1. سجل الدخول إلى لوحة تحكم متجرك على سلة
  2. انتقل إلى متجر التطبيقات (App Store) من القائمة الجانبية
  3. ابحث عن "استوديو المنتجات" أو "Product Studio"
  4. اضغط على زر تثبيت (Install)

📸 Screenshot Needed

Dashboard Section: سلة > لوحة التحكم > متجر التطبيقات UI State: صفحة متجر تطبيقات سلة مع إظهار تطبيق "استوديو المنتجات" في نتائج البحث. يظهر زر "تثبيت" باللون البنفسجي (لون سلة الأساسي). What to Capture: صفحة متجر التطبيقات كاملة مع شريط البحث ونتيجة تطبيق استوديو المنتجات. إظهار اسم التطبيق، الأيقونة، وزر التثبيت. RTL Note: القائمة الجانبية بالعربية من اليمين لليسار. نص البحث وعناصر التطبيق RTL. Size: 1440×900px


الخطوة ٢: تفويض الصلاحيات (OAuth)

بعد الضغط على تثبيت، ستظهر شاشة تفويض الصلاحيات. هذه الصلاحيات ضرورية لعمل التطبيق:

الصلاحيةلماذا يحتاجها التطبيق
قراءة المنتجاتلعرض منتجات متجرك داخل استوديو المنتجات وتطبيق التخصيص عليها
قراءة وتعديل خيارات المنتجلإنشاء وإدارة خيارات سلة (Salla Options) المرتبطة بحقول التخصيص
قراءة الطلباتلعرض طلبات العملاء المخصصة في لوحة تحكم الطلبات داخل التطبيق
قراءة بيانات المتجرلمعرفة إعدادات المتجر (العملة، اللغة) وتكييف واجهة التطبيق
  1. راجع الصلاحيات المطلوبة في شاشة التفويض
  2. اضغط على موافقة (Authorize) للمتابعة

📸 Screenshot Needed

Dashboard Section: سلة > شاشة تفويض OAuth UI State: شاشة تفويض الصلاحيات مع قائمة الصلاحيات الأربعة الموضحة أعلاه. زر "موافقة" في الأسفل. What to Capture: شاشة التفويض كاملة مع جدول الصلاحيات. إظهار اسم التطبيق في الأعلى وقائمة الصلاحيات. RTL Note: نص الصلاحيات RTL. العنوان والشروح بالعربية. Size: 800×700px


الخطوة ٣: التحقق من نجاح التثبيت

بعد التثبيت الناجح، سيتم توجيهك إلى لوحة تحكم التطبيق. تحقق من الآتي:

  1. ✅ تظهر لوحة تحكم استوديو المنتجات مع قائمة المنتجات
  2. ✅ يظهر اسم متجرك في أعلى الشاشة وحالة الاتصال "متصل"
  3. ✅ تظهر منتجات متجرك في القائمة (قد تحتاج إلى مزامنة أول مرة)
  4. ✅ عند فتح أي منتج، يظهر زر "استوديو المنتجات" (Product Studio)

📸 Screenshot Needed

Dashboard Section: استوديو المنتجات > لوحة التحكم > قائمة المنتجات UI State: لوحة التحكم الرئيسية بعد التثبيت مباشرة. تظهر قائمة بمنتجات المتجر مع حالة "غير مُخصص" لكل منتج لم يتم إعداد الاستوديو له بعد. اسم المتجر وحالة الاتصال في الأعلى. What to Capture: صفحة لوحة التحكم كاملة بعد التثبيت. إظهار شريط التنقل العلوي، قائمة المنتجات، وحالة الاتصال. RTL Note: كامل الواجهة RTL. أسماء المنتجات عربية من اليمين. Size: 1440×900px


ماذا بعد التثبيت؟

بعد تثبيت التطبيق بنجاح:

  • تم إضافة كود الودجت (widget snippet) تلقائيًا إلى صفحات منتجات متجرك
  • الودجت لن يظهر للعملاء حتى تقوم بتفعيل التخصيص لمنتج واحد على الأقل
  • يمكنك الآن بدء أول منتج مخصص في أقل من ٥ دقائق

⚠️ ملاحظة أمان: الودجت لا يظهر على المنتجات غير المفعلة. يمكنك العمل على مسودة المنتج في الاستوديو بأمان دون أن يراه العملاء حتى تضغط على "تفعيل". للمزيد راجع دورة حياة المسودة والتحقق والتفعيل.


استكشاف الأخطاء

التطبيق لا يظهر في نتائج البحث

  • تأكد من كتابة اسم التطبيق بشكل صحيح: "استوديو المنتجات"
  • تأكد من أن متجرك على خطة تدعم تطبيقات الطرف الثالث
  • جرب الوصول المباشر من رابط التطبيق (إذا توفر)

فشل التفويض

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

المنتجات لا تظهر في لوحة التحكم


مقالات ذات صلة


آخر تحديث: 2026-05-17