כיצד לייבא תוכן רב-לשוני לתוך 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. עבור כל השאר, צור מזהה (ID) משלך והשתמש בו שוב עבור שורת המקור וכל תרגום שלה.
• _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"}

מזהה הכתובת (slug) הוא שם התכונה באותיות קטנות, כאשר רווחים מוחלפים במקפים.

סדר הייבוא

תמיד ייבא טקסונומיות תחילה כאשר יש לך קובץ נפרד עבורן. קטגוריות, תגיות וכל טקסונומיה אחרת חייבות להיות קיימות לפני שפוסטים ומוצרים יוכלו להפנות אליהן. לאחר מכן ייבא פוסטים, עמודים, מוצרים וסוגי תוכן אחרים.

אם אתה מפצל את הנתונים שלך לקובץ אחד לכל שפה, ייבא כל קובץ שפה לפני הפעלת שלב החיבור של WPML.

מיפוי עמודות השפה בתוסף הייבוא שלך

כל תוסף ייבוא מטפל בעמודות מותאמות אישית בדרך שלו. השלב הקריטי הוא מיפוי שלוש עמודות WPML לשדות מותאמים אישית (או למטא של מונח, עבור טקסונומיות). ב־WP All Import Pro, זה קורה בשלב 3 של אשף הייבוא:

• עבור פוסטים ומוצרים. פתח את Custom Fields, הוסף שלושה שדות, גרור את עמודות השפה לתיבות Value, והשתמש בשמות העמודות ללא סוגריים בתיבות Name.
• עבור טקסונומיות. פתח את Term Meta, הוסף שלושה שדות מטא של מונח, ומפה את עמודות השפה באותה דרך.

אם העמודות אינן ממופות, ל־WPML אין מה לקרוא כאשר אתה מפעיל את שלב החיבור.

מה תראה בין הייבוא לשלב החיבור

עד שתפעיל את ייצוא וייבוא של WPML, כל התוכן המיובא יושב תחת שפת ברירת המחדל שלך, ו־WPML מחזיק אוטומטית פוסטים ומוצרים בסטטוס טיוטה כדי למנוע הצגת תוכן מעורב-שפות בצד הלקוח. זהו מצב הביניים הצפוי, ולא סימן לייבוא שנכשל.

עבור תוספי ייבוא שאינם נתמכים, תצטרך לפרסם פוסטים באופן ידני לאחר סיום שלב החיבור.

הפעלת ייבוא של WPML

לאחר שתוסף הייבוא סיים:

1. פתח את WPML > ייצוא וייבוא של WPML באזור הניהול של WordPress.
2. לחץ על Run WPML Import.

WPML קורא את עמודות השפה של כל שורה, מקצה את השפה לאותה שורה, ומקשר את התרגומים למקור שלהם. בקטלוגים גדולים תהליך זה עשוי להימשך מספר דקות. בסיום, התוכן המיובא שלך מפורסם בשפה הנכונה כשכל תרגום מחובר למקור שלו.

בצע בדיקה מדגמית באזור הניהול ובצד הלקוח:

• פתח את רשימת סוגי הפוסטים או המוצרים – ודא שכל שורה מופיעה תחת דגל השפה הנכון.
• בקר בצד הלקוח והחלף שפות – כל עמוד מתורגם אמור לטעון את הגרסה המתורגמת שלו, ולא לחזור לשפת המקור.

אם תרגום טקסונומיה לא קושר בהצלחה, פתח את המונח באזור הניהול של WordPress והשתמש בתיבת השפות של המונח כדי לחבר אותו למונח בשפת ברירת המחדל.

אוטומציה – הפעלת WPML Import לאחר כל ייבוא מתוזמן

עבור סנכרונים ליליים, פידים של ספקים או כל ייבוא מתוזמן, שלב הקישור של WPML יכול לרוץ אוטומטית מיד לאחר סיום הפעולה של תוסף הייבוא. ישנן שלוש דרכים להגדיר זאת:

אפשרות 1 – נקודת קצה של POST (עבור ייבוא מבוסס Cron כמו WP All Import Scheduled Actions)

זוהי הדרך המומלצת. הוסף מפתח סודי חזק ל־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 Import משורת הפקודה

עבור סקריפטים של פריסה, בניית קונטיינרים או כל תהליך שבו ממשק המשתמש של אזור הניהול אינו זמין, הפעל את שלב הקישור מ־WP-CLI:

wp wpml import process

הפקודה מדווחת כמה תרגומים חוברו. זהו תחליף ישיר לכפתור Run WPML Import.

בעיות נפוצות

• קובץ הייבוא חסר את שלוש עמודות השפה. התוכן מיובא אך נוחת כשירות בשפת המקור ללא תגיות; ל־Run WPML Import אין מה לקשר. פתרון: הוסף את העמודות לנתוני המקור שלך, ייצא מחדש וייבא מחדש.
• המיפוי של שדות מותאמים אישית / מטא של מונח ב־WP All Import דולג. אותה תוצאה כמו עמודות חסרות. הנתונים נמצאים בקובץ אך תוסף הייבוא לא שמר אותם בפוסט. הפעל מחדש את הייבוא כשהשדות מופו.
• שפות היעד אינן מוגדרות באתר הייבוא. שורות מיובאות עבור שפה שאינה מוגדרת נוחתות בשפת ברירת המחדל. הוסף תחילה את השפות החסרות דרך WPML > הגדרות > שפות, ולאחר מכן הפעל מחדש.
• תוסף ייבוא שאינו נתמך. פוסטים מיובאים נשארים בסטטוס טיוטה לאחר שלב הקישור. פרסם אותם באופן ידני, או עבור לתוסף נתמך.
• סקריפטים מותאמים אישית לייבוא שאינם מעבירים את נתוני השפה. התיקון הוא ברמת הסקריפט. שלוש עמודות השפה (ועמודת התכונות של WooCommerce, במידת הרלוונטיות) חייבות להגיע לשורה.

אם ייבוא ממשיך להיתקל באותה בעיה, צוות התמיכה של WPML עונה על שאלות בנושא ייבוא 24/7.

אם חיפשת את התוסף WPML All Import

WPML All Import הוא התוסף הישן שקדם לייצוא וייבוא של WPML. הוא אינו נתמך או מומלץ יותר. התהליך שתואר לעיל הוא הדרך העדכנית לייבא תוכן רב־לשוני לאתר WordPress – השתמש בו במקום בכל תהליך עבודה שמתואר בתיעוד של התוסף הישן.