أداة استيراد وتصدير المنتجات بصيغة CSV

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

العثور على أدوات الاستيراد والتصدير

انتقل إلى المنتجات > جميع المنتجات. ستظهر زرا استيراد وتصدير بجانب إضافة منتج جديد.

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

إنشاء ملف CSV الخاص بك

برامج CSV الموصى بها

نوصي باستخدام:

• Google Sheets
• Apache OpenOffice Calc
• LibreOffice Calc
• Numbers لنظام macOS

أيًا كان البرنامج الذي تستخدمه، احفظ الملف أو صدّره بتنسيق CSV بترميز UTF-8 واتبع الإرشادات العامة أدناه. يمكن لتطبيقات جداول البيانات تغيير التنسيق أو ترميز الأحرف، لذلك راجع ملف CSV المحفوظ قبل استيراده.

إنشاء ملف CSV للمنتجات

لاستيراد منتجات جديدة أو تحديث المنتجات الحالية، تحتاج إلى ملف CSV يحتوي على معلومات منتجاتك. يمكنك:

• تصدير ملف CSV للمنتجات من متجر موجود.
• تنزيل ملف CSV النموذجي للمنتجات من GitHub واستبدال القيم التجريبية بمعلومات منتجاتك.
• إنشاء ملف CSV خاص بك. استخدم التنسيق والأعمدة الموجودة في مخطط استيراد CSV للمنتجات.

الإرشادات العامة

• استخدم ترميز UTF-8.
• استخدم المنطقة الزمنية المحلية للمتجر عند إدخال التواريخ.
• استخدم 1 للقيمة الصحيحة و0 للقيمة الخاطئة عند استيراد القيم المنطقية (Boolean).
• افصل القيم المتعددة داخل الحقل باستخدام الفواصل.
  • راجع التعامل مع الفواصل أدناه عند استيراد أسماء الفئات التي تحتوي على فواصل.
• ضع القيمة بين علامتي اقتباس مزدوجتين إذا كانت تحتوي على فاصلة.
• أضف البادئة id: إلى المعرّف عند الإشارة إلى معرّف منتج موجود. لا تحتاج إلى بادئة عند الإشارة إلى SKU. على سبيل المثال: id:100، SKU101.
• استخدم > بين مستويات التسلسل الهرمي للتصنيفات، واستخدم الفواصل بين المصطلحات المنفصلة.
• يتحكم عمود Published في حالة المنتج. استخدم 1 للمنتشر، أو 0 للخاص، أو -1 للمسودة، أو 2 للمراجعة المعلقة.
• لا يمكنك تعيين معرّف منشور محدد لمنتج جديد أثناء الاستيراد. يستخدم WooCommerce المعرّف المتاح التالي، بغض النظر عن المعرّف الموجود في ملف CSV.

التعامل مع الفواصل

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

لاستيراد فئة واحدة باسم Places, People, Cities، قم بإلغاء تأثير الفواصل باستخدام الشرطة المائلة العكسية: Places\, People\, Cities.

تخبر الشرطات المائلة العكسية أداة الاستيراد بأن تتعامل مع الفواصل باعتبارها جزءًا من اسم الفئة.

الصور

• يجب أن تكون الصور مرفوعة مسبقًا أو متاحة عبر الإنترنت حتى يمكن استيرادها إلى متجرك.
• يمكنك استخدام روابط الصور الخارجية عندما تكون الصور قابلة للوصول إليها مباشرة. يقوم WooCommerce باستيراد هذه الصور إلى مكتبة الوسائط. أما الروابط الموجودة خلف برامج إعادة التوجيه، مثل بعض روابط التخزين السحابي، فلا يتم دعمها.
• يمكنك تحديد اسم الملف إذا كانت الصورة موجودة بالفعل في مكتبة الوسائط.
• لا يمكن لأداة استيراد CSV الأساسية إضافة أو تعديل أو تحديث النص البديل للصور الخاصة بالمنتجات.

الاستيراد

إضافة منتجات جديدة

استخدم أداة استيراد CSV لإضافة عدة منتجات من خلال عملية رفع واحدة.

1. انتقل إلى المنتجات > جميع المنتجات.
2. حدد استيراد في أعلى الصفحة لفتح شاشة رفع ملف CSV.

