ترحيل المحتوى متعدد اللغات من CSV إلى دروبال 8

نشرت: 2021-07-13

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

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

استيراد CSV

سوف تحتاج 8 وحدات ترحيل دروبال

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

  1. ترحيل: يوفر إطارًا مرنًا لترحيل المحتوى إلى دروبال من مصادر أخرى.
  2. ترحيل زائد: يوفر المكونات الإضافية لعمليات الترحيل مثل المكونات الإضافية المصدر ، والمكونات الإضافية للعملية ، والمكونات الإضافية للوجهة ، وامتدادات واجهة برمجة التطبيقات.
  3. ترحيل دروبال: يوفر دعمًا لترحيل المحتوى والتكوينات.
  4. ترحيل مصدر CSV: يوفر مكونًا إضافيًا لاستيراد محتويات إلى دروبال من ملف CSV.
  5. أدوات الترحيل: توفر هذه الوحدة أدوات واجهة المستخدم وأوامر Drush المستخدمة في الترحيل.
  6. وحدة تطوير التكوين: تقوم هذه الوحدة بتحويل البرنامج النصي إلى تكوينات.

الخطوة 1: ترحيل المحتوى الأساسي

للبدء بترحيل المحتوى الأساسي ، سنحتاج أولاً إلى إنشاء وحدة مخصصة في دروبال 8.

إنشاء وحدة مخصصة

تأكد من أن info.yml يحتوي على هذه المفاتيح والقيم.

ستحتاج إلى إنشاء ملفات yaml ، والتي تُعرف باسم البرامج النصية للترحيل ، ووضعها في دليل config / install الخاص بالوحدة النمطية المخصصة التي تم إنشاؤها. يجب أن يحتوي مفتاح config_devel / install الخاص بـ info.yml على جميع ملفات yaml مكتوبة.

ملف Yaml

هذا نموذج لملف yaml لاستيراد مصطلحات التصنيف. يحتوي نص الترحيل على 4 أقسام:

  1. البيانات الوصفية: سيكون لها المعرف والتسمية ومعرف مجموعة الترحيل.
  2. المصدر: يجب أن يحتوي مفتاح المصدر على المسار إلى ملف CSV.
  3. العملية: التعيين بين الحقول وأعمدة CSV.
  4. الوجهة: الوجهة حيث يتم حفظ البيانات المستوردة.

يجب كتابة محتويات عقدة ملف yaml بالمثل. الاختلاف الوحيد هو الوجهة.

عقدة الكيان

يجب أن يكون المكون الإضافي الوجهة كيانًا: العقدة والحزمة الافتراضية سيكون لها اسم الجهاز لنوع المحتوى الذي يتم استيراد المحتوى إليه.

بعد إنشاء جميع ملفات yaml ، يجب تضمين معرفات yaml في ملف info.yml . بمجرد الانتهاء من كل شيء ، قم بتمكين الوحدة المخصصة.

استخدم Drush الأمر drush cdi <معرف الهجرة> . هنا معرف الترحيل هو ترحيل techx . سيؤدي هذا إلى تحويل البرنامج النصي إلى تكوينات.

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

عمليات

سيؤدي النقر فوق علامة تبويب التنفيذ إلى إظهار قائمة العمليات المتاحة:

العمليات المتاحة

الاستيراد هو سحب البيانات من المصدر.

سيؤدي التراجع إلى حذف البيانات المستوردة.

التوقف هو مقاطعة عملية الاستيراد أو التراجع.

في بعض الأحيان تتعطل العملية. لنقل الحالة إلى الخمول ، يتم استخدام إعادة التعيين .

للحصول على معلومات أكثر تفصيلاً حول كيفية ترحيل بيانات الكيانات المختلفة مثل المستخدم ، فقرة ، تحقق من استيراد ملف CSV إلى ترحيل دروبال 7 إلى 8 - دليل كامل.

الخطوة 2: ترحيل ترجمات المحتوى الأساسي

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

1. إضافة لغة إلى موقع دروبال

لاستيراد الترجمات ، يجب أولاً أن نجعل موقعنا متعدد اللغات. دعونا نرى كيفية تنزيل اللغات على الموقع.

  1. قم بتمكين وحدة ترجمة اللغة والمحتوى . هذه هي الوحدات الأساسية.
  2. انتقل إلى / admin / config / Regional واللغة / اللغة / إضافة لغة.إضافة لغة
  3. يمنحك النقر فوق القائمة المنسدلة قائمة باللغات. حدد اللغة التي تريدها في الموقع وانقر فوق إضافة لغة . سيؤدي هذا إلى تنزيل اللغة لموقعك.

2. تمكين الترجمة للجهات

بمجرد تثبيت اللغات التي نحتاجها ، يجب علينا تمكين الترجمات للكيانات قبل استيراد أو إضافة الترجمات إلى المحتوى. لهذا ، انتقل إلى admin / config / Regional / content translation . حدد الكيانات التي تريد تمكين الترجمة إليها وانقر فوق حفظ التكوينات .

في هذا المثال ، أقوم باستيراد نوع محتوى المدونة ، وبالتالي سأقوم بتمكين الترجمة لنوع محتوى المدونة.

لغة

3. قم بتحديث ملفات الترحيل

هناك بعض التغييرات التي يجب إجراؤها على ملفات yaml لاستيراد الترجمات. أعط مسار ملف CSV للمحتوى المترجم كمحتويات أساسية ويتم تخزين المحتويات المترجمة في ملفات مختلفة. التغييرات في ترجمة المصطلحات.

مرتبة

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

لترحيل العقدة ، أضف nid مفتاح جديد في قسم العملية. هنا سيكون لمفتاح الترحيل قيمة معرّف الترحيل الخاص بالنص الأساسي لترحيل المحتوى.

معرف المصدر

يجب إضافة مفتاح آخر وهو الترجمات مع ضبط القيمة على " صواب" . يجب إضافة هذا في قسم الوجهة لجميع نصوص ترحيل الترجمة بغض النظر عن الكيانات.

الوجهة

حدد اللغة التي يتم استيراد الترجمة إليها باستخدام مفتاح langcode . في هذا المثال ، أقوم باستيراد الترجمات اليابانية ، لذا ستكون القيمة ja .

لانكود

تخبر هذه التغييرات البرنامج النصي بأخذ معرف المحتوى من ترحيل المحتوى الأساسي الذي يتم التعامل مع هذه المحتويات منه على أنها ترجمات بدلاً من عقدة جديدة.

نقطة لنتذكر

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