WPML

هذا الدليل مخصص للمتاجر التي يوجد الكتالوج الخاص بها خارج WordPress: في جدول بيانات أو PIM أو ERP أو موجز مورد. تصل المنتجات إلى WooCommerce عن طريق أداة استيراد أو REST API أو مهمة مجدولة، ونادراً ما تفتح محرر المنتجات.

تحتاج إلى WPML وWPML Multilingual & Multicurrency for WooCommerce، ولعمليات الاستيراد التي تتضمن ترجمات، تحتاج إلى تصدير واستيراد WPML.

الجزء 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 عندما يكون تعدد العملات قيد التشغيل وتكون العملة إحدى عملات متجرك. أرسلها على النحو التالي:

  1. شغّل تعدد العملات أولاً. اذهب إلى WPMLإعداداتتعدد العملات، وحدد Enable the multicurrency mode وانقر على احفظ التغييرات. ضمن Show currencies based on، اختر خياراً (على سبيل المثال Site Language) وانقر على احفظ التغييرات. ثم أضف كل عملة باستخدام Add currency. مع إيقاف تشغيل تعدد العملات، لا يخزن WPML أي شيء من custom_prices.
  2. استخدم رموز عملات متجرك. يخزن WPML أسعار عملات المتجر فقط. لا يتم تخزين أي سعر برمز آخر.
  3. للمنتج المتغير، أرسل custom_prices على كل اختلاف، وليس على المنتج الأب. يخزنه WPML على الاختلاف الأصلي، وتعرضه كل لغة. إذا تم إرساله على المنتج الأب، فلن يتم تخزينه.
  4. اقرأ الأسعار المخزنة من meta_data (_regular_price_USD و_sale_price_USD و_price_USD). لا تتضمن الإجابات على استدعاءات REST حقلاً باسم custom_prices.

نسخ مكررة أو ترجمات مستقلة

يحتوي WPML على نوعين من المنتجات المترجمة. يحدد النوع الذي لديك ما يحدث للنص الذي تستورده.

نسخة مكررةترجمة مستقلة
ما هينسخة يحافظ عليها WPMLترجمة بنصها الخاص
النص بعد الحفظ التالي للأصليُستبدل بنص الأصليُحتفظ به فقط مع إيقاف تشغيل ترجم كل شيء أو مع تعيين Products إلى None
السعر والمخزونيتبعان الأصليتبعان الأصل

إعداد المتجر قبل وصول المنتج الأول

  1. شغّل معالج إعداد WooCommerce Multilingual. يُفتح المعالج عند تفعيل WPML Multilingual & Multicurrency for WooCommerce. شاشاته هي صفحات المتجر، والسمات العامة، وعملات متعددة. تُنشئ الشاشة الأولى صفحات المتجر، وسلة التسوق، وإتمام الشراء، وحسابي بكل لغة.
  2. اجعل سماتك العامة قابلة للترجمة. في شاشة المعالج «أي سمات المنتج يجب أن تكون قابلة للترجمة؟»، حدد كل سمة، على سبيل المثال اللون والمقاس. لاحقاً، الإعداد نفسه هو مربع الاختيار قابل للترجمة؟ تحت المنتجاتالسماتتعديل.
  3. ترجم مصطلحات السمات قبل المنتجات. اذهب إلى WPMLالترجمات، وافتح علامة التبويب التصنيف، واختر السمة تحت «حدد التصنيف لترجمته» وترجم كل مصطلح. عند تفعيل ترجم كل شيء (العملية A)، تترجم WPML المصطلحات الجديدة نيابةً عنك.

الجزء 2. البناء بدون تعليمات برمجية

اختيار عمليتك: لغة واحدة أو كل اللغات

العملية A: تترجم WPMLالعملية B: أنت تستورد كل لغة
ما يحتويه نظامكاللغة الافتراضية للمتجر فقطكل لغة
ما تستوردهالمنتجات الأصليةالمنتجات الأصلية وترجماتها، مرتبطة برمز SKU
من يترجمترجم كل شيء، مع Private Translation Cloud (PTC) (يفتح في علامة تبويب جديدة)مترجموك، قبل الاستيراد
عندما يتغير نص المنتج الأصليتترجم ميزة ترجم كل شيء التغييرتضع WPML علامة على الترجمة بأنها تحتاج إلى تحديث؛ ويجلب ملفك التالي النص الجديد
الأسعار والمخزونتتبع المنتج الأصليتتبع المنتج الأصلي

