استيراد المنتجات إلى WooCommerce بملف CSV وتصديرها دون تكرار

يستطيع WooCommerce (ووكومرس) استيراد المنتجات من ملف CSV بأداة الاستيراد المدمجة فيه، وتصديرها مرة أخرى لتعديلها في جدول بيانات. افتح Products > All Products، وانقر Import، واختر الملف، وراجع ربط الأعمدة، ثم شغّل الاستيراد. ولتجنب التكرار، أعطِ كل منتج رمز SKU، وفعّل Update existing products عندما تحدّث منتجات موجودة. روجعت المعلومات مقابل توثيق WooCommerce في أكتوبر 2026 (الإصدار WooCommerce 11.2).

كيف تستورد المنتجات من ملف CSV في WooCommerce

1. اذهب إلى Products > All Products وانقر Import بجوار Add new product.
2. انقر Choose File واختر ملف CSV أو TXT. ويضيف Show advanced options مسارًا على الخادم وفاصل CSV وترميز الأحرف.
3. فعّل Update existing products فقط عندما تغيّر منتجات موجودة أصلًا، ثم انقر Continue.
4. في Column mapping راجع كل عمود. ويتخطى Do not import العمود، وكذلك يفعل الاسم غير المعروف.
5. انقر Run the importer وأبقِ الصفحة مفتوحة حتى ينتهي.

توجد ملفات العينة الرسمية، مثل sample_products.csv، في مجلد sample-data ضمن مستودع WooCommerce. أما ملف CSV مصدَّر من متجرك أنت فهو قالب أفضل.

أعمدة CSV المهمة

المخطط الكامل في صفحة توثيق WooCommerce. وهذه الأعمدة تؤدي معظم العمل.

القيم المنطقية (booleans) تستخدم 1 و0، وتوضع القيمة التي تحتوي على فاصلة بين علامتي اقتباس مزدوجتين. وتستخدم الحقول المخصصة البادئة meta:، مثل meta:product_depth.

المنتجات المتغيرة: قاعدة الصف الرئيسي والصفوف الفرعية

يحتاج المنتج المتغير إلى صف رئيسي واحد وصف لكل متغير. وهذا المثال مأخوذ من التوثيق.

يسرد الصف الرئيسي كل القيم، ويذكر كل صف متغير قيمته وحدها فقط، ويجب أن يتطابق الإملاء. اترك ID فارغًا في صفوف المتغيرات وأعطِ كل صف رمز SKU فريدًا. واضبط Attribute 1 global على 1 فقط لسمة عامة موجودة بالفعل. وابتداءً من WooCommerce 11.1 يمكن لاستيراد واحد أن ينجز كل شيء بشرط أن يأتي الصف الرئيسي أولًا، وأن يكون Update existing products مفعّلًا، وأن يكون العمود SKU مربوطًا. وفي الإصدارات الأقدم، استورد الصف الرئيسي أولًا ثم المتغيرات. ويغطي دليلنا عن المنتجات المتغيرة جانب المنتج نفسه.

التحديث أم الإنشاء: كيف تعمل المطابقة

• منتجات جديدة: اترك ID فارغًا وأعطِ SKU فريدًا.
• التحديث: فعّل Update existing products. تُطابَق الصفوف بحسب ID أو SKU، ويُتخطى أي ID لا يطابق شيئًا. وابتداءً من WooCommerce 11.2 يمكن لعمود GTIN, UPC, EAN, or ISBN المربوط أن يطابق، لكن فقط عندما يكون ID وSKU كلاهما فارغين.
• غير مفعّل: لا تُحدَّث الصفوف التي تطابق منتجًا موجودًا. وفي الشيفرة المصدرية للإضافة تُتخطى هذه الصفوف برسالة مثل «A product with this SKU already exists.»

الطريق المعتاد إلى التكرار هو صف بلا ID وبلا SKU. فليس فيه ما يطابق به، وإذا كان الخيار غير مفعّل يصبح منتجًا جديدًا في كل مرة تستورد فيها الملف. ولا تُستخدم الأسماء في المطابقة أبدًا. أعطِ كل منتج رمز SKU، ثم تحقق من ذلك بالتجربة: استورد صفين، ثم استوردهما مرة أخرى مع تفعيل Update existing products، وتأكد أن عدد المنتجات لم يتغير. ولتغيير SKU، أبقِ ID في ذلك الصف واختبر صفًا واحدًا أولًا.

الصور والفئات والوسوم والنص العربي

الصور والفئات

ضع روابط الصور في العمود Images، مفصولة بفواصل. يستورد WooCommerce كل صورة يستطيع تنزيلها إلى مكتبة الوسائط (Media Library)، لكن بعض الاستضافات تحجب هذه التنزيلات. في هذه الحالة ارفع الصور أولًا. ولا يستطيع المستورد الأساسي (core importer) ضبط النص البديل للصور: راجع دليل WooCommerce لتحسين محركات البحث.

تستخدم الفئات > بين المستويات، وتُهرَّب الفاصلة داخل الاسم بشرطة مائلة عكسية (backslash)، كما في Places\, People\, Cities. وفي الشيفرة المصدرية للإضافة تُنشأ الفئات والوسوم المفقودة، لذا تصبح الفئة المكتوبة بإملاء خاطئ فئة جديدة: قارن القائمة بعد الاستيراد.

الترميز والنص العربي

يقول التوثيق إن الملف يجب أن يُحفظ بترميز UTF-8، وهو الترميز الذي يحتاجه النص العربي، وإن عليك فحص الملف المحفوظ، لأن برامج الجداول قد تغيّر التنسيق أو الترميز. في Excel ابحث عن خيار الحفظ المسمى CSV UTF-8 (Comma delimited)؛ وفي Google Sheets نزّل الملف بصيغة القيم المفصولة بفواصل (comma-separated values). ثم افتح ملف CSV في محرر نصوص عادي وتأكد أن العربية مقروءة.

