كيفية استيراد المحتوى متعدد اللغات إلى WordPress - WooCommerce و CSV و XML

تعمل إضافة تصدير واستيراد WPML جنباً إلى جنب مع إضافة استيراد WordPress التي تستخدمها بالفعل. تنقل إضافة الاستيراد بياناتك. وتضيف إضافة تصدير واستيراد WPML معلومات اللغة في النهاية بحيث يستقر كل صف في اللغة الصحيحة وترتبط كل ترجمة بمصدرها.

قبل البدء

ثبّت وفعّل هذه الإضافات على الموقع الذي تستورد إليه:

إضافة استيراد: WP All Import Pro، أو WP All Export Pro، أو أداة استيراد CSV الأصلية في WooCommerce، أو أداة استيراد WordPress القياسية.
WPML و WPML ترجمة النصوص.
تصدير واستيراد WPML (الملحق الذي تغطيه هذه الصفحة).
WPML Multilingual & Multicurrency for WooCommerce إذا كنت تستورد منتجات WooCommerce.

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

مساران – اختر المسار الذي يطابق مصدرك

هناك مساران للاستيراد، اعتماداً على المكان الذي تأتي منه البيانات متعددة اللغات:

إضافة استيراد مدعومة. إذا كنت تنقل محتوى من موقع WordPress حالي باستخدام WP All Export Pro (أو أداة تصدير أخرى مدعومة)، فإن إضافة تصدير واستيراد WPML موجودة بالفعل في ملف التصدير – تُضمّن معلومات اللغة تلقائياً. تخطّ إلى خطوة تشغيل استيراد WPML أدناه.
ملف CSV أو XML مخصص. إذا كنت تحتفظ ببيانات متعددة اللغات في جدول بيانات أو كان مصدرك نظاماً غير WordPress (مثل PIM، أو MLS، أو ERP، أو منصة حجز)، فستضيف ثلاثة أعمدة للغة إلى ملفك يدوياً. تابع إلى إعداد ملف CSV أو XML أدناه.

إعداد ملف CSV أو XML بثلاثة أعمدة للغة

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

_wpml_import_translation_group. قيمة فريدة تشترك فيها جميع إصدارات اللغة لجزء واحد من المحتوى. بالنسبة للمنتجات، استخدم SKU. بالنسبة لأي شيء آخر، أنشئ المعرف الخاص بك وأعد استخدامه للصف المصدر ولكل ترجمة له.
_wpml_import_language_code. رمز لغة ISO للصف (en للغة الإنجليزية، وes للإسبانية، وfr للفرنسية، وpt-pt للبرتغالية الأوروبية، وهكذا).
_wpml_import_source_language_code. في صفوف الترجمة فقط؛ رمز لغة الأصل. اتركه فارغاً لصفوف اللغة المصدر.

بالنسبة لإضافة WP All Import Pro والأدوات المشابهة، أعدّ جدولي بيانات: أحدهما للتصنيفات (الفئات، والوسوم، وفئات المنتجات)، والآخر للمقالات والمنتجات. تأخذ أداة استيراد CSV الأصلية في WooCommerce جدول بيانات واحداً لأن فئات المنتجات موجودة داخل صفوف المنتجات.

سمات WooCommerce المخصصة للمنتجات المتغيرة

إذا كان لديك منتجات متغيرة ذات سمات مخصصة، أضف عموداً رابعاً إلى صفوف المنتجات المترجمة: _wpml_import_wc_local_attribute_labels. القيمة هي كائن JSON لأزواج slug:translation. بالنسبة لمنتج متغير باللغة الفرنسية بسمات Size و Color:

{"size":"Taille","color":"Couleur"}

المعرّف النصي للرابط هو اسم السمة بأحرف صغيرة مع استبدال المسافات بشرطات.

ترتيب الاستيراد

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

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

تعيين أعمدة اللغة في إضافة الاستيراد

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

للمقالات والمنتجات. افتح حقول مخصصة، وأضف ثلاثة حقول، واسحب أعمدة اللغة إلى مربعات Value، واستخدم أسماء الأعمدة بدون أقواس في مربعات Name.
للتصنيفات. افتح بيانات المصطلح الوصفية، وأضف ثلاثة حقول لبيانات المصطلح الوصفية، وعيّن أعمدة اللغة بنفس الطريقة.

إذا لم يتم تعيين الأعمدة، فلن يجد WPML شيئاً ليقرأه عند تشغيل خطوة الربط.

ما ستراه بين الاستيراد وخطوة الربط

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

بالنسبة لإضافات الاستيراد غير المدعومة، ستحتاج إلى نشر المقالات يدوياً بعد الانتهاء من خطوة الربط.

تشغيل استيراد WPML

بمجرد انتهاء إضافة الاستيراد:

افتح WPML > تصدير واستيراد WPML في لوحة تحكم WordPress.
انقر على تشغيل استيراد WPML.

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

قم بإجراء فحص عشوائي في الواجهة الخلفية والواجهة الأمامية:

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

إذا لم ترتبط ترجمة التصنيف، فافتح المصطلح في لوحة تحكم WordPress واستخدم مربع اللغات الخاص بالمصطلح لربطه بمصطلح اللغة الافتراضية.

أتمتة العملية – تشغيل استيراد WPML بعد كل استيراد مجدول

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