تناسب العملية A متجراً يحتفظ بلغة واحدة ويريد كل لغة أخرى بدون ملفات ترجمة. بينما تناسب العملية B متجراً يحتوي نظامه لإدارة معلومات المنتج (PIM) أو مترجموه بالفعل على النصوص بكل لغة.

العملية A مع أداة استيراد CSV في WooCommerce أو WP All Import

شغّل ترجم كل شيء مرة واحدة:

  1. اذهب إلى WPMLالترجمات وانقر على أعدّ ترجم كل شيء.
  2. اختر المحتوى. تحت «المحتوى المراد ترجمته»، أبقِ على جميع المنتجات وانقر على متابعة.
  3. اختر كيفية نشر الترجمات. تحت «طريقة النشر»، أبقِ على نشر بدون مراجعة.
  4. انقر على تمكين ترجم كل شيء تلقائيًا.

استورد منتجاتك باللغة الافتراضية للمتجر فقط. استخدم المنتجاتاستيراد (أداة استيراد CSV في WooCommerce) أو All ImportNew Import (إضافة WP All Import مع ملحق WooCommerce الخاص بها). لا يحتاج ملفك إلى أي أعمدة خاصة بـ WPML.

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

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

تترجم ميزة ترجم كل شيء المنتجات المنشورة، بما في ذلك المنتجات الخارجية. ولا تترجم المنتجات الخاصة. وتنتظر المسودات أيضاً: يكون الخيار ترجمة المسودات تلقائياً (تحت WPMLإعداداتترجمة AI، في مربع محرر الترجمة المتقدم) متوقفاً بشكل افتراضي، وعند تشغيله، تترجم WPML المسودة فقط عند حفظها مرة أخرى. لترجمة المسودات والمنتجات الخاصة، أرسلها من WPMLالترجمات (انظر قسم استكشاف الأخطاء وإصلاحها).

إذا كنت تريد تغيير ترجمة، افتحها من مربع اللغة الخاص بالمنتج (تعديل الترجمة ...)، وعدّلها في محرر الترجمة المتقدم وانقر على حفظ واكتمال. عندما يتغير المنتج الأصلي لاحقاً، يبقى تعديلك للجمل التي لم تتغير كما هو.

العملية B مع أداة استيراد CSV في WooCommerce

في العملية B، يحمل ملفك كل لغة.

اضبط ميزة ترجم كل شيء للترجمات المستوردة قبل الاستيراد الأول:

  1. اذهب إلى WPMLالترجمات. إذا كانت ميزة ترجم كل شيء متوقفة، فاتركها متوقفة وانتقل إلى الملف.
  2. إذا كنت تريد أن تترجم WPML صفحاتك، ومقالاتك، وسلاسلك النصية تلقائياً، انقر على أعدّ ترجم كل شيء. تحت «المحتوى المراد ترجمته»، اضبط المنتجات على لا شيء. انقر على متابعة، وأبقِ على نشر بدون مراجعة وانقر على تمكين ترجم كل شيء تلقائيًا.
  3. إذا كانت ميزة ترجم كل شيء قيد التشغيل بالفعل، انقر على قائمة النقاط الثلاث في مربع «ترجم كل شيء تلقائيًا ممكّنة»، واختر ضبط حدود المحتوى، واضبط المنتجات على لا شيء وانقر على احفظ التغييرات. ستكتمل الترجمات التي قيد التقدم بالفعل.

مع ضبط المنتجات على لا شيء، تحتفظ 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

صف ألماني لمنتج متعدد الأنواع من ملف المثال الخاص بنا:

Type,SKU,Name,Published,...,Categories,...,Parent,Attribute 1 name,Attribute 1 value(s),...,Meta: _wpml_import_translation_group,Meta: _wpml_import_language_code,Meta: _wpml_import_source_language_code,Meta: _wpml_import_after_process_post_status
variable,HP-JK-SHELL,Verstaubare Regenjacke,-1,...,Kleidung > Jacken,...,,Color,"Blau, Grün",...,HP-JK-SHELL,de,en,publish
variation,HP-JK-SHELL-BLU-S,,1,...,,...,HP-JK-SHELL,Color,Blau,...,HP-JK-SHELL-BLU-S,de,en,publish