تضم الخيارات المتقدمة قائمة منسدلة Character encoding of the file مضبوطة على Autodetect، وحقل CSV Delimiter. وبعض الإعدادات الإقليمية تجعل برامج الجداول تحفظ فواصل منقوطة بدل الفواصل، لذا تحقق من ذلك. أبقِ الأسعار والمخزون بالأرقام من 0 إلى 9 مع النقطة فاصلًا عشريًا، كما في أمثلة التوثيق. ولا يدير المستورد الترجمات: وإذا كان متجرك متعدد اللغات فاقرأ توثيق الاستيراد في إضافتك ودليلنا عن موقع WordPress بالعربية.

شغّل الاستيراد بأمان وأصلح الأخطاء الشائعة

سير عمل آمن

1. خذ نسخة احتياطية من قاعدة البيانات والملفات: راجع كيف تنسخ WordPress احتياطيًا.
2. استخدم نسخة تجريبية (staging) كما يشرح دليل تحديث WordPress وWooCommerce بأمان.
3. صدّر بضعة منتجات لترى أسماء الأعمدة بدقة، وابنِ ملفك على أساسها.
4. نظّف الملف: إملاء واحد لكل قيمة سمة، وبلا صيغ حسابية أو رموز عملات، وبصيغة CSV بترميز UTF-8.
5. استورد بضعة صفوف، تشمل منتجًا متغيرًا بصور وفئة متداخلة، ثم افحص لوحة الإدارة وواجهة المتجر.
6. استورد الصفوف نفسها مرة أخرى مع تفعيل Update existing products وتأكد أنه لا توجد تكرارات.
7. استورد الباقي، واقرأ تقرير الصفوف الفاشلة أو المتخطاة، وأصلحها، وأعد استيراد تلك الصفوف فقط.

في المتجر الحي، تستبدل أرقام المخزون في الملف المخزون الحالي، فتُفقد من العدّ الطلبات التي وردت منذ أن صدّرت الملف.

الملفات الكبيرة وانتهاء المهلة

يقول التوثيق إن الاستيراد الكبير يعتمد على ذاكرة الخادم وحدود الرفع ووقت المعالجة، وينصح بتقسيم ملف CSV إلى ملفات أصغر. ولا يذكر عدد صفوف محددًا، فابدأ بملف صغير. وتحدد استضافتك الحجم الأقصى (Maximum size) المعروض في شاشة الرفع. وفي الشيفرة المصدرية للإضافة يعمل المستورد على دفعات من 30 صفًا ويوقف الطلب بعد نحو 20 ثانية ثم يستأنف، لذا أبقِ الصفحة مفتوحة. وإذا رفض WordPress الملف، فارفعه إلى المجلد uploads عبر SFTP واستخدم خيار مسار الخادم.

الأخطاء الشائعة وحلولها

التصدير للتعديل المجمّع ولنقل المنتجات بين المتاجر

اذهب إلى Products > All Products وانقر Export. اختر Export all columns أو أعمدة محددة، وحدّد الأنواع والفئات، وفعّل Yes, export all custom meta عند الحاجة، ثم انقر Generate CSV. ولتصدير بضعة منتجات، حدّدها وانقر Export X selected.

وللتعديل المجمّع، غيّر الملف في جدول بيانات، وأبقِ ID أو SKU، ثم أعد استيراده مع تفعيل Update existing products. اربط الأعمدة التي غيّرتها فقط، واضبط الباقي على Do not import، وتحقق من صف واحد أولًا.

ولنقل المنتجات إلى متجر آخر، استورد ملف التصدير هناك. لا تنتقل المعرّفات (IDs)، فاعتمد على رموز SKU، ويجب أن تكون روابط الصور متاحة الوصول من المتجر الجديد. أنشئ السمات العامة أولًا. ويحمل ملف CSV حقول المنتجات فقط، وليس الطلبات أو العملاء أو التقييمات: ولنقل موقع كامل راجع نقل موقع WordPress إلى استضافة جديدة.

الأسئلة الشائعة

هل يمكنني استيراد منتجات بلا رمز SKU؟

المنتجات البسيطة نعم، لكن لا يمكن مطابقتها لاحقًا، فقد يؤدي الاستيراد مرة أخرى إلى تكرارات. أما المتغير الجديد فيحتاج إلى SKU أو إلى GTIN.

كيف أحدّث الأسعار فقط؟

جهّز ملفًا فيه ID أو SKU وأعمدة الأسعار، وفعّل Update existing products، واضبط بقية الأعمدة على Do not import.

هل يحذف المستورد المنتجات غير الموجودة في الملف؟

يصف التوثيق الإضافة والتحديث فقط. وتحذف المنتجات من قائمة المنتجات.

هل يمكنني جدولة الاستيراد من ملف بيانات المورّد؟

المستورد المدمج يدوي. وتحتاج الملفات الدورية (feeds) إلى إضافة أو شيفرة مخصصة: تحقق من دعمها لـ HPOS (تخزين الطلبات عالي الأداء)، كما يشرح دليلنا أفضل إضافات WooCommerce.

الخطوات التالية

جهّز بيانات منتجاتك مع دليل المنتجات المتغيرة، ثم اتبع سير العمل الآمن أعلاه. وبعد ذلك تصفّح إضافات WooCommerce في DevMarket بحثًا عمّا تحتاج إليه من إضافات أخرى.