التوثيق

المتطلبات: PHP 8.1 أو أحدث، ويُنصح بـWordPress 6.0 أو أحدث. تحتاج وحدات التجارة إلى WooCommerce، وتحتاج عناصر الواجهة إلى Elementor.

نزّل أحدث ZIP من حسابك، ثم افتح الإضافات ← أضف إضافة جديدة ← رفع إضافة في WordPress وثبّته وفعّله. افتح StoreKit ← الترخيص، وأدخل المفتاح وفعّله للنطاق الحالي.

تصل التحديثات المرخصة عبر WordPress بروابط حزم مؤقتة وموقعة. تحتفظ StoreKit بنتيجة التحقق البعيد الناجح خلال نافذة محدودة عند انقطاع الاتصال.

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

تشمل وحدات عرض القصة والتحويل تفاصيل المنتج والتقييمات والمنتجات المرتبطة وزر الشراء الثابت، وإجراءات الهيدر للحساب والبحث واللغة والمفضلة والسلة، وكتلة الرسالة التحريرية، وتنسيق الدفع المعتمد على دفع WooCommerce الأصلي.

وحدة حالة السلة الفارغة محفوظة لتصميم اختياري مستقبلي ومعطلة افتراضيًا.

تبقى WooCommerce مصدر الحقيقة. تتحقق الطلبات المخصصة من nonce وتوحّد بيانات المنتج والمتغير والكمية قبل استدعاء واجهات WooCommerce.

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

اختبر المتغيرات وحدود المخزون والضرائب والشحن وإضافات الدفع على نسخة معاينة قبل الإطلاق.

تُحمّل StoreKit كل وحدة بعد توفر تبعياتها المعلنة فقط. ولا تستبدل تخزين منتجات WooCommerce أو جلسات السلة أو تحقق الدفع أو المجاميع أو إنشاء الطلبات.

قبل الإطلاق: أعد إنشاء ملفات Elementor وCSS بعد تغييرات القوالب الكبيرة؛ واستبعد السلة والدفع والحساب من التخزين المؤقت الكامل؛ واختبر السلة للمسجلين والزوار؛ واختبر كل تركيبات المتغيرات وحالات عدم التوفر؛ وتأكد من أن إضافات الدفع والقوائم متعددة اللغات لا تكرر عناصر التحكم.

إذا اختفى عنصر واجهة، فتأكد من تفعيل وحدته ومن تشغيل Elementor أو WooCommerce عند الحاجة، ثم أعد إنشاء ملفات Elementor وامسح ذاكرة الصفحات.

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

إذا لم يظهر تحديث، فتأكد من تفعيل الترخيص للنطاق الدقيق وشغّل فحص تحديثات WordPress مجددًا. راسل [email protected] مع إصدار StoreKit وتقرير نظام WooCommerce.