استورده:

  1. اذهب إلى المنتجاتاستيراد واختر الملف أسفل «اختيار ملف CSV من جهاز الكمبيوتر الخاص بك:». اترك خيار تحديث المنتجات الحالية بدون تحديد. انقر على متابعة.
  2. تحقق من التعيين. يتم تعيين أعمدة Meta: الأربعة إلى استيراد كبيانات وصفية. انقر على تشغيل المستورد.
  3. اذهب إلى WPMLتصدير واستيراد WPML. تقرأ الشاشة «عمل رائع. نرى 33 مقالة تم استيرادها وتحتاج إلى معلومات اللغة.». انقر على تشغيل استيراد WPML.
  4. انتظر حتى ظهور «اكتمل الاستيراد متعدد اللغات».

حتى الخطوة 3، يكون كل منتج عبارة عن مسودة باللغة الإنجليزية وكل نوع عبارة عن نوع باللغة الإنجليزية، ولا يرتبط أي منها بنسخته الأصلية. بعد ذلك:

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

لجعل WPML يترجم المنتجات المختارة تلقائياً بينما يتم تعيين المنتجات على لا شيء:

  1. أبقِ ترجم كل شيء قيد التشغيل.
  2. أضف العمود Meta: _wpml_import_tea إلى الملف، مع القيمة 1 في كل منتج تريد ترجمته.
  3. احتفظ بـ Meta: _wpml_import_translation_group في نفس الملف.
  4. استورد الملف، ثم اذهب إلى WPMLتصدير واستيراد WPML وانقر على تشغيل استيراد WPML. تعرض قائمة التقدم «إرسال المقالات للترجمة التلقائية»، ويقوم WPML بترجمة ونشر هذه المنتجات.

العملية ب باستخدام WP All Import

أنت بحاجة إلى WP All Import Pro وملحق WooCommerce الخاص به. لا تستورد النسخة المجانية الحقول المخصصة، وأعمدة WPML هي حقول مخصصة.

ترتيب العمل هو: عناصر السمات أولاً، مع ربط ترجماتها، ثم المنتجات. تقدم صفحات المنتجات المترجمة بعد ذلك كل قيمة سمة بلغتها الخاصة، على سبيل المثال Bleu marine وليس Navy.

  1. اربط العناصر المترجمة الموجودة في المتجر بالفعل. لكل عنصر سمة مترجم موجود بالفعل في المتجر، اذهب إلى المنتجاتالسمات، وانقر على تكوين العناصر للسمة، وبدّل شريط الإدارة إلى لغة العنصر وانقر على اسم العنصر. في مربع اللغة، اختر نسخته الأصلية أسفل هذه ترجمة لـ وانقر على تحديث. يعرض كل عنصر متصل بعد ذلك أيقونة قلم رصاص أسفل لغته في WPMLالترجماتالتصنيف.
  2. اضبط لغة لوحة التحكم على اللغة الافتراضية للمتجر في مبدل اللغة بشريط الإدارة قبل تشغيل عمليات الاستيراد.
  3. استورد التصنيفات. من All ImportNew ImportUpload a file، اختر التصنيفاتتصنيفات المنتجات. أسفل بيانات المصطلح الوصفية، أضف ثلاثة صفوف: _wpml_import_language_code و_wpml_import_source_language_code و_wpml_import_translation_group، كل منها معين إلى عمود الملف الذي يحمل نفس الاسم. اضبط الأصل أسفل Other Category OptionsParent Term.
  4. استورد عناصر السمات بنفس الطريقة، على سبيل المثال التصنيفاتProduct Color، مع نفس صفوف بيانات المصطلح الوصفية الثلاثة.
  5. اربط العناصر. اذهب إلى WPMLتصدير واستيراد WPML وانقر على تشغيل استيراد WPML. تحقق أسفل WPMLالترجماتالتصنيف (اختر التصنيف في «حدد التصنيف لترجمته») من أن كل عنصر له صف واحد مع أيقونة قلم رصاص أسفل علم كل لغة. مرر مؤشر الماوس فوق أيقونة القلم الرصاص لرؤية الاسم المترجم. تعني علامة "+" أن هذه اللغة ليس لها ترجمة. العنصر المترجم المدرج في صفه الخاص غير متصل.
  6. استورد المنتجات. اختر WooCommerce Products. في قسم WooCommerce Add-On، قم بتعيين رمز SKU والأسعار والمخزون والسمات. أسفل حقول مخصصة، أضف صفوف _wpml_import_* الثلاثة.
  7. شغّل استيراد WPML مرة أخرى، وانتظر حتى ظهور اكتمل الاستيراد متعدد اللغات.

