لكي تستورد المنتجات إلى ووكومرس بملف CSV، اذهب إلى المنتجات ← استيراد، وارفع ملف CSV بترميز UTF-8 فيه منتج في كل صف بأسماء أعمدة ووكومرس (Type وSKU وName وRegular price وCategories وImages والخصائص)، وطابق الأعمدة، وشغل الاستيراد. المنتجات المتغيرة تحتاج صفا للأب وصفا لكل خيار مربوطا عبر عمود Parent.
استوردت كتالوجات من كل نوع، من البوتيكات الصغيرة إلى كتالوجات الكوبونات والسفر الكبيرة. وأغلب مشكلات الاستيراد سببها ملف CSV لا أداة الاستيراد. هذا الدليل جزء من سلسلة الأتمتة.
ما صيغة CSV لمنتجات ووكومرس؟
ملف مفصول بفواصل بترميز UTF-8 مع صف ترويسة، وكل صف منتج أو خيار. يأتي ووكومرس بملف CSV نموذجي داخل مجلد الإضافة ويوثق كل عمود. نزل النموذج واحتفظ بترويساته، فتطابق أداة الاستيراد الأعمدة تلقائيا.
الأعمدة الأساسية
| العمود | مثال | ملاحظات |
|---|---|---|
| Type | simple | simple أو variable أو variation أو grouped أو external |
| SKU | TSHIRT-BLK-M | فريد، ومفتاح التحديثات المستقبلية |
| Name | تيشيرت أساسي | |
| Published | 1 | 1 منشور، 0 خاص، -1 مسودة |
| Short description | تيشيرت قطن ناعم | يقبل HTML |
| Description | النص الكامل | يقبل HTML |
| Regular price | 350 | دون رمز العملة |
| Sale price | 299 | اختياري |
| Stock | 25 | يتطلب تفعيل إدارة المخزون |
| In stock? | 1 | |
| Categories | ملابس > تيشيرتات | > للتسلسل و, للتعدد |
| Tags | قطن, صيفي | |
| Images | https://cdn.example.com/a.jpg, https://cdn.example.com/b.jpg | أول صورة تصبح الصورة البارزة |
التصنيفات
استخدم الأب > الابن للتسلسل والفواصل للفصل بين عدة تصنيفات:
Clothing > T-shirts, Summer collection
التصنيفات غير الموجودة تنشأ تلقائيا. راجع الكتابة بدقة، فكلمتا “T-shirts” و”Tshirts” تصبحان تصنيفين.
الصور
- روابط كاملة وعامة، تنزلها أداة الاستيراد وترفقها.
- أول رابط هو الصورة البارزة والباقي في المعرض.
- استخدم أسماء ملفات مفهومة وصغر الأحجام قبل الرفع، راجع تحسين الصور.
- إذا كان سيرفر المصدر بطيئا أو يحد الطلبات، استورد على دفعات أصغر.
المنتجات المتغيرة
هنا تفشل أغلب عمليات الاستيراد. تحتاج:
- صف الأب بقيمة
Type = variableواسم الخاصية وكل القيم. - صف خيار لكل تركيبة بقيمة
Type = variationوParentيساوي SKU الأب وقيمة خاصية واحدة.
مثال:
Type,SKU,Parent,Name,Regular price,Attribute 1 name,Attribute 1 value(s),Attribute 1 visible,Attribute 1 global
variable,TSHIRT,,Basic T-shirt,,Size,"S, M, L",1,1
variation,TSHIRT-S,TSHIRT,,350,Size,S,,1
variation,TSHIRT-M,TSHIRT,,350,Size,M,,1
variation,TSHIRT-L,TSHIRT,,370,Size,L,,1
ملاحظات:
Attribute 1 global = 1يستخدم خاصية عامة (المنتجات ← الخصائص)، وهي أفضل للفلترة.- الأسعار والمخزون على الخيارات لا على الأب.
- صف الأب يجب أن يسبق خياراته.
- لخاصيتين أضف
Attribute 2 nameوهكذا، وكل خيار يذكر قيمة واحدة لكل خاصية.
تحديث المنتجات الحالية
فعل تحديث المنتجات الحالية في أداة الاستيراد. يطابق ووكومرس بالـ ID أو SKU ولا يحدث إلا الأعمدة الموجودة، فيمكنك تشغيل ملفات صغيرة، مثلا SKU وRegular price فقط لتحديث الأسعار.
عادات جيدة:
- لا تغير الـ SKU باستخفاف فهي مفاتيحك.
- صدر أولا (المنتجات ← تصدير)، ثم عدل، ثم أعد الاستيراد.
- احتفظ بنسخة من كل ملف استيراد مع التاريخ.
تجهيز ملف CSV
- احفظه بترميز UTF-8 (خاصة للنص العربي، راجع المتجر الإلكتروني العربي).
- استخدم برنامج جداول مناسبا أو سكربت، فبعض البرامج تغير صيغ الأرقام أو تحذف الأصفار البادئة.
- احذف رموز العملات وفواصل الآلاف من الأسعار.
- ضع الحقول التي فيها فواصل بين علامات تنصيص.
- افحص تكرار الـ SKU قبل الاستيراد:
cut -d, -f2 products.csv | sort | uniq -d
(فحص بسيط، استخدم أداة تفهم CSV إذا كانت الحقول تحتوي فواصل.)
استيراد الكتالوجات الكبيرة
- قسم الملف إلى بضع مئات من الصفوف في الاستضافات البطيئة.
- استورد الصور منفصلة أو استضفها على مصدر سريع.
- شغل الاستيراد في أوقات قلة الزيارات.
- عطل مؤقتا الـ hooks الثقيلة إن كان آمنا (مثل الإضافات التي تزامن كل تغيير مع خدمات خارجية)، أو تأكد أن مستقبلات الويب هوكس تتحمل الدفعة.
- راقب حدود وقت PHP، فأداة الاستيراد تعمل على دفعات لكن انتهاء المهلة يحدث في السيرفرات الضعيفة.
أتمتة الاستيراد
لملفات الموردين المتكررة:
- إضافات تجدول الاستيراد من رابط أو FTP.
- سكربت مخصص يستخدم WooCommerce REST API.
- WP-CLI:
wp wc product createأو أمر مخصص، راجع أوامر WP-CLI. - الجدولة بـ Cron حقيقي بدلا من الاعتماد على الزيارات، راجع WP-Cron.
قائمة ما بعد الاستيراد
- عدد المنتجات يطابق الملف
- التصنيفات صحيحة دون تكرار
- الخيارات تعرض الأسعار والمخزون الصحيح
- الصور مرفقة والصورة البارزة صحيحة
- الأوصاف محتفظة بتنسيقها
- البحث والفلاتر تعمل
- طلب تجريبي ينجح لمنتج بسيط ومنتج متغير
أخطاء شائعة
- وضع أسعار الخيارات في صف الأب.
- صفوف الخيارات قبل الأب.
- كتابات مختلفة لنفس القيمة (“XL” و”Xl”).
- الاستيراد دون SKU ثم إنشاء نسخ مكررة في التحديث التالي.
لديك كتالوج فوضوي تريد نقله إلى ووكومرس؟ تواصل معي.
الأسئلة الشائعة
ما صيغة CSV التي يستخدمها ووكومرس؟
ملف CSV بترميز UTF-8 فيه منتج أو خيار في كل صف، وأعمدة مثل Type وSKU وName وPublished وRegular price وCategories وImages وأعمدة الخصائص. والملف النموذجي لووكومرس يوضح الترويسات المطلوبة.
كيف أستورد المنتجات المتغيرة؟
أنشئ صفا للمنتج الأب بنوع variable مع قيم الخصائص كلها، ثم صفا لكل خيار بنوع variation وفيه SKU الأب في عمود Parent وقيمة الخاصية الخاصة بهذا الخيار.
هل يمكن تحديث المنتجات الحالية بملف CSV؟
نعم، فعل خيار تحديث المنتجات الحالية في أداة الاستيراد. تتم المطابقة بالـ ID أو SKU، ولا تحدث إلا الأعمدة الموجودة في الملف.
لماذا لا تستورد الصور؟
يجب أن تكون روابط الصور كاملة ومتاحة للعامة. سيرفرات الصور البطيئة أو المحجوبة والتحويلات والملفات الضخمة تسبب الفشل، والاستيراد على دفعات أصغر يساعد.