3. حدد اختيار ملف واختر ملف CSV أو TXT الذي تريد استيراده. أو افتح إظهار الخيارات المتقدمة وأدخل مسار ملف CSV الموجود بالفعل على الخادم.
4. حدد متابعة. يظل الزر غير متاح حتى تحدد ملفًا محليًا أو تدخل مسار ملف على الخادم.
5. راجع شاشة تعيين الأعمدة. يقوم WooCommerce تلقائيًا بتعيين أعمدة CSV المعروفة إلى حقول المنتجات.

6. استخدم القوائم المنسدلة لتعديل الحقول، أو اختر عدم الاستيراد لأي عمود يجب تجاهله.
7. لن يتم استيراد أي أعمدة غير معروفة بشكل افتراضي.
8. حدد تشغيل أداة الاستيراد.
9. انتظر حتى يكتمل الاستيراد. لا تقم بتحديث الصفحة أو الانتقال منها أثناء عملية الاستيراد.

اكتمل استيراد المنتجات.

تحديث المنتجات الحالية

استخدم أداة استيراد CSV لتحديث المنتجات الحالية بشكل جماعي، مثل إضافة علامة تجارية، أو تغيير فئة ضريبية، أو إعداد تخفيض، أو مزامنة بيانات المنتجات بين المتاجر. تستخدم أداة الاستيراد معرّفات المنتجات أو رموز SKU الموجودة في ملف CSV لمطابقة المنتجات الحالية.

1. أنشئ ملف CSV كما هو موضح في قسم إنشاء ملف CSV الخاص بك، باستخدام معرّفات المنتجات أو رموز SKU للمنتجات التي تريد تحديثها.
2. انتقل إلى المنتجات > جميع المنتجات.
3. حدد استيراد في أعلى الصفحة.
4. حدد اختيار ملف واختر ملف CSV الخاص بك.
5. حدد تحديث المنتجات الحالية. سيتم تحديث المنتجات الحالية التي تتطابق حسب المعرّف أو SKU، بينما يتم تخطي المنتجات غير الموجودة.
6. حدد متابعة وراجع شاشة تعيين الأعمدة.
7. استخدم القوائم المنسدلة لتعديل الحقول أو اختر عدم الاستيراد لأي عمود يجب تجاهله.
8. حدد تشغيل أداة الاستيراد.
9. انتظر حتى يكتمل التحديث. لا تقم بتحديث الصفحة أو الانتقال منها أثناء عملية التحديث.

اكتمل تحديث المنتجات.

ملاحظة: بدءًا من WooCommerce 11.1، لا يتم دائمًا تخطي صف المتغير الذي لا يتطابق مع منتج موجود أثناء عملية تحديث الاستيراد. إذا كان عمود Parent الخاص به يتطابق مع منتج متغير موجود، وكان الصف يتضمن SKU (أو GTIN أو UPC أو EAN أو ISBN إذا كان ملف CSV يقوم بتعيين أحدها) بالإضافة إلى سمات وقيم موجودة بالفعل في المنتج الأب، فسيقوم WooCommerce بإنشائه كمتغير جديد بدلًا من ذلك. أما الصف الذي يفتقد أيًا من هذه العناصر فسيتم تخطيه، كما كان يحدث في الإصدارات السابقة. راجع إضافة المتغيرات أثناء تحديث منتج متغير للاطلاع على الشروط الكاملة.

استكشاف أخطاء الاستيراد الفاشل أو المتخطى وإصلاحها

إذا اكتملت عملية الاستيراد ولكن بعض المنتجات مفقودة أو تم تخطيها، فتحقق أولًا من سجل الاستيراد. تشمل الأسباب الشائعة:

• يوجد منتج بالفعل بنفس SKU أو المعرّف، ولم يتم تحديد تحديث المنتجات الحالية.
• يستخدم ملف CSV أعمدة أو قيمًا لا تتطابق مع مخطط استيراد CSV للمنتجات.
• تحدد قيمة Published حالة غير متوقعة للمنتج. راجع صف Published في المخطط لمعرفة القيم المدعومة، بما في ذلك المراجعة المعلقة.
• يوجد تعارض بين إضافة أو قالب يتسبب في تعطيل عملية الاستيراد.
• ملف CSV كبير جدًا بحيث لا يستطيع الخادم معالجته في طلب واحد. قم بتقسيم ملفات CSV الكبيرة إلى دفعات أصغر واستورد كل دفعة بشكل منفصل.

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