ملف العناصر الخاص بنا كمثال:

name,_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group
Navy,en,,color-navy
Marineblau,de,en,color-navy

إعدادان لملف منتج يحتوي على كل لغة:

يعمل هذا الترتيب سواء بدأت عمليات استيراد WP All Import من wp-admin أو من WP-CLI أو وفقاً لجدول زمني.

تحديث المخزون والأسعار وفقاً لجدول زمني

قم بتحديث المنتجات الأصلية. ينسخ WPML المخزون والأسعار إلى كل لغة على الفور.

باستخدام مستورد CSV الخاص بـ WooCommerce:

  1. أرسل فقط الأعمدة التي تقوم بتغييرها. يكتب العمود الذي يحتوي على خلية فارغة قيمة فارغة. ملف المثال الخاص بنا:
    SKU,Stock,Regular price,Meta: _wpml_import_language_code
    HP-JK-FIELD,11,95,en
    HP-JK-SHELL-BLU-S,5,72,en
  2. أضف Meta: _wpml_import_language_code مع لغة النسخة الأصلية في كل صف. بعد ذلك يقوم كل صف بتحديث المنتج بتلك اللغة، وهي النسخة الأصلية. بدون هذا العمود، يقوم الصف بتحديث المنتج بلغة لوحة التحكم الحالية، لذلك تعتمد النتيجة على مبدل لغة لوحة التحكم.
  3. اضبط لغة لوحة التحكم على اللغة الافتراضية للمتجر في مبدل اللغة بشريط الإدارة.
  4. اذهب إلى المنتجاتاستيراد، واختر الملف، وحدد تحديث المنتجات الحالية، وانقر على متابعة وتشغيل المستورد.

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

باستخدام WP All Import، وفقاً لجدول زمني:

  1. All ImportNew ImportDownload a fileFrom URL، مع عنوان URL لخلاصة المورّد الخاص بك. اختر WooCommerce Products.
  2. عيّن SKU، وRegular Price، وStock Qty في قسم ملحق WooCommerce.
  3. في إعدادات الاستيراد، ضع علامة على 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.
  4. ضمن Choose which data to update، أوقف تشغيل كل شيء باستثناء حقول مخصصة، واختر Update only these Custom Fields, leave the rest alone: _regular_price, _price, _stock, _manage_stock.
  5. جدولها. ضمن All ImportManage ImportsScheduling Options، يُظهر Manual Scheduling عنوان Trigger URL وعنوان Processing URL لمهمة cron على خادمك.

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

إذا تم استيراد ملف العملية B بالكامل مرة أخرى كتحديث، عيّن Published إلى 1 في كل صف. وإلا ستنتقل المنتجات المباشرة إلى مسودة حتى تشغيل Run WPML Import. ضع علامة على Update existing products، ثم انقر على Run WPML Import. تبقى المنتجات في حالة منشور، وتستبدل النصوص الموجودة في الملف الترجمات على الفور.

إضافة لغة إلى كتالوج تملكه بالفعل

العملية A:

  1. اذهب إلى WPMLاللغات، وانقر على Manage and Hide Site Languages، واستخدم Search and add a language… واختر اللغة.
  2. انقر على Calculate Costs. يسرد مربع الحوار "Cost to translate your content into ..." العناصر والكلمات. انقر على حفظ.

يبدأ وضع ترجم كل شيء اللغة الجديدة تلقائياً، في المرة التالية التي يتم فيها تحميل صفحة لوحة تحكم WPML. يترجم WPML وينشر كل منتج وتغيير باللغة الجديدة. لا يتم المساس بلغاتك الحالية.

