WPML

מדריך זה מיועד לחנויות שהקטלוג שלהן מנוהל מחוץ ל־WordPress: בגיליון אלקטרוני, ב־PIM, ב־ERP או בפיד ספקים. מוצרים מגיעים אל WooCommerce באמצעות כלי ייבוא, ה־REST API או משימה מתוזמנת, ואתה כמעט ולא פותח את עורך המוצרים.

אתה זקוק ל־WPML, ל־WPML Multilingual & Multicurrency for WooCommerce, ועבור ייבוא עם תרגומים, לייצוא וייבוא של WPML.

חלק 1. כיצד פועלת חנות רב-לשונית המנוהלת מבחוץ

מוצר אחד לכל שפה, מקושרים על ידי קבוצת תרגום

לכל שפה יש מוצר WooCommerce משלה, עם מזהה (ID) משלה. WPML מקשר את השפות בקבוצת תרגום. המקור הוא המוצר בשפת ברירת המחדל של החנות שלך; השפות האחרות הן התרגומים שלו.

בחנות הדוגמה שלנו, קפוצ'ון הרוכסן הוא מוצר 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הגדרותריבוי מטבעות, סמן את הפעל את מצב ריבוי מטבעות ולחץ על שמור שינויים. תחת הצג מטבעות על בסיס, בחר אפשרות (לדוגמה שפת האתר) ולחץ על שמור שינויים. לאחר מכן הוסף כל מטבע באמצעות הוסף מטבע. כאשר ריבוי מטבעות כבוי, 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 מתחזקתרגום עם טקסט משלו
הטקסט לאחר השמירה הבאה של המקורמוחלף בטקסט של המקורנשמר רק כאשר 'תרגם הכל' כבוי או כאשר מוצרים מוגדר כללא
מחיר ומלאיעוקבים אחר המקורעוקבים אחר המקור

הגדרת החנות לפני הגעת המוצר הראשון

  1. הפעל את אשף ההגדרה של WooCommerce Multilingual. הוא נפתח כאשר אתה מפעיל את התוסף WPML Multilingual & Multicurrency for WooCommerce. המסכים שלו הם Store Pages, Global Attributes ו־Multiple Currencies. הראשון יוצר את העמודים חנות, עגלת קניות, קופה והחשבון שלי בכל שפה.
  2. הפוך את התכונות הגלובליות שלך לניתנות לתרגום. במסך האשף "Which product attributes should be translatable?", סמן כל תכונה, לדוגמה Color ו־Size. מאוחר יותר, אותה הגדרה היא תיבת הסימון Translatable? תחת מוצריםתכונותעריכה.
  3. תרגם את מונחי התכונות לפני המוצרים. עבור אל WPMLתרגומים, פתח את הכרטיסייה טקסונומיה, בחר את התכונה תחת "Select the taxonomy to translate" ותרגם כל מונח. כאשר המצב תרגם הכל מופעל (תהליך A), WPML מתרגם עבורך מונחים חדשים.

חלק 2. בנייה ללא קוד

בחירת התהליך שלך: שפה אחת או כל שפה

תהליך A: WPML מתרגםתהליך B: אתה מייבא כל שפה
מה המערכת שלך מכילהשפת ברירת מחדל של החנות בלבדכל שפה
מה אתה מייבאמוצרים מקורייםמקורות והתרגומים שלהם, מקושרים לפי SKU
מי מתרגםתרגם הכל, עם Private Translation Cloud (PTC) (נפתח בלשונית חדשה)המתרגמים שלך, לפני הייבוא
כאשר הטקסט של מקור משתנהתרגם הכל מתרגם את השינויWPML מסמן את התרגום כדורש עדכון; הקובץ הבא שלך מביא את הטקסט החדש
מחירים ומלאיעוקבים אחר המקורעוקבים אחר המקור