قد يحدد WordPress نوع الملف بشكل غير صحيح ويعرض الرسالة عذرًا، هذا النوع من الملفات غير مسموح به لأسباب أمنية. يمكن أن يحدث ذلك على بعض الخوادم عندما يحتوي ملف CSV على HTML.

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

إذا فشل خيار مسار الخادم أيضًا، فاطلب من شركة الاستضافة التحقق من أنواع الملفات المسموح بها وإعدادات رفع الملفات في الموقع.

استيراد كتالوجات المنتجات الكبيرة

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

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

بالنسبة لعمليات الاستيراد الكبيرة أو بيانات المنتجات المخصصة من الإضافات، يمكنك التفكير في استخدام Product CSV Import Suite.

تحويل منتج بسيط موجود إلى منتج متغير

يمكنك استخدام أداة استيراد CSV لتحويل منتج بسيط موجود إلى منتج متغير. بدءًا من WooCommerce 11.1، يمكنك القيام بذلك من خلال عملية استيراد واحدة إذا كان صف المنتج الأب يأتي قبل صفوف المتغيرات الخاصة به في ملف CSV. في إصدار أقدم، أو إذا لم تتمكن من ضمان ترتيب الصفوف، استخدم عمليتي استيراد بدلًا من ذلك: الأولى لتحديث المنتج الحالي إلى منتج متغير مع السمات، والثانية لإضافة صفوف المتغيرات كمنتجات جديدة.

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

1. افتح ملف CSV المُصدّر باستخدام محرر CSV.
2. احتفظ بصف المنتج الحالي كما هو، وأضف صفًا جديدًا لكل متغير.
3. في صف المنتج الأب، غيّر قيمة Type من simple إلى variable.
4. في كل صف من صفوف المتغيرات، اضبط قيمة Type على variation.
5. امنح كل صف متغير SKU واسمًا فريدين.
6. أضف أعمدة السمات المطلوبة للمنتج المتغير. بالنسبة إلى سمة محلية باسم Size، أضف Attribute 1 name وAttribute 1 value(s) وAttribute 1 visible وAttribute 1 global.
7. في صف المنتج الأب، أدرج جميع القيم المتاحة في Attribute 1 value(s)، مثل S, M. وفي كل صف متغير، أدخل فقط القيمة الخاصة بهذا المتغير، مثل S أو M.
8. اضبط Attribute 1 visible على 1. واضبط Attribute 1 global على 0 للسمة المحلية للمنتج، أو 1 إذا كانت السمة سمة عامة تم إعدادها مسبقًا في متجرك.
9. في كل صف متغير، اضبط قيمة Parent على SKU أو معرّف المنتج الأب.

بعد تعديل ملف CSV، احفظه كملف CSV جديد.

إذا كان صف المنتج الأب يأتي قبل صفوف المتغيرات الخاصة به في ملف CSV، فقم بتشغيل عملية استيراد واحدة مع تحديد تحديث المنتجات الحالية. سيقوم WooCommerce بتحديث المنتج الحالي ليصبح منتجًا متغيرًا وإنشاء المتغيرات الجديدة في عملية الاستيراد نفسها، بشرط أن يحتوي كل صف متغير على SKU فريد (أو GTIN أو UPC أو EAN أو ISBN معيّن في الملف) وأن تتطابق قيمة Parent الخاصة به مع المنتج الأب.

إذا لم تتمكن من ضمان ترتيب الصفوف، أو كنت تستخدم إصدارًا أقدم من WooCommerce 11.1، فقم بإجراء عمليتي استيراد بدلًا من ذلك:

1. أولًا، استورد ملف CSV مع تحديد تحديث المنتجات الحالية. يؤدي ذلك إلى تحديث المنتج الحالي ليصبح منتجًا متغيرًا وإضافة بيانات السمات. سيتم تخطي صفوف المتغيرات التي لا توجد بالفعل أثناء عملية التحديث.
2. افتح ملف CSV مرة أخرى، واحذف صف المنتج الأب، واترك صفوف المتغيرات كما هي.
3. استورد ملف CSV الذي يحتوي على المتغيرات فقط مع إلغاء تحديد تحديث المنتجات الحالية. سيؤدي ذلك إلى إنشاء المتغيرات وربطها بالمنتج الأب.
4. بعد استخدام أي من الطريقتين، افتح المنتج وتأكد من أنه أصبح منتجًا متغيرًا ويحتوي على المتغيرات المطلوبة.