العملية B:

  1. جهّز ملفاً يحتوي على صفوف اللغة الجديدة فقط. استخدم SKU كمجموعة الترجمة، ولغة المنتج الأصلي كاللغة المصدر، وPublished = -1 وpublish كالحالة النهائية.
  2. اذهب إلى المنتجاتاستيراد. اترك Update existing products بدون علامة. شغّل أداة الاستيراد.
  3. اذهب إلى 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."

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

الوقت المستغرق، من مختبرنا، باستخدام أداة استيراد 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 بما يلي:

هذا هو سير العمل الذي يتوافق مع WPML:

  1. يكتب الموصّل في اللغة الافتراضية للمتجر فقط.
  2. ينسخ WPML المخزون والأسعار إلى جميع اللغات في نفس الطلب.
  3. يترجم «ترجم كل شيءالمنتجات الجديدة إلى جميع اللغات (العملية أ).
  4. المنتج الذي يعيّنه الموصّل كمسودة يتحول إلى مسودة في جميع اللغات.
  5. المنتج الذي يحذفه الموصّل يتبع WPMLإعداداتحذف المحتوى، في صف المنتجات. لا يُطلب من أحد اتخاذ قرار أثناء المزامنة، لذا عيّن حذف أصل على السلوك الذي تريده: حذف جميع اللغات يزيل الترجمات معه؛ وهذه فقط يبقيها منشورة.

اطرح على مورّد الموصّل ثلاثة أسئلة:

  1. هل يكتب من خلال WooCommerce، أم في قاعدة البيانات مباشرة؟ التغييرات المكتوبة في قاعدة البيانات مباشرة تصل إلى النسخة الأصلية فقط. وتحتفظ الترجمات بالمخزون والأسعار القديمة.
  2. بأي لغة يكتب؟ يجب أن يكتب في النسخة الأصلية. السعر المكتوب في الترجمة لا يُحفظ: بل تحتفظ الترجمة بسعر النسخة الأصلية.
  3. هل ينشئ منتجاً واحداً لكل لغة؟ يرفض WooCommerce منتجاً ثانياً يحمل نفس رمز SKU. وبدون رمز SKU، تكون النسخ منتجات منفصلة لا تحصل على أي تحديثات للمخزون أو السعر. دع الموصّل ينشئ النسخة الأصلية فقط، ودع WPML يترجمها.

الجزء 3. بناء مسارات عمل مخصصة (للمطورين)

إنشاء منتج وترجماته باستخدام WooCommerce REST API

أنشئ المصطلحات أولاً، ثم النسخة الأصلية، ثم كل ترجمة باستخدام lang وtranslation_of.

  1. ترجم الفئة (وأي مصطلحات سمات): POST /wp-json/wc/v3/products/categories
    JSON
    {
      "name": "Wohnen und Geschenke",
      "slug": "wohnen-und-geschenke",
      "lang": "de",
      "translation_of": 32
    }

    بالنسبة لمصطلحات السمات، استخدم POST /wc/v3/products/attributes/<id>/terms/batch مع نفس الحقلين في كل مصطلح.

  2. أنشئ النسخة الأصلية: POST /wp-json/wc/v3/products
    JSON
    {
      "name": "Stoneware Coffee Mug",
      "type": "simple",
      "status": "publish",
      "sku": "HP-HG-MUG",
      "regular_price": "16.00",
      "manage_stock": true,
      "stock_quantity": 60,
      "categories": [ { "id": 32 } ],
      "lang": "en"
    }
  3. أنشئ كل ترجمة: POST /wp-json/wc/v3/products، مع النصوص المترجمة والفئة المترجمة وlang وtranslation_of (المعرف للنسخة الأصلية). لا ترسل أي رمز SKU أو سعر أو مخزون: ينسخها WPML من النسخة الأصلية.
    JSON
    {
      "name": "Steingut-Kaffeebecher",
      "slug": "steingut-kaffeebecher",
      "status": "publish",
      "categories": [ { "id": 38 } ],
      "lang": "de",
      "translation_of": 120
    }
  4. اقرأ النتيجة باستخدام 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، ولا يُنشأ أي شيء. تذكر الرسالة المعرف للترجمة الحالية. حدّث الترجمة الحالية بدلاً من ذلك.