תהליך A מתאים לחנות ששומרת שפה אחת ורוצה כל שפה אחרת ללא קובצי תרגום. תהליך B מתאים לחנות שבה ה־PIM או המתרגמים כבר מחזיקים בטקסטים בכל שפה.

תהליך A עם כלי הייבוא מקובץ CSV של WooCommerce או WP All Import

הפעל את תרגם הכל פעם אחת:

  1. עבור אל WPMLתרגומים ולחץ על הגדר תרגם הכל.
  2. בחר את התוכן. תחת "Content to Translate", השאר את All products ולחץ על המשך.
  3. בחר כיצד תרגומים מתפרסמים. תחת "Publishing method", השאר את Publish without review.
  4. לחץ על הפעלת תרגם הכל אוטומטית.

ייבא את המוצרים שלך בשפת ברירת המחדל של החנות בלבד. השתמש במוצריםייבוא (כלי הייבוא מקובץ CSV של WooCommerce) או ב־All ImportNew Import (WP All Import עם התוסף הנלווה שלו ל־WooCommerce). הקובץ שלך אינו זקוק לעמודות WPML.

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

כאשר אתה עורך מקור, תרגם הכל מתרגם רק את מה שהשתנה. שאר התרגום נשאר מילה במילה.

תרגם הכל מתרגם מוצרים שפורסמו, כולל מוצרים חיצוניים. הוא אינו מתרגם מוצרים פרטיים. גם טיוטות ממתינות: ההגדרה Translate drafts automatically (תחת WPMLהגדרותתרגום AI, בתיבה של עורך תרגום מתקדם) כבויה כברירת מחדל, וכאשר אתה מפעיל אותה, WPML מתרגם טיוטה רק כאשר אתה שומר אותה שוב. כדי לתרגם טיוטות ומוצרים פרטיים, שלח אותם מתוך WPMLתרגומים (ראה פתרון בעיות).

אם ברצונך לשנות תרגום, פתח אותו מתיבת השפה של המוצר (Edit the ... translation), ערוך אותו בתוך עורך תרגום מתקדם ולחץ על Save and Complete. כאשר המקור ישתנה מאוחר יותר, העריכה שלך למשפטים שלא השתנו תישאר.

תהליך B עם כלי הייבוא מקובץ CSV של WooCommerce

בתהליך B, הקובץ שלך מכיל כל שפה.

הגדר את תרגם הכל עבור תרגומים מיובאים לפני הייבוא הראשון:

  1. עבור אל WPMLתרגומים. אם תרגם הכל כבוי, השאר אותו כבוי והמשך לקובץ.
  2. אם ברצונך ש־WPML יתרגם את העמודים, הפוסטים והמחרוזות שלך אוטומטית, לחץ על הגדר תרגם הכל. תחת "Content to Translate", הגדר את Products ל־None. לחץ על המשך, השאר את Publish without review ולחץ על הפעלת תרגם הכל אוטומטית.
  3. אם תרגם הכל כבר מופעל, לחץ על תפריט שלוש הנקודות בתיבה "Translate Everything Automatically is enabled", בחר ב־Adjust content limits, הגדר את Products ל־None ולחץ על שמור שינויים. תרגומים שכבר נמצאים בתהליך עדיין יסתיימו.

כאשר Products מוגדר ל־None, 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. המסך מציג את ההודעה "Good job. We see 33 posts that are imported and need language information.". לחץ על Run WPML Import.
  4. המתן להודעה "Multilingual Import Complete".

עד שלב 3, כל מוצר הוא טיוטה באנגלית וכל וריאציה היא וריאציה באנגלית, ואף אחד מהם אינו מקושר למקור שלו. לאחר מכן:

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

כדי ש־WPML יתרגם מוצרים נבחרים אוטומטית בעוד שהאפשרות 'מוצרים' מוגדרת למצב ללא:

  1. השאר את מצב תרגם הכל מופעל.
  2. הוסף את העמודה Meta: _wpml_import_tea לקובץ, עם הערך 1 בכל מוצר המיועד לתרגום.
  3. השאר את Meta: _wpml_import_translation_group באותו קובץ.
  4. ייבא את הקובץ, לאחר מכן עבור אל WPMLייצוא וייבוא של WPML ולחץ על Run WPML Import. רשימת ההתקדמות מציגה "Sending Posts for Automatic Translation", ו־WPML מתרגם ומפרסם את המוצרים האלה.