إذا لم يتم إنشاء المتغيرات، فتحقق من أن لكل متغير SKU فريدًا، وأن قيمة Parent تتطابق مع SKU المنتج الأب أو معرّف بتنسيق id:123، وأن أعمدة السمات تتطابق مع القيم المستخدمة في المنتج الأب. إذا استخدمت طريقة الاستيراد الواحد ولم يتم إنشاء أي متغيرات، فتحقق أيضًا من أن صف المنتج الأب يظهر قبل صفوف المتغيرات الخاصة به في ملف CSV.

إعداد ملف CSV من المورد للمنتجات المتغيرة

غالبًا ما تستخدم ملفات الموردين أسماء أعمدة ومعرّفات وتنسيقات سمات مختلفة عن تلك التي يتوقعها WooCommerce. قم بتوحيد تنسيق الملف قبل استيراده، واختبر عينة صغيرة قبل استيراد الكتالوج بالكامل.

1. حدد ما إذا كنت تنشئ منتجات جديدة أو تقوم بتحديث منتجات موجودة. بالنسبة للتحديثات، صدّر أولًا بعض المنتجات الموجودة واستخدم ملف التصدير للتأكد من أسماء الأعمدة والمعرّفات الموجودة في ملف المورد.
2. اختر معرّفًا ثابتًا لكل منتج أب، مثل SKU أو معرّف المنتج. امنح كل متغير SKU فريدًا، واستخدم معرّف المنتج الأب نفسه في كل صف من صفوف المتغيرات.
3. وحّد عناوين الأعمدة وقيم السمات الخاصة بالمورد قبل استيراد الملف. أزل المسافات الزائدة في بداية ونهاية القيم، واستخدم أسلوب كتابة أحرف موحدًا لكل قيمة، وقم بتوحيد المرادفات في قيمة واحدة. على سبيل المثال، حوّل L وl وLarge إلى قيمة واحدة تريد استخدامها، مثل Large. حافظ على تطابق كتابة اسم السمة وقيمتها في صفوف المنتج الأب والمتغيرات.
4. جهّز صفًا واحدًا للمنتج الأب مع ضبط Type على variable، وSKU أو ID الخاص بالمنتج الأب، ومجموعة قيم السمات الكاملة. أضف صفًا فرعيًا لكل متغير مع ضبط Type على variation، وSKU فريد، وقيمة المنتج الأب في Parent، وقيمة السمة المطابقة. بالنسبة إلى السمة المحلية، حافظ على اتساق Attribute 1 name وAttribute 1 value(s) وAttribute 1 visible وAttribute 1 global بين صفوف المنتج الأب والمتغيرات. استخدم أسماء الأعمدة الدقيقة من مخطط استيراد CSV للمنتجات.
5. احذف الأعمدة الخاصة بالمورد فقط، والصيغ، ورموز العملات، والمسافات الزائدة، والتنسيقات غير المدعومة. احفظ الملف المنظف بتنسيق CSV وترميز UTF-8. تقوم أداة الاستيراد المدمجة بتعيين حقول المنتجات المعروفة والأعمدة التي تبدأ بالبادئة meta:. أما الحقول الخاصة بالإضافات فتتطلب الرجوع إلى وثائق الإضافة المعنية، مثل إرشادات Product CSV Import Suite الخاصة بالمتغيرات.
6. أنشئ نسخة احتياطية من المتجر، ثم اختبر عملية الاستيراد باستخدام منتج أب واحد وعدة متغيرات على موقع تجريبي. راجع نتائج الاستيراد وافتح المنتج الأب للتأكد من صحة المتغيرات والسمات والأسعار والمخزون والصور قبل استيراد بقية الصفوف.
7. عندما تتطلب العملية ملفات منفصلة للمنتجات الأب والمتغيرات، اتبع طريقة الاستيراد على مرحلتين: استورد أو حدّث المنتج الأب أولًا، ثم استورد صفوف المتغيرات. بالنسبة لعمليات الاستيراد المتكررة، احتفظ بالمعرّفات أو رموز SKU الثابتة. عند تحديد تحديث المنتجات الحالية، يتم تحديث المعرّفات أو رموز SKU المتطابقة، ويتم تخطي الصفوف التي لا تتطابق مع المعرّفات أو رموز SKU. وعند إلغاء تحديدها، يتم تخطي الصفوف التي توجد معرّفاتها أو رموز SKU الخاصة بها بالفعل.

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