الخيار 1 – نقطة نهاية POST (لعمليات الاستيراد المعتمدة على Cron مثل الإجراءات المجدولة في WP All Import)

هذه هي الطريقة الموصى بها. أضف مفتاحاً سرياً قوياً إلى wp-config.php:

define( 'WPML_IMPORT_KEY', 'your-strong-secret-key-here' );

ثم أضف أمراً ثانياً إلى إعداد الاستيراد المجدول الخاص بك. يرسل هذا الأمر طلب POST إلى موقعك ويمرر المفتاح في نص الطلب:

curl -X POST https://yoursite.com/ \
  -d 'wpml_import_trigger=your-strong-secret-key-here'

نفس الاستدعاء باستخدام wget:

wget -q -O - \
  --post-data='wpml_import_trigger=your-strong-secret-key-here' \
  https://yoursite.com/

بالنسبة للجدولة اليدوية في WP All Import Pro، أضف أياً من الأمرين مباشرة بعد أمر الاستيراد.

عند تشغيل خطوة الربط، يجيب موقعك بالحالة 200 وهذه الرسالة:

Import process completed

هناك إجابتان أخريان تخبرانك بما حدث: 401 تعني أن المفتاح غير متطابق، و 204 تعني أنه لم يتبق شيء لمعالجته.

الخيار 2 – نقطة نهاية URL (مهمل)

قبل الإصدار 1.2.0 من إضافة تصدير واستيراد WPML، كنت تمرر المفتاح في عنوان URL:

https://yoursite.com/?wpml_import_trigger=your-strong-secret-key-here

لا يزال عنوان URL هذا يعمل، لذا تستمر مهام cron الحالية في العمل. إنه مهمل، وسيقوم WPML بإزالته في الإصدار الرئيسي التالي.

السبب هو المفتاح. ينتقل عنوان URL عبر سجلات الخادم، وسجل المتصفح، والتحليلات، وينتقل مفتاحك معه. يحافظ طلب POST على المفتاح في نص الطلب. انقل عمليات الاستيراد المجدولة إلى استدعاء POST في الخيار 1.

الخيار 3 – خطّاف الإجراء (لعمليات الاستيراد المجدولة عبر PHP)

إذا كنت تجدول عمليات الاستيراد من PHP باستخدام Action Scheduler أو wp_schedule_single_event، فشغّل خطوة WPML باستدعاء إجراء واحد:

do_action( 'wpml_import_process' );

لتشغيلها كمهمة خلفية لمرة واحدة مباشرة بعد إجراء الاستيراد الخاص بك:

wp_schedule_single_event( time(), 'wpml_import_process' );

إذا فشل شيء ما في أي من هذه المسارات، فقم بتشغيل WP_DEBUG_LOG في wp-config.php لالتقاط الخطأ في سجل أخطاء PHP.

تشغيل استيراد WPML من سطر الأوامر

بالنسبة لبرامج النشر النصية، أو بناء الحاويات، أو أي مسار لا تتوفر فيه واجهة مستخدم لوحة التحكم، قم بتشغيل خطوة الربط من WP-CLI:

wp wpml import process

يُبلغ الأمر عن عدد الترجمات التي تم ربطها. إنه بديل مباشر لزر تشغيل استيراد WPML.

المزالق الشائعة

ملف الاستيراد يفتقد إلى أعمدة اللغة الثلاثة. يُستورد المحتوى ولكنه يستقر كصفوف لغة مصدر غير موسومة؛ لا يجد تشغيل استيراد WPML أي شيء لربطه. الإصلاح: أضف الأعمدة إلى بيانات المصدر الخاصة بك، وأعد التصدير، ثم أعد الاستيراد.
تم تخطي تعيين حقول مخصصة / بيانات المصطلح الوصفية في WP All Import. نفس نتيجة الأعمدة المفقودة. البيانات موجودة في الملف ولكن إضافة الاستيراد لم تخزنها في المقالة. أعد تشغيل الاستيراد مع تعيين الحقول.
لم يتم إعداد اللغات الهدف على موقع الاستيراد. تستقر الصفوف المستوردة للغة غير مهيأة في اللغة الافتراضية. أضف اللغات المفقودة في WPML > إعدادات > اللغات أولاً، ثم أعد التشغيل.
إضافة استيراد غير مدعومة. تظل المقالات المستوردة في حالة مسودة بعد خطوة الربط. انشرها يدوياً، أو بدّل إلى إضافة مدعومة.
برامج الاستيراد النصية المخصصة التي لا تمرر بيانات اللغة. الإصلاح يكون على مستوى البرنامج النصي. يجب أن تصل أعمدة اللغة الثلاثة (وعمود سمة WooCommerce عند الاقتضاء) إلى الصف.

إذا استمرت عمليات الاستيراد في التعثر بسبب نفس المشكلة، فإن فريق دعم WPML يجيب على أسئلة الاستيراد على مدار الساعة طوال أيام الأسبوع.

إذا كنت تبحث عن إضافة WPML All Import

إن WPML All Import هي الإضافة القديمة التي تسبق تصدير واستيراد WPML. ولم تعد مدعومة أو موصى بها. الإجراء المذكور أعلاه هو الطريقة المُحدّثة لاستيراد المحتوى متعدد اللغات إلى موقع WordPress – استخدمه بدلاً من أي سير عمل موصوف في وثائق الإضافة القديمة.