حافظ على تزامن كتالوج WooCommerce متعدد اللغات عندما تصل المنتجات عن طريق استيراد CSV أو WP All Import أو REST API أو مزامنة ERP.
تم التحديث في: 16 نوفمبر 2026
هذا الدليل مخصص للمتاجر التي يوجد الكتالوج الخاص بها خارج WordPress: في جدول بيانات أو PIM أو ERP أو موجز مورد. تصل المنتجات إلى WooCommerce عن طريق أداة استيراد أو REST API أو مهمة مجدولة، ونادراً ما تفتح محرر المنتجات.
الجزء 1. كيف يعمل المتجر متعدد اللغات المدار من الخارج
منتج واحد لكل لغة، مرتبط بمجموعة ترجمة
لكل لغة منتج WooCommerce الخاص بها، بمعرف (ID) خاص بها. يربط WPML اللغات في مجموعة ترجمة. الأصل هو المنتج باللغة الافتراضية لمتجرك؛ واللغات الأخرى هي ترجماته.
في متجرنا التجريبي، يكون منتج Zip-Up Hoodie هو المنتج رقم 14 باللغة الإنجليزية، و121 باللغة الألمانية، و122 باللغة الفرنسية. تحمل كل إجابة REST API لأي منها نفس الخريطة: "translations": {"de":"121","en":"14","fr":"122"}.
رمز SKU هو نفسه في كل لغة. تحتفظ اختلافات المنتج المتغير بنفس رموز SKU للاختلافات أيضاً.
رمز SKU هو المفتاح لنظامك الخارجي. يُرجع بحث WooCommerce الخاص، wc_get_product_id_by_sku()، المنتج الأصلي، وليس ترجمة.
تُرجع القوائم لغة واحدة في كل مرة. تُرجع GET /wc/v3/products?sku=HP-HD-ZIP اللغة الافتراضية فقط. أضف &lang=de للغة واحدة، أو &lang=all لكل لغة.
ما ينسخه WPML إلى كل لغة وما يترجمه
عندما يتغير المنتج الأصلي، من خلال محرر المنتجات أو استيراد CSV أو REST API، ينسخ WPML هذه القيم إلى كل ترجمة:
السعر العادي وسعر التخفيض
كمية المخزون وحالة المخزون
رمز SKU والوزن والأبعاد
صورة المنتج ومعرض الصور (تحصل كل لغة على نسختها الخاصة من الصورة)
التصنيفات والوسوم (كالتصنيف أو الوسم المترجم)
المنتجات الموصى بها ومنتجات التسويق المتقاطع (تشير إلى المنتج بنفس اللغة)
حالة النشر
للمنتجات المتغيرة: سعر ومخزون كل اختلاف، ونطاق السعر، ومصطلح سمة عام جديد (كترجمته، على سبيل المثال Schwarz وNoir لـ Black) واختلاف جديد
تظل هذه العناصر مختلفة في كل لغة، لأنها تُترجم:
الاسم والوصف والوصف القصير
المعرّف النصي للرابط (عنوان المنتج، على سبيل المثال /de/produkt/kapuzenjacke-mit-reissverschluss/)
مصطلحات السمات، مثل Blue وBlau وBleu
قيم السمات الخاصة بالمنتج، مثل "Material" المعينة فقط على هذا المنتج
المخزون مشترك بين جميع اللغات.
اكتب الأسعار والسمات في الأصل. إذا كتب نظامك سعراً أو سمات في ترجمة، فستحتفظ الترجمة بقيم الأصل. يصبح المخزون المكتوب في أي لغة هو مخزون كل لغة، لأنه مشترك.
الأسعار بعملة ثانية تتبع الأصل أيضاً (راجع تعدد العملات لـ WooCommerce). عيّنها في الأصل، باستخدام custom_prices في REST API ("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}}) أو باستخدام أعمدة CSV التالية Meta: _wcml_custom_prices_status وMeta: _regular_price_USD وMeta: _sale_price_USD وMeta: _price_USD. ستعرض كل لغة بعد ذلك هذه الأسعار بتلك العملة.
يتم تخزين custom_prices عندما يكون تعدد العملات قيد التشغيل وتكون العملة إحدى عملات متجرك. أرسلها على النحو التالي:
شغّل تعدد العملات أولاً. اذهب إلى WPML ← إعدادات ← تعدد العملات، وحدد Enable the multicurrency mode وانقر على احفظ التغييرات. ضمن Show currencies based on، اختر خياراً (على سبيل المثال Site Language) وانقر على احفظ التغييرات. ثم أضف كل عملة باستخدام Add currency. مع إيقاف تشغيل تعدد العملات، لا يخزن WPML أي شيء من custom_prices.
استخدم رموز عملات متجرك. يخزن WPML أسعار عملات المتجر فقط. لا يتم تخزين أي سعر برمز آخر.
للمنتج المتغير، أرسل custom_prices على كل اختلاف، وليس على المنتج الأب. يخزنه WPML على الاختلاف الأصلي، وتعرضه كل لغة. إذا تم إرساله على المنتج الأب، فلن يتم تخزينه.
اقرأ الأسعار المخزنة من meta_data (_regular_price_USD و_sale_price_USD و_price_USD). لا تتضمن الإجابات على استدعاءات REST حقلاً باسم custom_prices.
نسخ مكررة أو ترجمات مستقلة
يحتوي WPML على نوعين من المنتجات المترجمة. يحدد النوع الذي لديك ما يحدث للنص الذي تستورده.
نسخة مكررة
ترجمة مستقلة
ما هي
نسخة يحافظ عليها WPML
ترجمة بنصها الخاص
النص بعد الحفظ التالي للأصل
يُستبدل بنص الأصل
يُحتفظ به فقط مع إيقاف تشغيل ترجم كل شيء أو مع تعيين Products إلى None
السعر والمخزون
يتبعان الأصل
يتبعان الأصل
أين تجد ذلك: يعرض مربع اللغة للنسخة المكررة النص «هذا المستند هو نسخة مكررة من ... وتتم إدارته بواسطة WPML.» مع زر الترجمة بشكل مستقل.
تحويل النسخ المكررة إلى ترجمات مستقلة: انقر على الترجمة بشكل مستقل في مربع اللغة للنسخة المكررة، أو، للعديد من المنتجات، اذهب إلى المنتجات ← جميع المنتجات، وبدّل إلى لغة الترجمة، وحدد المنتجات ثم اختر إجراءات مجمعة ← الترجمة بشكل مستقل.
ما تُنشئه العمليات في الجزء 2: تُنشئ العملية A ترجمات باستخدام ترجم كل شيء. وتستورد العملية B ترجمات مستقلة. ولا تحتاج أي منهما إلى نسخ مكررة.
إعداد المتجر قبل وصول المنتج الأول
شغّل معالج إعداد WooCommerce Multilingual. يُفتح المعالج عند تفعيل WPML Multilingual & Multicurrency for WooCommerce. شاشاته هي صفحات المتجر، والسمات العامة، وعملات متعددة. تُنشئ الشاشة الأولى صفحات المتجر، وسلة التسوق، وإتمام الشراء، وحسابي بكل لغة.
اجعل سماتك العامة قابلة للترجمة. في شاشة المعالج «أي سمات المنتج يجب أن تكون قابلة للترجمة؟»، حدد كل سمة، على سبيل المثال اللون والمقاس. لاحقاً، الإعداد نفسه هو مربع الاختيار قابل للترجمة؟ تحت المنتجات ← السمات ← تعديل.
ترجم مصطلحات السمات قبل المنتجات. اذهب إلى WPML ← الترجمات، وافتح علامة التبويب التصنيف، واختر السمة تحت «حدد التصنيف لترجمته» وترجم كل مصطلح. عند تفعيل ترجم كل شيء (العملية A)، تترجم WPML المصطلحات الجديدة نيابةً عنك.
تضع WPML علامة على الترجمة بأنها تحتاج إلى تحديث؛ ويجلب ملفك التالي النص الجديد
الأسعار والمخزون
تتبع المنتج الأصلي
تتبع المنتج الأصلي
تناسب العملية A متجراً يحتفظ بلغة واحدة ويريد كل لغة أخرى بدون ملفات ترجمة. بينما تناسب العملية B متجراً يحتوي نظامه لإدارة معلومات المنتج (PIM) أو مترجموه بالفعل على النصوص بكل لغة.
العملية A مع أداة استيراد CSV في WooCommerce أو WP All Import
شغّل ترجم كل شيء مرة واحدة:
اذهب إلىWPML ← الترجمات وانقر على أعدّ ترجم كل شيء.
اختر المحتوى. تحت «المحتوى المراد ترجمته»، أبقِ على جميع المنتجات وانقر على متابعة.
اختر كيفية نشر الترجمات. تحت «طريقة النشر»، أبقِ على نشر بدون مراجعة.
انقر على تمكين ترجم كل شيء تلقائيًا.
استورد منتجاتك باللغة الافتراضية للمتجر فقط. استخدم المنتجات ← استيراد (أداة استيراد CSV في WooCommerce) أو All Import ← New Import (إضافة WP All Import مع ملحق WooCommerce الخاص بها). لا يحتاج ملفك إلى أي أعمدة خاصة بـ WPML.
تضع عملية الاستيراد نفسها الترجمات في قائمة الانتظار. ثم تترجم WPML كل منتج، ومتغير، وتصنيف، ومصطلح سمة جديد إلى كل لغة وتنشرها. لا تبدأ أي شيء يدوياً، ولا يلزم فتح أي صفحة من صفحات لوحة تحكم WPML. يمكنك متابعة التقدم تحت WPML ← الترجمات.
عندما تعدّل منتجاً أصلياً، تترجم ميزة ترجم كل شيء ما تغير فقط. ويبقى باقي الترجمة حرفياً كما هو.
تترجم ميزة ترجم كل شيء المنتجات المنشورة، بما في ذلك المنتجات الخارجية. ولا تترجم المنتجات الخاصة. وتنتظر المسودات أيضاً: يكون الخيار ترجمة المسودات تلقائياً (تحت WPML ← إعدادات ← ترجمة AI، في مربع محرر الترجمة المتقدم) متوقفاً بشكل افتراضي، وعند تشغيله، تترجم WPML المسودة فقط عند حفظها مرة أخرى. لترجمة المسودات والمنتجات الخاصة، أرسلها من WPML ← الترجمات (انظر قسم استكشاف الأخطاء وإصلاحها).
إذا كنت تريد تغيير ترجمة، افتحها من مربع اللغة الخاص بالمنتج (تعديل الترجمة ...)، وعدّلها في محرر الترجمة المتقدم وانقر على حفظ واكتمال. عندما يتغير المنتج الأصلي لاحقاً، يبقى تعديلك للجمل التي لم تتغير كما هو.
العملية B مع أداة استيراد CSV في WooCommerce
في العملية B، يحمل ملفك كل لغة.
اضبط ميزة ترجم كل شيء للترجمات المستوردة قبل الاستيراد الأول:
اذهب إلىWPML ← الترجمات. إذا كانت ميزة ترجم كل شيء متوقفة، فاتركها متوقفة وانتقل إلى الملف.
إذا كنت تريد أن تترجم WPML صفحاتك، ومقالاتك، وسلاسلك النصية تلقائياً، انقر على أعدّ ترجم كل شيء. تحت «المحتوى المراد ترجمته»، اضبط المنتجات على لا شيء. انقر على متابعة، وأبقِ على نشر بدون مراجعة وانقر على تمكين ترجم كل شيء تلقائيًا.
إذا كانت ميزة ترجم كل شيء قيد التشغيل بالفعل، انقر على قائمة النقاط الثلاث في مربع «ترجم كل شيء تلقائيًا ممكّنة»، واختر ضبط حدود المحتوى، واضبط المنتجات على لا شيء وانقر على احفظ التغييرات. ستكتمل الترجمات التي قيد التقدم بالفعل.
مع ضبط المنتجات على لا شيء، تحتفظ WPML بترجمات منتجاتك المستوردة حرفياً. وعندما يتغير منتج أصلي، تضع WPML علامة على ترجماته بأنها تحتاج إلى تحديث، ويجلب ملفك التالي النص الجديد.
جهّز ملفاً واحداً بجميع اللغات. استخدم أعمدة WooCommerce العادية وأضف أربعة أعمدة خاصة بـ WPML:
العمود
ما يحتويه
مثال
Meta: _wpml_import_translation_group
القيمة التي تربط اللغات. استخدم رمز SKU.
HP-JK-SHELL
Meta: _wpml_import_language_code
لغة الصف
de
Meta: _wpml_import_source_language_code
لغة المنتج الأصلي، وهي اللغة الافتراضية للمتجر. يكون فارغاً في صفوف المنتجات الأصلية.
en
Meta: _wpml_import_after_process_post_status
الحالة بعد أن تربط WPML المنتجات
publish
رتّب الصفوف حسب اللغة، مع وضع المنتجات الأصلية أولاً. وفي كل لغة، تأتي المنتجات قبل متغيراتها.
استورد المنتجات كمسودات:Published = -1 في المنتجات، و1 في المتغيرات.
امنح كل لغة نصوصها الخاصة: الأسماء، والأوصاف، والتصنيفات (Kleidung > Jacken) وقيم السمات (Blau, Grün).
احتفظ بأسماء سمات المتجر (Color، Size) في كل لغة. ترجم تسميات السمات تحت WPML ← الترجمات ← التصنيف.
عيّن المنتجات ذات الصلة والمنتجات الأب برمز SKU، باستخدام رمز SKU نفسه في كل لغة.
صف ألماني لمنتج متعدد الأنواع من ملف المثال الخاص بنا:
اذهب إلىالمنتجات ← استيراد واختر الملف أسفل «اختيار ملف CSV من جهاز الكمبيوتر الخاص بك:». اترك خيار تحديث المنتجات الحالية بدون تحديد. انقر على متابعة.
تحقق من التعيين. يتم تعيين أعمدة Meta: الأربعة إلى استيراد كبيانات وصفية. انقر على تشغيل المستورد.
اذهب إلىWPML ← تصدير واستيراد WPML. تقرأ الشاشة «عمل رائع. نرى 33 مقالة تم استيرادها وتحتاج إلى معلومات اللغة.». انقر على تشغيل استيراد WPML.
انتظر حتى ظهور «اكتمل الاستيراد متعدد اللغات».
حتى الخطوة 3، يكون كل منتج عبارة عن مسودة باللغة الإنجليزية وكل نوع عبارة عن نوع باللغة الإنجليزية، ولا يرتبط أي منها بنسخته الأصلية. بعد ذلك:
يتم ربط كل منتج وكل نوع عبر لغاته.
يتم نشر كل شيء.
تكون الترجمات ترجمات مستقلة.
يتم ربط التصنيفات وعناصر السمات عبر اللغات، وتستخدم أنواع كل لغة عناصرها الخاصة.
تشير مبيعات الارتقاء إلى المنتج بنفس اللغة، ولكل لغة نسختها الخاصة من الصور.
تنتقل التصنيفات وعناصر السمات داخل صفوف المنتجات، لذلك لا يحتاج هذا المستورد إلى استيراد تصنيف منفصل. إذا كانت عناصر السمات المترجمة موجودة بالفعل في المتجر، فإن المستورد يستخدمها، ويربطها تشغيل استيراد WPML بنسخها الأصلية.
لجعل WPML يترجم المنتجات المختارة تلقائياً بينما يتم تعيين المنتجات على لا شيء:
أبقِ ترجم كل شيء قيد التشغيل.
أضف العمود Meta: _wpml_import_tea إلى الملف، مع القيمة 1 في كل منتج تريد ترجمته.
احتفظ بـ Meta: _wpml_import_translation_group في نفس الملف.
استورد الملف، ثم اذهب إلى WPML ← تصدير واستيراد WPML وانقر على تشغيل استيراد WPML. تعرض قائمة التقدم «إرسال المقالات للترجمة التلقائية»، ويقوم WPML بترجمة ونشر هذه المنتجات.
العملية ب باستخدام WP All Import
أنت بحاجة إلى WP All Import Pro وملحق WooCommerce الخاص به. لا تستورد النسخة المجانية الحقول المخصصة، وأعمدة WPML هي حقول مخصصة.
ترتيب العمل هو: عناصر السمات أولاً، مع ربط ترجماتها، ثم المنتجات. تقدم صفحات المنتجات المترجمة بعد ذلك كل قيمة سمة بلغتها الخاصة، على سبيل المثال Bleu marine وليس Navy.
اربط العناصر المترجمة الموجودة في المتجر بالفعل. لكل عنصر سمة مترجم موجود بالفعل في المتجر، اذهب إلى المنتجات ← السمات، وانقر على تكوين العناصر للسمة، وبدّل شريط الإدارة إلى لغة العنصر وانقر على اسم العنصر. في مربع اللغة، اختر نسخته الأصلية أسفل هذه ترجمة لـ وانقر على تحديث. يعرض كل عنصر متصل بعد ذلك أيقونة قلم رصاص أسفل لغته في WPML ← الترجمات ← التصنيف.
اضبط لغة لوحة التحكم على اللغة الافتراضية للمتجر في مبدل اللغة بشريط الإدارة قبل تشغيل عمليات الاستيراد.
استورد التصنيفات. من All Import ← New Import ← Upload a file، اختر التصنيفات ← تصنيفات المنتجات. أسفل بيانات المصطلح الوصفية، أضف ثلاثة صفوف: _wpml_import_language_code و_wpml_import_source_language_code و_wpml_import_translation_group، كل منها معين إلى عمود الملف الذي يحمل نفس الاسم. اضبط الأصل أسفل Other Category Options ← Parent Term.
استورد عناصر السمات بنفس الطريقة، على سبيل المثال التصنيفات ← Product Color، مع نفس صفوف بيانات المصطلح الوصفية الثلاثة.
اربط العناصر. اذهب إلى WPML ← تصدير واستيراد WPML وانقر على تشغيل استيراد WPML. تحقق أسفل WPML ← الترجمات ← التصنيف (اختر التصنيف في «حدد التصنيف لترجمته») من أن كل عنصر له صف واحد مع أيقونة قلم رصاص أسفل علم كل لغة. مرر مؤشر الماوس فوق أيقونة القلم الرصاص لرؤية الاسم المترجم. تعني علامة "+" أن هذه اللغة ليس لها ترجمة. العنصر المترجم المدرج في صفه الخاص غير متصل.
استورد المنتجات. اختر WooCommerce Products. في قسم WooCommerce Add-On، قم بتعيين رمز SKU والأسعار والمخزون والسمات. أسفل حقول مخصصة، أضف صفوف _wpml_import_* الثلاثة.
شغّل استيراد WPML مرة أخرى، وانتظر حتى ظهور اكتمل الاستيراد متعدد اللغات.
تحمل صفوف الأنواع النوع variable، تماماً مثل الأصل، في العمود الذي تقوم بتعيينه إلى Set Product Type With XPath.
اربط الأنواع بأصلها باستخدام مفتاح لكل لغة. أسفل Variations، اختر All my variable products have SKUs or some other unique identifier... وقم بتعيين SKU element for parent و Parent SKU element for variation إلى مفتاح مثل HP-OW-RAIN-de. قم بتعيين رمز SKU الحقيقي، وهو نفسه في كل لغة، إلى عام ← رمز SKU وإلى مجموعة الترجمة. الطريقة الأخرى هي استيراد واحد لكل ملف لغة.
يعمل هذا الترتيب سواء بدأت عمليات استيراد WP All Import من wp-admin أو من WP-CLI أو وفقاً لجدول زمني.
تحديث المخزون والأسعار وفقاً لجدول زمني
قم بتحديث المنتجات الأصلية. ينسخ WPML المخزون والأسعار إلى كل لغة على الفور.
باستخدام مستورد CSV الخاص بـ WooCommerce:
أرسل فقط الأعمدة التي تقوم بتغييرها. يكتب العمود الذي يحتوي على خلية فارغة قيمة فارغة. ملف المثال الخاص بنا:
أضف Meta: _wpml_import_language_code مع لغة النسخة الأصلية في كل صف. بعد ذلك يقوم كل صف بتحديث المنتج بتلك اللغة، وهي النسخة الأصلية. بدون هذا العمود، يقوم الصف بتحديث المنتج بلغة لوحة التحكم الحالية، لذلك تعتمد النتيجة على مبدل لغة لوحة التحكم.
اضبط لغة لوحة التحكم على اللغة الافتراضية للمتجر في مبدل اللغة بشريط الإدارة.
اذهب إلىالمنتجات ← استيراد، واختر الملف، وحدد تحديث المنتجات الحالية، وانقر على متابعة وتشغيل المستورد.
مباشرة بعد الاستيراد، تعرض كل لغة المخزون الجديد، والأسعار، ونطاق السعر.
باستخدام WP All Import، وفقاً لجدول زمني:
All Import ← New Import ← Download a file ← From URL، مع عنوان URL لخلاصة المورّد الخاص بك. اختر WooCommerce Products.
عيّن SKU، وRegular Price، وStock Qty في قسم ملحق WooCommerce.
في إعدادات الاستيراد، ضع علامة على Attempt to match to existing WooCommerce products before creating new ones وطابق بواسطة حقل مخصص_sku. أوقف تشغيل Create new WooCommerce products from records newly present in this import file. شغّل Update existing WooCommerce products with the data in this import file.
ضمن Choose which data to update، أوقف تشغيل كل شيء باستثناء حقول مخصصة، واختر Update only these Custom Fields, leave the rest alone: _regular_price, _price, _stock, _manage_stock.
جدولها. ضمن All Import ← Manage Imports ← Scheduling Options، يُظهر Manual Scheduling عنوان Trigger URL وعنوان Processing URL لمهمة cron على خادمك.
تطابق كل عملية تشغيل الصفوف مع المنتجات الأصلية، وتحصل كل لغة على الأسعار والمخزون الجديد لكل منتج وتغيير.
إذا تم استيراد ملف العملية B بالكامل مرة أخرى كتحديث، عيّن Published إلى 1 في كل صف. وإلا ستنتقل المنتجات المباشرة إلى مسودة حتى تشغيل Run WPML Import. ضع علامة على Update existing products، ثم انقر على Run WPML Import. تبقى المنتجات في حالة منشور، وتستبدل النصوص الموجودة في الملف الترجمات على الفور.
إضافة لغة إلى كتالوج تملكه بالفعل
العملية A:
اذهب إلىWPML ← اللغات، وانقر على Manage and Hide Site Languages، واستخدم Search and add a language… واختر اللغة.
انقر على Calculate Costs. يسرد مربع الحوار "Cost to translate your content into ..." العناصر والكلمات. انقر على حفظ.
يبدأ وضع ترجم كل شيء اللغة الجديدة تلقائياً، في المرة التالية التي يتم فيها تحميل صفحة لوحة تحكم WPML. يترجم WPML وينشر كل منتج وتغيير باللغة الجديدة. لا يتم المساس بلغاتك الحالية.
العملية B:
جهّز ملفاً يحتوي على صفوف اللغة الجديدة فقط. استخدم SKU كمجموعة الترجمة، ولغة المنتج الأصلي كاللغة المصدر، وPublished = -1 وpublish كالحالة النهائية.
اذهب إلىWPML ← تصدير واستيراد WPML وانقر على Run WPML Import.
ينضم كل منتج وتغيير جديد إلى مجموعة ترجمة منتجه الأصلي، بمطابقة SKU. يعمل هذا على أي كتالوج، حتى الكتالوجات التي لم يسبق استيرادها. تحصل اللغة الجديدة على فئاتها ومصطلحات سماتها الخاصة من الملف.
لا يضيف خيار Update existing products لغة: تتخطى أداة الاستيراد تلك الصفوف. وتُدرج كل منتج باللغة الجديدة مع رسالة "No matching product exists to update." وكل تغيير باللغة الجديدة مع رسالة "A new variation cannot be created without a parent product."
استيراد الكتالوجات الكبيرة
استورد ملفاً واحداً لكل لغة، مع البدء بالملفات الأصلية أولاً.
شغّل Run WPML Import مرة واحدة، بعد الملف الأخير.
لعمليات التشغيل الطويلة، استخدم WP-CLI: يُشغّل wp wpml import process نفس الخطوة التي يقوم بها الزر ويعرض العدد لكل خطوة.
الوقت المستغرق، من مختبرنا، باستخدام أداة استيراد WooCommerce وتشغيل Run WPML Import مرة واحدة لكتالوج بثلاث لغات:
المنتجات لكل لغة
الاستيراد بالكامل
من ذلك، Run WPML Import
500
حوالي نصف ساعة
بضع دقائق
1,000
حوالي ساعة واحدة
حوالي 10 دقائق
2,000
حوالي ساعتين
حوالي نصف ساعة
انتهى كل حجم في جلسة واحدة، مع وجود كل منتج وتغيير متصل في كل لغة. يمثل كل رقم عملية تشغيل واحدة على خادم مختبر مشترك. يستغرق الجزء الأكبر من الوقت في أداة استيراد WooCommerce، ويعتمد ذلك على خادمك. اعتبر هذه الأرقام كمقدار تقريبي.
تصدير المنتجات مع لغاتها (WP All Export)
يضيف WP All Export أعمدة WPML وهي _wpml_import_language_code، و_wpml_import_source_language_code، و_wpml_import_translation_group إلى تصدير WooCommerce Products افتراضياً. يصدّر قسم WPML الخاص به جميع اللغات أو لغة واحدة. تملأ عمليات التصدير التي يتم تشغيلها يدوياً أو وفقاً لجدول زمني هذه الأعمدة. اقرأ المزيد في تصدير المواقع متعددة اللغات باستخدام WP All Export.
المزامنة من نظام ERP أو PIM
نظام ERP (نظام تخطيط موارد المؤسسات) هو البرنامج الذي تحتفظ فيه الشركة بالمخزون، والأسعار، والطلبات. ونظام PIM (نظام إدارة معلومات المنتج) هو المكان الذي تحتفظ فيه بنصوص وبيانات المنتجات.
عادةً ما يقوم الموصّل بين هذا النظام وWooCommerce بما يلي:
يحتفظ بالكتالوج مفهرساً برمز SKU، بلغة واحدة
يعثر على كل منتج باستخدام رمز SKU (GET /wc/v3/products?sku=...)
يحدّث المخزون والأسعار للمنتجات الحالية، وينشئ منتجات جديدة، من خلال WooCommerce REST API
يعمل وفقاً لجدول زمني
هذا هو سير العمل الذي يتوافق مع WPML:
يكتب الموصّل في اللغة الافتراضية للمتجر فقط.
ينسخ WPML المخزون والأسعار إلى جميع اللغات في نفس الطلب.
يترجم «ترجم كل شيء ← المنتجات الجديدة إلى جميع اللغات (العملية أ).
المنتج الذي يعيّنه الموصّل كمسودة يتحول إلى مسودة في جميع اللغات.
المنتج الذي يحذفه الموصّل يتبع WPML ← إعدادات ← حذف المحتوى، في صف المنتجات. لا يُطلب من أحد اتخاذ قرار أثناء المزامنة، لذا عيّن حذف أصل على السلوك الذي تريده: حذف جميع اللغات يزيل الترجمات معه؛ وهذه فقط يبقيها منشورة.
اطرح على مورّد الموصّل ثلاثة أسئلة:
هل يكتب من خلال WooCommerce، أم في قاعدة البيانات مباشرة؟ التغييرات المكتوبة في قاعدة البيانات مباشرة تصل إلى النسخة الأصلية فقط. وتحتفظ الترجمات بالمخزون والأسعار القديمة.
بأي لغة يكتب؟ يجب أن يكتب في النسخة الأصلية. السعر المكتوب في الترجمة لا يُحفظ: بل تحتفظ الترجمة بسعر النسخة الأصلية.
هل ينشئ منتجاً واحداً لكل لغة؟ يرفض WooCommerce منتجاً ثانياً يحمل نفس رمز SKU. وبدون رمز SKU، تكون النسخ منتجات منفصلة لا تحصل على أي تحديثات للمخزون أو السعر. دع الموصّل ينشئ النسخة الأصلية فقط، ودع WPML يترجمها.
الجزء 3. بناء مسارات عمل مخصصة (للمطورين)
إنشاء منتج وترجماته باستخدام WooCommerce REST API
أنشئ المصطلحات أولاً، ثم النسخة الأصلية، ثم كل ترجمة باستخدام lang وtranslation_of.
ترجم الفئة (وأي مصطلحات سمات): POST /wp-json/wc/v3/products/categories
أنشئ كل ترجمة:POST /wp-json/wc/v3/products، مع النصوص المترجمة والفئة المترجمة وlang وtranslation_of (المعرف للنسخة الأصلية). لا ترسل أي رمز SKU أو سعر أو مخزون: ينسخها WPML من النسخة الأصلية.
اقرأ النتيجة باستخدام GET. تُظهر الاستجابة لطلب الإنشاء أن رمز SKU والسعر والمخزون فارغة، لأن WPML ينسخها بعد بناء الاستجابة. يُظهرها GET /wc/v3/products/121 بعد ذلك مباشرة.
بالنسبة لمنتج متعدد الأنواع، أنشئ أنواع النسخة الأصلية في النسخة الأصلية فقط (POST /wc/v3/products/<id>/variations/batch). ثم أنشئ كل أصل مترجم باستخدام lang وtranslation_of. ينشئ WPML الأنواع المترجمة بنفسه، ويربط كل نوع بنوعه الأصلي، وينسخ رمز SKU والسعر والمخزون ومصطلحات السمات بتلك اللغة. لا ترسل الأنواع في الترجمة.
اقرأ أنواع الترجمة باستخدام ?lang=:GET /wc/v3/products/137/variations?lang=fr. يحمل كل نوع lang، وخريطة translations الخاصة به، وأسماء الخيارات بتلك اللغة.
ترجمة منتج واحدة لكل لغة. تُرفض ترجمة المنتج الثانية بلغة تحتوي بالفعل على ترجمة برمز HTTP 400 wcml_translation_exists، ولا يُنشأ أي شيء. تذكر الرسالة المعرف للترجمة الحالية. حدّث الترجمة الحالية بدلاً من ذلك.
حدّث النسخة الأصلية. ينسخ WPML التغيير إلى جميع اللغات في نفس الطلب.
يؤدي PUT /wc/v3/products/123/variations/124 مع {"regular_price": "59.00", "stock_quantity": 3} إلى تغيير السعر والمخزون لذلك النوع في جميع اللغات، ويتبعه نطاق السعر.
يؤدي PUT /wc/v3/products/120 مع سعر عادي أو سعر تخفيض أو مخزون جديد إلى تغييرها في جميع اللغات.
تُنشأ مصطلحات السمات الجديدة في سمة النسخة الأصلية وتُترجم باستخدام lang وtranslation_of، كما في الخطوة 1 أعلاه.
يصل النوع الجديد المضاف إلى النسخة الأصلية (POST /wc/v3/products/123/variations أو .../variations/batch) إلى جميع اللغات في نفس الطلب، مرتبطاً، مع سعره ومخزونه. تُدرج الاستجابة للطلب لغة النسخة الأصلية فقط؛ بينما يُدرج GET /wc/v3/products/130/variations?lang=de بعد ذلك مباشرة النوع المترجم الجديد.
السعر أو السمات المُرسلة إلى الترجمة لا تُحفظ: بل تحتفظ الترجمة بقيم النسخة الأصلية. وتصبح قيمة المخزون المُرسلة إلى أي لغة هي المخزون لجميع اللغات.
الحذف من خلال API: يتبع DELETE /wc/v3/products/<id>WPML ← إعدادات ← حذف المحتوى، في صف المنتجات. لا يطلب API الإذن أبداً: ففي ظل اسألني، فإنه يحذف النسخة الأصلية فقط. عيّن حذف أصل على السلوك الذي يريده متجرك. في حالة حذف جميع اللغات، يؤدي الحذف إلى نقل جميع اللغات إلى سلة المهملات، ويحذف ?force=true جميع اللغات.
كتابة أداة الاستيراد أو الموصّل الخاص بك
استخدم دوال منتجات WooCommerce. يرى WPML التغيير وينسخه إلى جميع اللغات.
بعد save()، تعرض الترجمات السعر والمخزون الجديدين.
لا تكتب أبداً بيانات المنتج مباشرة في قاعدة البيانات (update_post_meta() أو SQL). يتغير الأصل، وتحتفظ الترجمات بالقيم القديمة.
شغّل خطوة استيراد WPML من الكود بعد استيراد يحتوي على أعمدة WPML: wp wpml import process. إنها تشغّل نفس خطوات زر Run WPML Import وتطبع كل خطوة مع عددها.
المهام المجدولة
تحمل المهمة المجدولة (WP-Cron) التي تغير الأصل باستخدام دوال منتجات WooCommerce هذه التغييرات إلى كل لغة في طلب المهمة نفسه:
السعر العادي، وسعر التخفيض، والمخزون، مع حالة المخزون التي تترتب على ذلك
تصنيف مضاف إلى المنتج (باعتباره التصنيف المترجم)
مصطلح سمة جديد في منتج متعدد الأنواع (باعتباره ترجمته)
نطاق سعر المنتج متعدد الأنواع
الجزء 4. استكشاف الأخطاء وإصلاحها
الترجمات المستوردة تظهر كمنتجات منفصلة غير مرتبطة
ما تراه: الصفوف المترجمة مفقودة، أو تبقى كمنتجات باللغة الإنجليزية (اللغة الافتراضية)، وغالباً ما تكون خاصة (Private)، دون أي رابط بالأصل.
لماذا يحدث هذا:
لا يحتوي الملف على أعمدة WPML. ثم يتخطى WooCommerce كل صف يوجد له SKU بالفعل: «A product with this SKU already exists.»
يحتوي الملف على أعمدة WPML، ولكن لم يتم تشغيل Run WPML Import. حتى ذلك الحين، يكون كل صف عبارة عن منتج باللغة الافتراضية دون أي رابط بأصله، مع الحالة التي يمنحها له عمود Published في الملف (خاص لـ 0، ومسودة لـ -1). تعرض شاشة WPML ← تصدير واستيراد رسالة «Good job. We see 12 posts that are imported and need language information.»
كيفية إصلاح ذلك الآن:
لم يتم تشغيل خطوة استيراد WPML: اذهب إلى WPML ← تصدير واستيراد وانقر على Run WPML Import.
لا توجد أعمدة WPML: أضف أعمدة WPML الأربعة إلى صفوف الترجمة واستوردها مرة أخرى كاستيراد جديد، مع إلغاء تحديد Update existing products. ثم انقر على Run WPML Import. تنضم كل ترجمة إلى أصلها بواسطة SKU.
كيفية تجنب ذلك: قم دائماً بتضمين أعمدة WPML، وشغّل Run WPML Import بعد كل استيراد.
استبدال الترجمات المستوردة بنص الأصل
ما تراه: لقد قمت باستيراد أسماء وأوصاف مترجمة، وبعد الحفظ التالي للأصل، تعود إلى اللغة الأصلية.
لماذا يحدث هذا: كانت الترجمات عبارة عن تكرارات. يعيد WPML كتابة التكرار عند كل حفظ لأصله.
كيفية إصلاح ذلك الآن:
اجعلها مستقلة. اذهب إلى المنتجات ← جميع المنتجات، وبدّل إلى لغة الترجمة، وحدد المنتجات واختر إجراءات مجمعة ← الترجمة بشكل مستقل.
إذا كان وضع ترجم كل شيء قيد التشغيل، فاضبط المنتجات على None. في WPML ← الترجمات، انقر على قائمة النقاط الثلاث في مربع «Translate Everything Automatically is enabled»، واختر Adjust content limits، واضبط المنتجات على None وانقر على احفظ التغييرات.
استورد ترجماتك مرة أخرى.
بعد ذلك، يؤدي حفظ الأصل إلى الاحتفاظ بالنص المستورد.
كيفية تجنب ذلك: قبل استيراد النص إلى الترجمات الحالية، اضبطها على الترجمة بشكل مستقل. أو استورد الترجمات كمنتجات جديدة باستخدام أعمدة WPML (العملية ب).
المنتجات المترجمة تعرض قيم السمات باللغة الأصلية
ما تراه: تقدم صفحة المنتج المترجم «Blue»، «Green» بدلاً من المصطلحات المترجمة.
سبب حدوث ذلك: تُرجمت المنتجات قبل ترجمة مصطلحات سماتها.
كيفية إصلاح ذلك الآن:
اذهب إلىWPML ← الترجمات وافتح علامة تبويب التصنيف.
ضمن «Select the taxonomy to translate»، اختر السمة، على سبيل المثال Product Color.
ترجم كل مصطلح في كل لغة وانقر على حفظ. ترجم تسمية السمة في نفس الشاشة.
تلتقط المنتجات المترجمة الحالية كل مصطلح بمجرد حفظه. لا يحتاج أي منتج إلى الحفظ مرة أخرى. إذا أُنشئ مصطلح في البداية كنسخة تحمل اسم الأصل، فإن المعرّف النصي للرابط الخاص به يحتفظ بنص الأصل؛ غيّره في نفس مربع الحوار.
كيفية تجنب ذلك: ترجم مصطلحات السمات قبل ترجمة المنتجات أو استيرادها.
الفئات أو المصطلحات المترجمة تحمل أسماء الأصل بعد الاستيراد
ما تراه: منتج مترجم يقع في فئة تسمى «Sunglasses» أو يعرض «Blue» في المتجر المترجم.
سبب حدوث ذلك: نُسخت صفوف الترجمة من عملية تصدير الأصل واحتفظت بأسماء فئته ووسمه ومصطلحات سماته. ينشئ WPML مصطلحات مترجمة بتلك الأسماء ويربطها بشكل صحيح، ولكنه لا يعيد تسميتها. يُعاد تعيين المبيعات البديلة، والمبيعات المتقاطعة، والصور، والمعارض، والآباء للتباينات المحددة بواسطة معرفات الأصل إلى اللغة الصحيحة.
كيفية إصلاح ذلك الآن: أعد تسمية المصطلحات ضمن WPML ← الترجمات ← التصنيف، كما في القسم أعلاه. تُظهر مسارات التنقل، وروابط المصطلحات، وعناوين الأرشيف، وخيارات السمات الأسماء الجديدة على الفور، ولا يحتاج أي منتج إلى الحفظ مرة أخرى. تحتفظ المعرّفات النصية للروابط بنص الأصل ما لم تغيّرها في نفس مربع الحوار.
كيفية تجنب ذلك: في صفوف الترجمة، اكتب أسماء الفئات، والوسوم، ومصطلحات السمات المترجمة، بنفس ترتيب الأصل. حدد المنتجات ذات الصلة والآباء بواسطة SKU.
المخزون أو الأسعار في اللغات الأخرى متأخرة عن الأصل
ما تراه: يعرض الأصل المخزون أو السعر الجديد، بينما تعرض الترجمات المخزون أو السعر القديم.
سبب حدوث ذلك: تجاوز التغيير WooCommerce أو WPML:
كتب أحد الموصلات مباشرة إلى قاعدة البيانات.
أُجريت عملية استيراد بينما كان WPML معطلاً.
كيفية معرفة ذلك: افتح الأصل في محرر المنتجات. أسفل محرر الوصف يُقرأ «Last edited on» مع تاريخ ووقت. إذا كان ذلك الوقت أقدم من السعر أو المخزون الجديد في مربع Product data، أو أُجري التغيير بينما كان WPML غير نشط، فإن التحديث قد تجاوز المزامنة.
كيفية إصلاح ذلك الآن:
للمنتجات المتغيرة:
اذهب إلىWPML ← الدعم ← Fix WCML translations. يُعد Fix WCML translations جزءًا من WPML Troubleshooting، وهو إضافة منفصلة.
ضع علامة على Synchronize product variations وانقر على Run the selected tools.
تعرض كل لغة بعد ذلك أسعار ومخزون تباينات الأصل، ونطاق سعر المنتج.
للمنتجات البسيطة، استخدم أحد هذه المسارات. ينقل كل منها سعر ومخزون الأصل إلى كل لغة:
منتج واحد في كل مرة: افتح كل أصل تم تغييره وانقر على تحديث.
منتجات متعددة عن طريق الاستيراد: مع تعيين لغة لوحة التحكم إلى اللغة الافتراضية، استورد المنتجات مرة أخرى باستخدام Products ← استيراد وضع علامة على Update existing products. يمكن للملف أن يحمل القيم التي تمتلكها الأصول بالفعل. يعيد هذا أيضاً محاذاة المنتجات المتغيرة.
منتجات متعددة عن طريق REST: أرسل PUT /wc/v3/products/<id> مع السعر لكل منتج، على سبيل المثال {"regular_price": "19.50"}.
منتجات متعددة بسعر واحد: في المنتجات ← جميع المنتجات، ضع علامة على المنتجات، واختر Bulk actions ← Bulk edit وانقر على طبِّق. ضمن Price اختر Change to:، وأدخل السعر وانقر على تحديث. يحصل كل منتج تم وضع علامة عليه على هذا السعر الواحد.
إن تشغيل wp wc product update بالقيمة التي يمتلكها الأصل بالفعل لا ينقلها إلى الترجمات.
كيفية تجنب ذلك: دع الموصل يكتب من خلال WooCommerce (REST API أو وظائف المنتج)، وأبقِ WPML نشطاً أثناء عمليات الاستيراد.
المنتجات المنشأة من خلال REST API تهبط في اللغة أو المجموعة الخاطئة
ما تراه: تظهر ترجمة في اللغة الخاطئة، أو كمنتج منفصل بدون SKU وبدون رابط إلى الأصل.
سبب حدوث ذلك:
يُرفض رمز لغة غير معروف بـ HTTP 422 Invalid language parameter: "ge"، ولا يُنشأ أي شيء.
رمز صالح ولكنه خاطئ، مثل نص ألماني يُرسل مع "lang": "fr"، ينشئ ترجمة بتلك اللغة.
يؤدي فقدان translation_of إلى إنشاء منتج في مجموعته الخاصة، بدون SKU وبدون سعر أو مخزون منسوخ.
كيفية إصلاح ذلك الآن: أرسل المنتج مرة أخرى باللغة الصحيحة والرابط، باستخدام PUT /wc/v3/products/<id>:
JSON
{
"lang": "de",
"translation_of": 38
}
ينتقل المنتج إلى مجموعة الأصل ويحصل على SKU والسعر والمخزون الخاص به. بالنسبة للمنتج المتغير، يستبدل WPML التباينات المنشأة بدون رابط بتباينات جديدة مرتبطة. اقرأ معرفات التباينات الجديدة مرة أخرى.
كيفية تجنب ذلك: أرسل lang و translation_of في كل ترجمة، وأنشئ المصطلحات أولاً، ودع WPML ينشئ تباينات الترجمات.
المنتجات المستوردة الجديدة لا تُترجم تلقائياً
ما تراه: تبقى المنتجات المستوردة باللغة الأصلية فقط.
سبب حدوث ذلك: كان وضع ترجم كل شيء متوقفاً أثناء الاستيراد، أو أن المنتجات خاصة، والتي لا يترجمها وضع ترجم كل شيء أبداً، أو مسودات، والتي يترجمها فقط عندما يكون Translate drafts automatically قيد التشغيل وتُحفظ المسودة مرة أخرى.
كيفية إصلاح ذلك الآن:
أرسل المنتجات: اذهب إلى WPML ← الترجمات، وافتح قسم Products، وضع علامة على المنتجات، واختر ترجم تلقائيًا لكل لغة، واختر Publish without review ضمن «What would you like to do when WPML finishes translating your content automatically؟» وانقر على ترجم المحتوى. ينجح هذا أيضاً مع المسودات والمنتجات الخاصة؛ حيث تحصل ترجماتها على حالة الأصل.
أو شغّل ترجم كل شيء. يترجم كل منتج منشور لم يُترجم بعد. يرسلها WPML أثناء تحميل صفحات لوحة تحكم WPML.
اذهب إلىWPML ← الترجمات ← أعدّ ترجم كل شيء ← Continue ← Enable Translate Everything Automatically.
ابقَ فيWPML ← الترجمات حتى تقرأ «Finished translating your content».
كيفية تجنب ذلك: شغّل ترجم كل شيء قبل الاستيراد (العملية أ)، واستورد المنتجات كمنشورة.