التصدير

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

1. انتقل إلى المنتجات > جميع المنتجات.
2. حدد تصدير في أعلى الصفحة لفتح شاشة تصدير المنتجات.

3. اختر الأعمدة التي تريد تصديرها، أو اترك الخيار الافتراضي تصدير جميع الأعمدة محددًا.
4. اختر أنواع المنتجات وفئات المنتجات التي تريد تصديرها، أو اترك الخيارات الافتراضية لتصدير جميع المنتجات والفئات.
5. حدد نعم، تصدير جميع البيانات الوصفية المخصصة إذا كنت بحاجة إلى البيانات الوصفية للمنتجات من WooCommerce أو الإضافات الأخرى. تستخدم أعمدة البيانات الوصفية البادئة meta:. على سبيل المثال، يتم تصدير البيانات الوصفية المخزنة بالمفتاح product_depth كـ meta:product_depth.
6. حدد إنشاء CSV وانتظر حتى تكتمل عملية التصدير.

سيقوم متصفحك بتنزيل ملف CSV المُصدّر.

أسماء المتغيرات في ملفات التصدير

قد يستبعد WooCommerce قيم السمات من أسماء المتغيرات في ملفات CSV المُصدّرة. وهذا أمر متوقع عندما يحتوي المنتج على ثلاث سمات أو أكثر، أو عندما يحتوي على سمتين أو أكثر وكان اسم إحدى السمات يتكون من كلمتين أو أكثر.

يتطلب تغيير هذا السلوك استخدام كود مخصص مع عامل التصفية woocommerce_product_variation_title_include_attributes. وتُعد التخصيصات من أعمال مستوى المطور ولا يغطيها سياسة دعم WooCommerce.

تصدير منتجات محددة

يمكنك تصدير المنتجات المحددة مباشرة من قائمة المنتجات.

1. انتقل إلى المنتجات > جميع المنتجات.
2. حدد المنتجات التي تريد تصديرها.
3. حدد تصدير X من المنتجات المحددة في أعلى الصفحة. ويعرض نص الزر عدد المنتجات المحددة.

مخطط استيراد CSV للمنتجات

تستخدم أدوات WooCommerce المدمجة لاستيراد وتصدير CSV المخطط التالي. يمكنك أيضًا عرض المخطط على GitHub.

الأعمدة والبيانات الوصفية المخصصة

تقوم أداة الاستيراد المدمجة بتعيين أعمدة المخطط المعروفة وأعمدة البيانات الوصفية للمنتجات. ولا يتم استيراد أي أعمدة غير معروفة بشكل افتراضي.

لاستيراد البيانات الوصفية المخصصة للمنتجات، أضف البادئة meta: إلى عنوان عمود CSV. على سبيل المثال، استخدم meta:product_depth لحقل مخصص مخزن بالمفتاح product_depth. إذا لم يقم WooCommerce بتعيين العمود تلقائيًا، فقم بتعيينه إلى استيراد كبيانات وصفية من شاشة تعيين الأعمدة.

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

الأسئلة والدعم

هل لا تزال لديك أسئلة وتحتاج إلى مساعدة؟

• إذا كنت تبحث عن توسيع الوظائف الأساسية الموضحة هنا، فنوصي بمراجعة الإضافات المتاحة في WooCommerce Marketplace.
• هل تحتاج إلى دعم متقدم مستمر أو إلى تنفيذ تخصيص لـ WooCommerce؟ يمكنك الاستعانة بـ Woo Agency Partner.
• هل أنت مطور تقوم بإنشاء تكامل أو إضافة خاصة بـ WooCommerce؟ راجع موارد المطورين.