תהליך ב' עם WP All Import

עליך להשתמש ב־WP All Import Pro ובתוסף הנלווה שלו ל־WooCommerce. הגרסה החינמית אינה מייבאת שדות מותאמים אישית, ועמודות WPML הן שדות מותאמים אישית.

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

  1. קשר את המונחים המתורגמים שכבר קיימים בחנות. עבור כל מונח תכונה מתורגם שכבר קיים בחנות, עבור אל מוצריםתכונות, לחץ על הגדר מונחים עבור התכונה, החלף את שפת סרגל הניהול לשפה של המונח ולחץ על שם המונח. בתיבה 'שפה', בחר את המקור שלו תחת זהו תרגום של ולחץ על עדכן. כל מונח מקושר יציג לאחר מכן עיפרון תחת השפה שלו בנתיב WPMLתרגומיםטקסונומיה.
  2. הגדר את שפת אזור הניהול לשפת ברירת המחדל של החנות בבורר השפות של סרגל הניהול לפני הפעלת הייבוא.
  3. ייבא את הקטגוריות. All ImportNew ImportUpload a file, בחר TaxonomiesProduct categories. תחת Term Meta, הוסף שלוש שורות: _wpml_import_language_code, _wpml_import_source_language_code ו־_wpml_import_translation_group, כל אחת מהן ממופה לעמודה בעלת אותו שם בקובץ. הגדר את פריט האב תחת Other Category OptionsParent Term.
  4. ייבא את מונחי התכונות באותה דרך, לדוגמה TaxonomiesProduct Color, עם אותן שלוש שורות של Term Meta.
  5. קשר את המונחים. עבור אל WPMLייצוא וייבוא של WPML ולחץ על Run WPML Import. בדוק תחת WPMLתרגומיםטקסונומיה (בחר את הטקסונומיה ב־"בחר את הטקסונומיה לתרגום") שלכל מונח יש שורה אחת עם עיפרון תחת הדגל של כל שפה. רחף מעל עיפרון כדי לראות את השם המתורגם. סימן "+" משמעותו שלאותה שפה אין תרגום. מונח מתורגם המופיע בשורה משלו אינו מקושר.
  6. ייבא את המוצרים. בחר WooCommerce Products. במקטע WooCommerce Add-On, מפה את המק"ט, המחירים, המלאי והתכונות. תחת Custom Fields, הוסף את שלוש שורות ה־_wpml_import_*.
  7. לחץ שוב על Run WPML Import, והמתן להודעה Multilingual Import Complete.

קובץ המונחים לדוגמה שלנו:

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 Add-On.
  3. ב־Import Settings, סמן את 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. תרגם הכל מתרגם מוצרים חדשים לכל שפה (תהליך A).
  4. מוצר שהמחבר מגדיר כטיוטה עובר לטיוטה בכל שפה.
  5. מוצר שהמחבר מוחק פועל לפי WPMLהגדרותמחיקת תוכן, בשורה מוצרים. אף אחד לא נשאל במהלך סנכרון, לכן הגדר את מחיקת מקור להתנהגות הרצויה לך: מחק את כל השפות מסיר את התרגומים יחד איתו; רק את זה שומר אותם מפורסמים.

