שמור על קטלוג WooCommerce רב-לשוני מעודכן כאשר מוצרים מגיעים באמצעות ייבוא CSV, WP All Import, ה־REST API או סנכרון ERP.
עודכן: 16 בנובמבר 2026
מדריך זה מיועד לחנויות שהקטלוג שלהן מנוהל מחוץ ל־WordPress: בגיליון אלקטרוני, ב־PIM, ב־ERP או בפיד ספקים. מוצרים מגיעים אל WooCommerce באמצעות כלי ייבוא, ה־REST API או משימה מתוזמנת, ואתה כמעט ולא פותח את עורך המוצרים.
לכל שפה יש מוצר 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 נשמר כאשר ריבוי מטבעות מופעל והמטבע הוא אחד ממטבעות החנות שלך. שלח אותו באופן הבא:
הפעל תחילה ריבוי מטבעות. עבור אל WPML ← הגדרות ← ריבוי מטבעות, סמן את הפעל את מצב ריבוי מטבעות ולחץ על שמור שינויים. תחת הצג מטבעות על בסיס, בחר אפשרות (לדוגמה שפת האתר) ולחץ על שמור שינויים. לאחר מכן הוסף כל מטבע באמצעות הוסף מטבע. כאשר ריבוי מטבעות כבוי, WPML לא שומר דבר מ־custom_prices.
השתמש בקודי המטבעות של החנות שלך. WPML שומר את המחירים של מטבעות החנות בלבד. מחיר בכל קוד אחר אינו נשמר.
עבור מוצר עם וריאציות, שלח את custom_prices בכל וריאציה, לא במוצר האב. WPML שומר אותו בווריאציה המקורית, וכל שפה מציגה אותו. אם יישלח במוצר האב, הוא לא יישמר.
קרא את המחירים השמורים מ־meta_data (_regular_price_USD, _sale_price_USD, _price_USD). התשובות לקריאות REST אינן כוללות שדה custom_prices.
עותקים משוכפלים או תרגומים עצמאיים
ל־WPML יש שני סוגים של מוצרים מתורגמים. הסוג שיש לך קובע מה קורה לטקסט שאתה מייבא.
עותק משוכפל
תרגום עצמאי
מה זה
עותק ש־WPML מתחזק
תרגום עם טקסט משלו
הטקסט לאחר השמירה הבאה של המקור
מוחלף בטקסט של המקור
נשמר רק כאשר 'תרגם הכל' כבוי או כאשר מוצרים מוגדר כללא
מחיר ומלאי
עוקבים אחר המקור
עוקבים אחר המקור
היכן תראה זאת: תיבת השפה של עותק משוכפל מציגה את ההודעה "This document is a duplicate of ... and it is maintained by WPML." עם הלחצן תרגום באופן עצמאי.
הפיכת עותקים משוכפלים לתרגומים עצמאיים: לחץ על תרגום באופן עצמאי בתיבת השפה של העותק המשוכפל, או, עבור מוצרים רבים, עבור אל מוצרים ← כל המוצרים, עבור לשפת התרגום, סמן את המוצרים ובחר בפעולות מרובות ← תרגום באופן עצמאי.
מה התהליכים בחלק 2 יוצרים: תהליך A יוצר תרגומים באמצעות תרגם הכל. תהליך B מייבא תרגומים עצמאיים. אף אחד מהם אינו זקוק לעותקים משוכפלים.
הגדרת החנות לפני הגעת המוצר הראשון
הפעל את אשף ההגדרה של WooCommerce Multilingual. הוא נפתח כאשר אתה מפעיל את התוסף WPML Multilingual & Multicurrency for WooCommerce. המסכים שלו הם Store Pages, Global Attributes ו־Multiple Currencies. הראשון יוצר את העמודים חנות, עגלת קניות, קופה והחשבון שלי בכל שפה.
הפוך את התכונות הגלובליות שלך לניתנות לתרגום. במסך האשף "Which product attributes should be translatable?", סמן כל תכונה, לדוגמה Color ו־Size. מאוחר יותר, אותה הגדרה היא תיבת הסימון Translatable? תחת מוצרים ← תכונות ← עריכה.
תרגם את מונחי התכונות לפני המוצרים. עבור אל WPML ← תרגומים, פתח את הכרטיסייה טקסונומיה, בחר את התכונה תחת "Select the taxonomy to translate" ותרגם כל מונח. כאשר המצב תרגם הכל מופעל (תהליך A), WPML מתרגם עבורך מונחים חדשים.
WPML מסמן את התרגום כדורש עדכון; הקובץ הבא שלך מביא את הטקסט החדש
מחירים ומלאי
עוקבים אחר המקור
עוקבים אחר המקור
תהליך A מתאים לחנות ששומרת שפה אחת ורוצה כל שפה אחרת ללא קובצי תרגום. תהליך B מתאים לחנות שבה ה־PIM או המתרגמים כבר מחזיקים בטקסטים בכל שפה.
תהליך A עם כלי הייבוא מקובץ CSV של WooCommerce או WP All Import
הפעל את תרגם הכל פעם אחת:
עבור אלWPML ← תרגומים ולחץ על הגדר תרגם הכל.
בחר את התוכן. תחת "Content to Translate", השאר את All products ולחץ על המשך.
בחר כיצד תרגומים מתפרסמים. תחת "Publishing method", השאר את Publish without review.
לחץ על הפעלת תרגם הכל אוטומטית.
ייבא את המוצרים שלך בשפת ברירת המחדל של החנות בלבד. השתמש במוצרים ← ייבוא (כלי הייבוא מקובץ CSV של WooCommerce) או ב־All Import ← New 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, הקובץ שלך מכיל כל שפה.
הגדר את תרגם הכל עבור תרגומים מיובאים לפני הייבוא הראשון:
עבור אלWPML ← תרגומים. אם תרגם הכל כבוי, השאר אותו כבוי והמשך לקובץ.
אם ברצונך ש־WPML יתרגם את העמודים, הפוסטים והמחרוזות שלך אוטומטית, לחץ על הגדר תרגם הכל. תחת "Content to Translate", הגדר את Products ל־None. לחץ על המשך, השאר את Publish without review ולחץ על הפעלת תרגם הכל אוטומטית.
אם תרגם הכל כבר מופעל, לחץ על תפריט שלוש הנקודות בתיבה "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
סדר את השורות לפי שפה, מקורות תחילה. בכל שפה, מוצרים מופיעים לפני הווריאציות שלהם.
ייבא מוצרים כטיוטות:Published = -1 במוצרים, 1 בווריאציות.
תן לכל שפה את הטקסטים שלה: שמות, תיאורים, קטגוריות (Kleidung > Jacken) וערכי תכונות (Blau, Grün).
שמור על שמות התכונות של החנות (Color, Size) בכל שפה. תרגם את תוויות התכונות תחת WPML ← תרגומים ← טקסונומיה.
ספק מוצרים קשורים והורים לפי SKU, אותו SKU בכל שפה.
שורה בגרמנית של מוצר עם וריאציות מקובץ הדוגמה שלנו:
עבור אלמוצרים ← ייבוא ובחר את הקובץ תחת "בחר קובץ CSV מהמחשב שלך:". השאר את האפשרות עדכן מוצרים קיימים ללא סימון. לחץ על המשך.
בדוק את המיפוי. ארבע העמודות Meta: ממופות אל ייבא כמטא נתונים. לחץ על הפעל את המייבא.
עבור אלWPML ← ייצוא וייבוא של WPML. המסך מציג את ההודעה "Good job. We see 33 posts that are imported and need language information.". לחץ על Run WPML Import.
המתן להודעה "Multilingual Import Complete".
עד שלב 3, כל מוצר הוא טיוטה באנגלית וכל וריאציה היא וריאציה באנגלית, ואף אחד מהם אינו מקושר למקור שלו. לאחר מכן:
כל מוצר וכל וריאציה מקושרים בין השפות שלהם.
הכל מפורסם.
התרגומים הם תרגומים עצמאיים.
קטגוריות ומונחי תכונות מקושרים בין שפות, והווריאציות של כל שפה משתמשות במונחים משלהן.
מכירות משודרגות מצביעות על המוצר באותה שפה, ולכל שפה יש עותק משלה של התמונות.
קטגוריות ומונחי תכונות עוברים בתוך שורות המוצרים, כך שמייבא זה אינו זקוק לייבוא טקסונומיה נפרד. אם מונחי תכונות מתורגמים כבר קיימים בחנות, המייבא משתמש בהם, והפעולה Run WPML Import מקשרת אותם למקורות שלהם.
כדי ש־WPML יתרגם מוצרים נבחרים אוטומטית בעוד שהאפשרות 'מוצרים' מוגדרת למצב ללא:
השאר את מצב תרגם הכל מופעל.
הוסף את העמודה Meta: _wpml_import_tea לקובץ, עם הערך 1 בכל מוצר המיועד לתרגום.
השאר את Meta: _wpml_import_translation_group באותו קובץ.
ייבא את הקובץ, לאחר מכן עבור אל WPML ← ייצוא וייבוא של WPML ולחץ על Run WPML Import. רשימת ההתקדמות מציגה "Sending Posts for Automatic Translation", ו־WPML מתרגם ומפרסם את המוצרים האלה.
תהליך ב' עם WP All Import
עליך להשתמש ב־WP All Import Pro ובתוסף הנלווה שלו ל־WooCommerce. הגרסה החינמית אינה מייבאת שדות מותאמים אישית, ועמודות WPML הן שדות מותאמים אישית.
סדר העבודה הוא: מונחי תכונות תחילה, כשהתרגומים שלהם מקושרים, ולאחר מכן המוצרים. דפי מוצר מתורגמים מציעים אז כל ערך תכונה בשפה שלהם, לדוגמה Bleu marine ולא Navy.
קשר את המונחים המתורגמים שכבר קיימים בחנות. עבור כל מונח תכונה מתורגם שכבר קיים בחנות, עבור אל מוצרים ← תכונות, לחץ על הגדר מונחים עבור התכונה, החלף את שפת סרגל הניהול לשפה של המונח ולחץ על שם המונח. בתיבה 'שפה', בחר את המקור שלו תחת זהו תרגום של ולחץ על עדכן. כל מונח מקושר יציג לאחר מכן עיפרון תחת השפה שלו בנתיב WPML ← תרגומים ← טקסונומיה.
הגדר את שפת אזור הניהול לשפת ברירת המחדל של החנות בבורר השפות של סרגל הניהול לפני הפעלת הייבוא.
ייבא את הקטגוריות.All Import ← New Import ← Upload a file, בחר Taxonomies ← Product categories. תחת Term Meta, הוסף שלוש שורות: _wpml_import_language_code, _wpml_import_source_language_code ו־_wpml_import_translation_group, כל אחת מהן ממופה לעמודה בעלת אותו שם בקובץ. הגדר את פריט האב תחת Other Category Options ← Parent Term.
ייבא את מונחי התכונות באותה דרך, לדוגמה Taxonomies ← Product Color, עם אותן שלוש שורות של Term Meta.
קשר את המונחים. עבור אל WPML ← ייצוא וייבוא של WPML ולחץ על Run WPML Import. בדוק תחת WPML ← תרגומים ← טקסונומיה (בחר את הטקסונומיה ב־"בחר את הטקסונומיה לתרגום") שלכל מונח יש שורה אחת עם עיפרון תחת הדגל של כל שפה. רחף מעל עיפרון כדי לראות את השם המתורגם. סימן "+" משמעותו שלאותה שפה אין תרגום. מונח מתורגם המופיע בשורה משלו אינו מקושר.
ייבא את המוצרים. בחר WooCommerce Products. במקטע WooCommerce Add-On, מפה את המק"ט, המחירים, המלאי והתכונות. תחת Custom Fields, הוסף את שלוש שורות ה־_wpml_import_*.
לחץ שוב על Run WPML Import, והמתן להודעה Multilingual Import Complete.
שורות וריאציה נושאות את הסוג variable, בדיוק כמו פריט האב שלהן, בעמודה שאתה ממפה אל Set Product Type With XPath.
קשר וריאציות לפריט האב שלהן בעזרת מפתח לכל שפה. תחת Variations, בחר All my variable products have SKUs or some other unique identifier... ומפה את SKU element for parent ואת Parent SKU element for variation למפתח כגון HP-OW-RAIN-de. מפה את המק"ט האמיתי, הזהה בכל שפה, אל General ← SKU ולקבוצת התרגום. הדרך השנייה היא ייבוא אחד לכל קובץ שפה.
סדר זה עובד בין אם אתה מתחיל את הייבוא של WP All Import מ־wp-admin, מ־WP-CLI או לפי לוח זמנים מתוזמן.
עדכון מלאי ומחירים לפי לוח זמנים
עדכן את המוצרים המקוריים. WPML מעתיק מלאי ומחירים לכל שפה באופן מיידי.
בעזרת מייבא ה־CSV של WooCommerce:
שלח רק את העמודות שאתה משנה. עמודה עם תא ריק כותבת ערך ריק. קובץ הדוגמה שלנו:
הוסף את Meta: _wpml_import_language_code עם שפת המקור בכל שורה. כך כל שורה מעדכנת את המוצר באותה שפה, המקור. ללא עמודה זו, שורה מעדכנת את המוצר בשפה הנוכחית של אזור הניהול, כך שהתוצאה תלויה בבורר השפות של אזור הניהול.
הגדר את שפת אזור הניהול לשפת ברירת המחדל של החנות בבורר השפות של סרגל הניהול.
עבור אלמוצרים ← ייבוא, בחר את הקובץ, סמן את עדכן מוצרים קיימים, לחץ על המשך ועל הפעל את המייבא.
מיד לאחר הייבוא, כל שפה מציגה את המלאי, המחירים וטווח המחירים החדשים.
עם WP All Import, לפי לוח זמנים:
All Import ← New Import ← Download a file ← From URL, עם כתובת ה־URL של הפיד של הספק שלך. בחר WooCommerce Products.
מפה את SKU, Regular Price ואת Stock Qty באזור WooCommerce Add-On.
ב־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.
תחת Choose which data to update, כבה הכל מלבד שדות מותאמים אישית, ובחר Update only these Custom Fields, leave the rest alone: _regular_price, _price, _stock, _manage_stock.
תזמן זאת. תחת All Import ← Manage Imports ← Scheduling Options, האפשרות Manual Scheduling מציגה Trigger URL ו־Processing URL עבור משימת ה־cron של השרת שלך.
כל הרצה מתאימה את השורות למוצרים המקוריים, וכל שפה מקבלת את המחירים והמלאי החדשים של כל מוצר ווריאציה.
אם קובץ מלא של תהליך B מיובא שוב כעדכון, הגדר את Published ל־1 בכל שורה. אחרת המוצרים הפעילים יעברו למצב טיוטה עד ללחיצה על Run WPML Import. סמן את Update existing products, ולאחר מכן לחץ על Run WPML Import. המוצרים יישארו מפורסמים, והטקסטים בקובץ יחליפו את התרגומים באופן מיידי.
הוספת שפה לקטלוג שכבר קיים ברשותך
תהליך A:
עבור אלWPML ← שפות, לחץ על Manage and Hide Site Languages, השתמש ב־Search and add a language… ובחר את השפה.
לחץ על Calculate Costs. תיבת הדו־שיח "Cost to translate your content into ..." מפרטת את הפריטים והמילים. לחץ על שמירה.
המצב 'תרגם הכל' מתחיל את השפה החדשה בעצמו, בפעם הבאה שעמוד אזור הניהול של WPML נטען. WPML מתרגם ומפרסם כל מוצר ווריאציה בשפה החדשה. השפות הקיימות שלך אינן מושפעות.
תהליך B:
הכן קובץ עם השורות של השפה החדשה בלבד. השתמש ב־SKU כקבוצת התרגום, בשפה של המקור בתור שפת מקור, ב־Published = -1 וב־publish כסטטוס הסופי.
עבור אלמוצרים ← ייבוא. השאר את Update existing products לא מסומן. הפעל את המייבא.
עבור אל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."
ייבוא קטלוגים גדולים
ייבא קובץ אחד לכל שפה, קודם את המקור.
הפעל את Run WPML Import פעם אחת, לאחר הקובץ האחרון.
להרצות ארוכות, השתמש ב־WP-CLI: הפקודה wp wpml import process מריצה את אותו שלב כמו הכפתור ומציגה את הספירה של כל שלב.
כמה זמן זה לוקח, מתוך המעבדה שלנו, עם המייבא של 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 בדרך כלל:
שומר את הקטלוג ממופתח לפי SKU, בשפה אחת
מוצא כל מוצר לפי SKU (GET /wc/v3/products?sku=...)
מעדכן מלאי ומחירים של מוצרים קיימים, ויוצר מוצרים חדשים, דרך ה־REST API של WooCommerce
פועל לפי לוח זמנים
זהו התהליך שעובד עם WPML:
המחבר כותב לשפת ברירת המחדל של החנות בלבד.
WPML מעתיק מלאי ומחירים לכל שפה באותה בקשה.
תרגם הכל מתרגם מוצרים חדשים לכל שפה (תהליך A).
מוצר שהמחבר מגדיר כטיוטה עובר לטיוטה בכל שפה.
מוצר שהמחבר מוחק פועל לפי WPML ← הגדרות ← מחיקת תוכן, בשורה מוצרים. אף אחד לא נשאל במהלך סנכרון, לכן הגדר את מחיקת מקור להתנהגות הרצויה לך: מחק את כל השפות מסיר את התרגומים יחד איתו; רק את זה שומר אותם מפורסמים.
שאל את ספק המחבר שלך שלוש שאלות:
האם הוא כותב דרך WooCommerce, או ישירות למסד הנתונים? שינויים שנכתבים ישירות למסד הנתונים מגיעים למקור בלבד. התרגומים שומרים על המלאי והמחירים הישנים.
לאיזו שפה הוא כותב? עליו לכתוב למקור. מחיר שנכתב לתרגום אינו נשמר: התרגום שומר את המחיר של המקור.
האם הוא יוצר מוצר אחד לכל שפה? WooCommerce מסרב למוצר שני עם אותו SKU. ללא ה־SKU, העותקים הם מוצרים נפרדים שאינם מקבלים עדכוני מלאי או מחיר. אפשר למחבר ליצור את המקור בלבד, ותן ל־WPML לתרגם אותו.
חלק 3. בניית תהליכים מותאמים אישית (למפתחים)
יצירת מוצר והתרגומים שלו באמצעות ה־REST API של WooCommerce
צור תחילה את המונחים, לאחר מכן את המקור, ואז כל תרגום עם lang ו־translation_of.
תרגם את הקטגוריה (וכל מונחי התכונות): POST /wp-json/wc/v3/products/categories
צור כל תרגום:POST /wp-json/wc/v3/products, עם הטקסטים המתורגמים, הקטגוריה המתורגמת, lang ו־translation_of (המזהה (ID) של המקור). אל תשלח SKU, מחיר או מלאי: WPML מעתיק אותם מהמקור.
קרא את התוצאה באמצעות 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) של התרגום הקיים. במקום זאת, עדכן את התרגום הקיים.
עדכן את המקור. WPML מעתיק את השינוי לכל שפה באותה בקשה.
PUT /wc/v3/products/123/variations/124 עם {"regular_price": "59.00", "stock_quantity": 3} משנה את המחיר והמלאי של אותה וריאציה בכל שפה, וטווח המחירים מתעדכן בהתאם.
PUT /wc/v3/products/120 עם מחיר רגיל חדש, מחיר מבצע או מלאי משנה אותם בכל שפה.
מונחי תכונות חדשים נוצרים על התכונה של המקור ומתורגמים עם lang ו־translation_of, כמו בשלב 1 לעיל.
וריאציה חדשה שנוספה למקור (POST /wc/v3/products/123/variations או .../variations/batch) מגיעה לכל שפה באותה בקשה, מקושרת, עם המחיר והמלאי שלה. התשובה לקריאה מפרטת רק את שפת המקור; GET /wc/v3/products/130/variations?lang=de מיד לאחר מכן מפרט את הווריאציה המתורגמת החדשה.
מחיר או תכונות שנשלחים לתרגום אינם נשמרים: התרגום שומר את ערכי המקור. ערך מלאי שנשלח לכל שפה הופך למלאי של כל השפות.
מחיקה דרך ה־API:DELETE /wc/v3/products/<id> פועל לפי WPML ← הגדרות ← מחיקת תוכן, בשורה מוצרים. ה־API לעולם אינו שואל: תחת שאל אותי הוא מוחק רק את המקור. הגדר את מחיקת מקור להתנהגות שהחנות שלך דורשת. עם מחק את כל השפות, מחיקה מעבירה כל שפה לפח האשפה, ו־?force=true מוחק כל שפה.
כתיבת יבואן או מחבר משלך
השתמש בפונקציות המוצר של WooCommerce. WPML רואה את השינוי ומעתיק אותו לכל שפה.
לאחר save(), התרגומים מציגים את המחיר והמלאי החדשים.
לעולם אל תכתוב נתוני מוצר ישירות למסד הנתונים (update_post_meta() או SQL). המקור משתנה, והתרגומים שומרים על הערכים הישנים.
הפעל את שלב הייבוא של WPML מקוד לאחר ייבוא עם עמודות WPML: wp wpml import process. הוא מפעיל את אותם שלבים כמו הלחצן Run WPML Import ומדפיס כל אחד מהם עם הספירה שלו.
משימות מתוזמנות
משימה מתוזמנת (WP-Cron) שמשנה את המקור באמצעות פונקציות המוצר של WooCommerce מעבירה את השינויים האלה לכל שפה בבקשה של המשימה עצמה:
מחיר רגיל, מחיר מבצע ומלאי, יחד עם סטטוס המלאי שנגזר מכך
קטגוריה שנוספה למוצר (כקטגוריה המתורגמת)
מונח תכונה חדש במוצר עם וריאציות (כתרגום שלו)
טווח המחירים של המוצר עם וריאציות
חלק 4. פתרון בעיות
תרגומים מיובאים מופיעים כמוצרים נפרדים ללא קישור
מה שאתה רואה: השורות המתורגמות חסרות, או שהן מופיעות כמוצרים באנגלית (שפת ברירת מחדל), לרוב במצב פרטי (Private), ללא קישור למקור.
למה זה קורה:
הקובץ אינו מכיל עמודות WPML. במקרה כזה WooCommerce מדלג על כל שורה שה־SKU (מק"ט) שלה כבר קיים: "מוצר עם מק"ט זה כבר קיים."
הקובץ מכיל את עמודות WPML, אך הלחצן Run WPML Import לא הופעל. עד אז כל שורה היא מוצר בשפת ברירת מחדל ללא קישור למקור שלו, עם הסטטוס שעמודת Published בקובץ מעניקה לו (פרטי עבור 0, טיוטה עבור -1). WPML ← ייצוא וייבוא מציג "Good job. We see 12 posts that are imported and need language information."
איך לתקן זאת עכשיו:
שלב הייבוא של WPML לא הופעל: עבור אל WPML ← ייצוא וייבוא ולחץ על Run WPML Import.
אין עמודות WPML: הוסף את ארבע עמודות WPML לשורות התרגום וייבא אותן שוב כייבוא חדש, כשהאפשרות עדכון מוצרים קיימים אינה מסומנת. לאחר מכן לחץ על Run WPML Import. כל תרגום מצטרף למקור שלו לפי ה־SKU.
איך להימנע מכך: כלול תמיד את עמודות WPML, והפעל את Run WPML Import לאחר כל ייבוא.
תרגומים מיובאים מוחלפים בטקסט של המקור
מה שאתה רואה: ייבאת שמות ותיאורים מתורגמים, ולאחר השמירה הבאה של המקור הם חוזרים לשפה המקורית.
למה זה קורה: התרגומים היו שכפולים. WPML משכתב שכפול בכל שמירה של המקור שלו.
איך לתקן זאת עכשיו:
הפוך אותם לעצמאיים. עבור אל מוצרים ← כל המוצרים, החלף לשפת התרגום, סמן את המוצרים ובחר פעולות קבוצתיות ← תרגום באופן עצמאי.
אם 'תרגם הכל' מופעל, הגדר את 'מוצרים' ל'ללא'. במסך WPML ← תרגומים, לחץ על תפריט שלוש הנקודות בתיבה "תרגם הכל אוטומטית מופעלת", בחר Adjust content limits, הגדר את Products ל־None ולחץ על שמור שינויים.
ייבא את התרגומים שלך שוב.
לאחר מכן, שמירת המקור שומרת על הטקסט המיובא.
איך להימנע מכך: לפני ייבוא טקסט לתרגומים קיימים, הגדר אותם למצב תרגום באופן עצמאי. או ייבא תרגומים כמוצרים חדשים עם עמודות WPML (תהליך ב').
מוצרים מתורגמים מציגים ערכי תכונות בשפה המקורית
מה שאתה רואה: דף המוצר המתורגם מציע "Blue", "Green" במקום המונחים המתורגמים.
למה זה קורה: המוצרים תורגמו לפני שמונחי התכונות שלהם תורגמו.
כיצד לתקן זאת כעת:
עבור אלWPML ← תרגומים ופתח את הכרטיסייה טקסונומיה.
תחת "בחר את הטקסונומיה לתרגום", בחר את התכונה, לדוגמה צבע מוצר.
תרגם כל מונח בכל שפה ולחץ על שמירה. תרגם את תווית התכונה באותו מסך.
מוצרים מתורגמים קיימים קולטים כל מונח ברגע שאתה שומר אותו. אין צורך לשמור שוב אף מוצר. אם מונח נוצר תחילה כעותק עם השם המקורי, מזהה הכתובת שלו שומר את הטקסט המקורי; שנה אותו באותה תיבת דו-שיח.
כיצד להימנע מכך: תרגם מונחי תכונות לפני שאתה מתרגם או מייבא מוצרים.
קטגוריות או מונחים מתורגמים נושאים את השמות המקוריים לאחר ייבוא
מה שאתה רואה: מוצר מתורגם נמצא בקטגוריה בשם "Sunglasses" או מציע "Blue" בחנות המתורגמת.
למה זה קורה: שורות התרגום הועתקו מהייצוא של המקור ושמרו על שמות הקטגוריות, התגיות ומונחי התכונות שלו. WPML יוצר מונחים מתורגמים עם השמות האלה ומקשר אותם כראוי, אך הוא אינו משנה את שמם. מכירות משודרגות, מכירות צולבות, תמונות, גלריות ופריטי אב של וריאציות שניתנו לפי מזהי ה־ID של המקור ממופים מחדש לשפה הנכונה.
כיצד לתקן זאת כעת: שנה את שמות המונחים תחת WPML ← תרגומים ← טקסונומיה, כמו בסעיף שלמעלה. פירורי לחם, קישורי מונחים, כותרות ארכיון ואפשרויות תכונה מציגים את השמות החדשים באופן מיידי, ואין צורך לשמור שוב אף מוצר. מזהי הכתובת שומרים את הטקסט המקורי אלא אם תשנה אותם באותה תיבת דו-שיח.
כיצד להימנע מכך: בשורות התרגום, כתוב שמות מתורגמים של קטגוריות, תגיות ומונחי תכונות, באותו סדר כמו במקור. ציין מוצרים קשורים ופריטי אב לפי מק"ט (SKU).
מלאי או מחירים בשפות אחרות מפגרים מאחורי המקור
מה שאתה רואה: המקור מציג את המלאי או המחיר החדשים, והתרגומים מציגים את הישנים.
למה זה קורה: השינוי עקף את WooCommerce או את WPML:
מחבר (connector) כתב ישירות למסד הנתונים.
ייבוא פעל בזמן ש־WPML היה מושבת.
כיצד לדעת: פתח את המקור בעורך המוצר. מתחת לעורך התיאור מופיע הכיתוב "נערך לאחרונה ב" עם תאריך ושעה. אם השעה הזו ישנה יותר מהמחיר או המלאי החדשים בתיבת נתוני המוצר, או שהשינוי בוצע בזמן ש־WPML לא היה פעיל, העדכון עקף את הסנכרון.
כיצד לתקן זאת כעת:
עבור מוצרים עם וריאציות:
עבור אלWPML ← תמיכה ← Fix WCML translations. הכלי Fix WCML translations הוא חלק מ־WPML Troubleshooting, תוסף נפרד.
סמן את Synchronize product variations ולחץ על Run the selected tools.
לאחר מכן, כל שפה מציגה את מחירי הווריאציות והמלאי של המקור, ואת טווח המחירים של המוצר.
עבור מוצרים רגילים, השתמש באחת מהדרכים הבאות. כל אחת מהן מעבירה את המחיר והמלאי של המקור לכל שפה:
מוצר אחד בכל פעם: פתח כל מקור שהשתנה ולחץ על עדכן.
מוצרים רבים באמצעות ייבוא: כאשר שפת אזור הניהול מוגדרת לשפת ברירת המחדל, ייבא את המוצרים שוב דרך מוצרים ← ייבוא וסמן את עדכון מוצרים קיימים. הקובץ יכול להכיל את הערכים שכבר קיימים במקור. פעולה זו מסדרת מחדש גם מוצרים עם וריאציות.
מוצרים רבים באמצעות REST: שלח PUT /wc/v3/products/<id> עם המחיר עבור כל מוצר, לדוגמה {"regular_price": "19.50"}.
מוצרים רבים עם מחיר אחד: במוצרים ← כל המוצרים, סמן את המוצרים, בחר פעולות מקובצות ← עריכה מקובצת ולחץ על החל. תחת מחיר בחר שנה ל:, הזן את המחיר ולחץ על עדכן. כל מוצר שסומן מקבל את המחיר האחד הזה.
הפעלת wp wc product update עם הערך שכבר קיים במקור אינה מעבירה אותו לתרגומים.
כיצד להימנע מכך: אפשר למחבר לכתוב דרך WooCommerce (ה־REST API או פונקציות המוצר), והשאר את WPML פעיל במהלך ייבוא.
מוצרים שנוצרו דרך REST API מגיעים לשפה או לקבוצה הלא נכונות
מה שאתה רואה: תרגום מופיע בשפה הלא נכונה, או כמוצר נפרד ללא מק"ט וללא קישור למקור.
למה זה קורה:
קוד שפה לא ידוע נדחה עם שגיאת HTTP 422 Invalid language parameter: "ge", ושום דבר לא נוצר.
קוד תקין אך שגוי, כגון טקסט בגרמנית שנשלח עם "lang": "fr", יוצר תרגום באותה שפה.
translation_of חסר יוצר מוצר בקבוצה משלו, ללא מק"ט וללא העתקה של מחיר או מלאי.
כיצד לתקן זאת כעת: שלח את המוצר שוב עם השפה הנכונה והקישור, עם PUT /wc/v3/products/<id>:
JSON
{
"lang": "de",
"translation_of": 38
}
המוצר עובר לקבוצה של המקור ומקבל את המק"ט, המחיר והמלאי שלו. עבור מוצר עם וריאציות, WPML מחליף את הווריאציות שנוצרו ללא קישור בווריאציות חדשות ומקושרות. קרא בחזרה את מזהי ה־ID החדשים של הווריאציות.
כיצד להימנע מכך: שלח lang ו־translation_of בכל תרגום, צור תחילה את המונחים, ואפשר ל־WPML ליצור את הווריאציות של התרגומים.
מוצרים מיובאים חדשים אינם מתורגמים אוטומטית
מה שאתה רואה: מוצרים מיובאים נשארים בשפה המקורית בלבד.
למה זה קורה: 'תרגם הכל' היה כבוי במהלך הייבוא, או שהמוצרים פרטיים, מה ש'תרגם הכל' לעולם לא מתרגם, או שהם טיוטות, שאותן הוא מתרגם רק כאשר תרגם טיוטות אוטומטית מופעל והטיוטה נשמרת שוב.
כיצד לתקן זאת כעת:
שלח את המוצרים: עבור אל WPML ← תרגומים, פתח את סעיף מוצרים, סמן את המוצרים, בחר תרגם אוטומטית עבור כל שפה, בחר פרסום ללא סקירה תחת "מה תרצה לעשות כש־WPML יסיים לתרגם את התוכן שלך אוטומטית?" ולחץ על תרגם תוכן. זה עובד גם עבור טיוטות ומוצרים פרטיים; התרגומים שלהם מקבלים את הסטטוס של המקור.
או הפעל את 'תרגם הכל'. מצב זה מתרגם כל מוצר שפורסם וטרם תורגם. WPML שולח אותם בזמן שדפי אזור הניהול של WPML נטענים.
עבור אלWPML ← תרגומים ← הגדר תרגם הכל ← המשך ← הפעל את 'תרגם הכל אוטומטית'.
הישאר ב־WPML ← תרגומים עד שיופיע הכיתוב "סיום תרגום התוכן שלך".
כיצד להימנע מכך: הפעל את 'תרגם הכל' לפני הייבוא (תהליך A), וייבא מוצרים כשהם מפורסמים.