مرجع الحقول الكامل: WooCommerce Multilingual REST API.

تحديث المنتجات باستخدام WooCommerce REST API

حدّث النسخة الأصلية. ينسخ WPML التغيير إلى جميع اللغات في نفس الطلب.

الحذف من خلال API: يتبع DELETE /wc/v3/products/<id> WPMLإعداداتحذف المحتوى، في صف المنتجات. لا يطلب API الإذن أبداً: ففي ظل اسألني، فإنه يحذف النسخة الأصلية فقط. عيّن حذف أصل على السلوك الذي يريده متجرك. في حالة حذف جميع اللغات، يؤدي الحذف إلى نقل جميع اللغات إلى سلة المهملات، ويحذف ?force=true جميع اللغات.

كتابة أداة الاستيراد أو الموصّل الخاص بك

استخدم دوال منتجات WooCommerce. يرى WPML التغيير وينسخه إلى جميع اللغات.

PHP
$id      = wc_get_product_id_by_sku( 'HP-HG-MUG' ); // returns the original
$product = wc_get_product( $id );
$product->set_regular_price( '19.00' );
$product->set_stock_quantity( 33 );
$product->save();

بعد save()، تعرض الترجمات السعر والمخزون الجديدين.

لا تكتب أبداً بيانات المنتج مباشرة في قاعدة البيانات (update_post_meta() أو SQL). يتغير الأصل، وتحتفظ الترجمات بالقيم القديمة.

شغّل خطوة استيراد WPML من الكود بعد استيراد يحتوي على أعمدة WPML: wp wpml import process. إنها تشغّل نفس خطوات زر Run WPML Import وتطبع كل خطوة مع عددها.

المهام المجدولة

تحمل المهمة المجدولة (WP-Cron) التي تغير الأصل باستخدام دوال منتجات WooCommerce هذه التغييرات إلى كل لغة في طلب المهمة نفسه:

الجزء 4. استكشاف الأخطاء وإصلاحها

الترجمات المستوردة تظهر كمنتجات منفصلة غير مرتبطة

ما تراه: الصفوف المترجمة مفقودة، أو تبقى كمنتجات باللغة الإنجليزية (اللغة الافتراضية)، وغالباً ما تكون خاصة (Private)، دون أي رابط بالأصل.

لماذا يحدث هذا:

كيفية إصلاح ذلك الآن:

كيفية تجنب ذلك: قم دائماً بتضمين أعمدة WPML، وشغّل Run WPML Import بعد كل استيراد.

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

ما تراه: لقد قمت باستيراد أسماء وأوصاف مترجمة، وبعد الحفظ التالي للأصل، تعود إلى اللغة الأصلية.

لماذا يحدث هذا: كانت الترجمات عبارة عن تكرارات. يعيد WPML كتابة التكرار عند كل حفظ لأصله.

كيفية إصلاح ذلك الآن:

  1. اجعلها مستقلة. اذهب إلى المنتجاتجميع المنتجات، وبدّل إلى لغة الترجمة، وحدد المنتجات واختر إجراءات مجمعةالترجمة بشكل مستقل.
  2. إذا كان وضع ترجم كل شيء قيد التشغيل، فاضبط المنتجات على None. في WPMLالترجمات، انقر على قائمة النقاط الثلاث في مربع «Translate Everything Automatically is enabled»، واختر Adjust content limits، واضبط المنتجات على None وانقر على احفظ التغييرات.
  3. استورد ترجماتك مرة أخرى.

بعد ذلك، يؤدي حفظ الأصل إلى الاحتفاظ بالنص المستورد.

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

المنتجات المترجمة تعرض قيم السمات باللغة الأصلية

ما تراه: تقدم صفحة المنتج المترجم «Blue»، «Green» بدلاً من المصطلحات المترجمة.

سبب حدوث ذلك: تُرجمت المنتجات قبل ترجمة مصطلحات سماتها.

كيفية إصلاح ذلك الآن:

  1. اذهب إلى WPMLالترجمات وافتح علامة تبويب التصنيف.
  2. ضمن «Select the taxonomy to translate»، اختر السمة، على سبيل المثال Product Color.
  3. ترجم كل مصطلح في كل لغة وانقر على حفظ. ترجم تسمية السمة في نفس الشاشة.

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