שאל את ספק המחבר שלך שלוש שאלות:

  1. האם הוא כותב דרך WooCommerce, או ישירות למסד הנתונים? שינויים שנכתבים ישירות למסד הנתונים מגיעים למקור בלבד. התרגומים שומרים על המלאי והמחירים הישנים.
  2. לאיזו שפה הוא כותב? עליו לכתוב למקור. מחיר שנכתב לתרגום אינו נשמר: התרגום שומר את המחיר של המקור.
  3. האם הוא יוצר מוצר אחד לכל שפה? WooCommerce מסרב למוצר שני עם אותו SKU. ללא ה־SKU, העותקים הם מוצרים נפרדים שאינם מקבלים עדכוני מלאי או מחיר. אפשר למחבר ליצור את המקור בלבד, ותן ל־WPML לתרגם אותו.

חלק 3. בניית תהליכים מותאמים אישית (למפתחים)

יצירת מוצר והתרגומים שלו באמצעות ה־REST API של WooCommerce

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

התייחסות מלאה לשדות: WooCommerce Multilingual REST API.

עדכון מוצרים באמצעות ה־REST API של WooCommerce

עדכן את המקור. 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. אם 'תרגם הכל' מופעל, הגדר את 'מוצרים' ל'ללא'. במסך WPMLתרגומים, לחץ על תפריט שלוש הנקודות בתיבה "תרגם הכל אוטומטית מופעלת", בחר Adjust content limits, הגדר את Products ל־None ולחץ על שמור שינויים.
  3. ייבא את התרגומים שלך שוב.

לאחר מכן, שמירת המקור שומרת על הטקסט המיובא.

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

מוצרים מתורגמים מציגים ערכי תכונות בשפה המקורית

מה שאתה רואה: דף המוצר המתורגם מציע "Blue", "Green" במקום המונחים המתורגמים.

למה זה קורה: המוצרים תורגמו לפני שמונחי התכונות שלהם תורגמו.

כיצד לתקן זאת כעת:

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

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

כיצד להימנע מכך: תרגם מונחי תכונות לפני שאתה מתרגם או מייבא מוצרים.

קטגוריות או מונחים מתורגמים נושאים את השמות המקוריים לאחר ייבוא

מה שאתה רואה: מוצר מתורגם נמצא בקטגוריה בשם "Sunglasses" או מציע "Blue" בחנות המתורגמת.

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

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

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

מלאי או מחירים בשפות אחרות מפגרים מאחורי המקור

מה שאתה רואה: המקור מציג את המלאי או המחיר החדשים, והתרגומים מציגים את הישנים.

למה זה קורה: השינוי עקף את WooCommerce או את WPML:

כיצד לדעת: פתח את המקור בעורך המוצר. מתחת לעורך התיאור מופיע הכיתוב "נערך לאחרונה ב" עם תאריך ושעה. אם השעה הזו ישנה יותר מהמחיר או המלאי החדשים בתיבת נתוני המוצר, או שהשינוי בוצע בזמן ש־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 מגיעים לשפה או לקבוצה הלא נכונות

מה שאתה רואה: תרגום מופיע בשפה הלא נכונה, או כמוצר נפרד ללא מק"ט וללא קישור למקור.

למה זה קורה:

כיצד לתקן זאת כעת: שלח את המוצר שוב עם השפה הנכונה והקישור, עם PUT /wc/v3/products/<id>:

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

המוצר עובר לקבוצה של המקור ומקבל את המק"ט, המחיר והמלאי שלו. עבור מוצר עם וריאציות, WPML מחליף את הווריאציות שנוצרו ללא קישור בווריאציות חדשות ומקושרות. קרא בחזרה את מזהי ה־ID החדשים של הווריאציות.

כיצד להימנע מכך: שלח lang ו־translation_of בכל תרגום, צור תחילה את המונחים, ואפשר ל־WPML ליצור את הווריאציות של התרגומים.

מוצרים מיובאים חדשים אינם מתורגמים אוטומטית

מה שאתה רואה: מוצרים מיובאים נשארים בשפה המקורית בלבד.

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

כיצד לתקן זאת כעת:

כיצד להימנע מכך: הפעל את 'תרגם הכל' לפני הייבוא (תהליך A), וייבא מוצרים כשהם מפורסמים.

נכתב על ידיAmir