كيفية تجنب ذلك: ترجم مصطلحات السمات قبل ترجمة المنتجات أو استيرادها.

الفئات أو المصطلحات المترجمة تحمل أسماء الأصل بعد الاستيراد

ما تراه: منتج مترجم يقع في فئة تسمى «Sunglasses» أو يعرض «Blue» في المتجر المترجم.

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

كيفية إصلاح ذلك الآن: أعد تسمية المصطلحات ضمن WPMLالترجماتالتصنيف، كما في القسم أعلاه. تُظهر مسارات التنقل، وروابط المصطلحات، وعناوين الأرشيف، وخيارات السمات الأسماء الجديدة على الفور، ولا يحتاج أي منتج إلى الحفظ مرة أخرى. تحتفظ المعرّفات النصية للروابط بنص الأصل ما لم تغيّرها في نفس مربع الحوار.

كيفية تجنب ذلك: في صفوف الترجمة، اكتب أسماء الفئات، والوسوم، ومصطلحات السمات المترجمة، بنفس ترتيب الأصل. حدد المنتجات ذات الصلة والآباء بواسطة SKU.

المخزون أو الأسعار في اللغات الأخرى متأخرة عن الأصل

ما تراه: يعرض الأصل المخزون أو السعر الجديد، بينما تعرض الترجمات المخزون أو السعر القديم.

سبب حدوث ذلك: تجاوز التغيير WooCommerce أو WPML:

كيفية معرفة ذلك: افتح الأصل في محرر المنتجات. أسفل محرر الوصف يُقرأ «Last edited on» مع تاريخ ووقت. إذا كان ذلك الوقت أقدم من السعر أو المخزون الجديد في مربع Product data، أو أُجري التغيير بينما كان WPML غير نشط، فإن التحديث قد تجاوز المزامنة.

كيفية إصلاح ذلك الآن:

للمنتجات المتغيرة:

  1. اذهب إلى WPMLالدعمFix WCML translations. يُعد Fix WCML translations جزءًا من WPML Troubleshooting، وهو إضافة منفصلة.
  2. ضع علامة على Synchronize product variations وانقر على Run the selected tools.

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

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

إن تشغيل wp wc product update بالقيمة التي يمتلكها الأصل بالفعل لا ينقلها إلى الترجمات.

كيفية تجنب ذلك: دع الموصل يكتب من خلال WooCommerce (REST API أو وظائف المنتج)، وأبقِ WPML نشطاً أثناء عمليات الاستيراد.

المنتجات المنشأة من خلال REST API تهبط في اللغة أو المجموعة الخاطئة

ما تراه: تظهر ترجمة في اللغة الخاطئة، أو كمنتج منفصل بدون SKU وبدون رابط إلى الأصل.

سبب حدوث ذلك:

كيفية إصلاح ذلك الآن: أرسل المنتج مرة أخرى باللغة الصحيحة والرابط، باستخدام PUT /wc/v3/products/<id>:

JSON
{
  "lang": "de",
  "translation_of": 38
}

ينتقل المنتج إلى مجموعة الأصل ويحصل على SKU والسعر والمخزون الخاص به. بالنسبة للمنتج المتغير، يستبدل WPML التباينات المنشأة بدون رابط بتباينات جديدة مرتبطة. اقرأ معرفات التباينات الجديدة مرة أخرى.

كيفية تجنب ذلك: أرسل lang و translation_of في كل ترجمة، وأنشئ المصطلحات أولاً، ودع WPML ينشئ تباينات الترجمات.

المنتجات المستوردة الجديدة لا تُترجم تلقائياً

ما تراه: تبقى المنتجات المستوردة باللغة الأصلية فقط.

سبب حدوث ذلك: كان وضع ترجم كل شيء متوقفاً أثناء الاستيراد، أو أن المنتجات خاصة، والتي لا يترجمها وضع ترجم كل شيء أبداً، أو مسودات، والتي يترجمها فقط عندما يكون Translate drafts automatically قيد التشغيل وتُحفظ المسودة مرة أخرى.

كيفية إصلاح ذلك الآن:

كيفية تجنب ذلك: شغّل ترجم كل شيء قبل الاستيراد (العملية أ)، واستورد المنتجات كمنشورة.

بقلمAmir