ACFML – שדות מותאמים אישית רב-לשוניים של ACF ו־ACF Pro ב־WordPress

כל סוג שדה של ACF הוא רב-לשוני

אם אתה בונה אתרים על ACF, ACFML מכסה כל סוג שדה בקטלוג של ACF ו־ACF Pro:

• שדות Text ו־Wysiwyg מתורגמים לכל שפה.
• שורות Repeater ו־Flexible Content נשארות מסונכרנות בכל השפות.
• שדות Image, File ו־Gallery יכולים להתחלף לנכסים מותאמים מקומית לכל שפה.
• שדות Link, Relationship ו־Post Object נשארים מקושרים כראוי בין השפות.
• שדות Date Picker, Color Picker, Map ושדות אינטראקטיביים אחרים פועלים כראוי בכל שפה.

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

בחירה של מה זהה ומה שונה בכל שפה

לקבוצות שדות (Field Groups) של ACF אין התנהגות תרגום אחידה שמתאימה לכולם. העמוד Our Team באתר שלך מציג את אותם חברי צוות בכל שפה: עליך לתרגם את השמות והביוגרפיות שלהם, ולשמור על המבנה שלהם ללא שינוי. העמוד Events מציג אירועים שונים לקהלים שונים: הצג אירועים שונים לחלוטין לכל שפה. העמוד Product Specs מציג שילוב: תרגם את התיאור, ושמור על המק"ט והמחיר זהים.

ACFML מטפל בשלושת המצבים הללו ברמת קבוצת השדות: Same fields across languages (אותם שדות בכל השפות), Different fields across languages (שדות שונים בכל שפה), ו־Expert Mode (מצב מומחה) להגדרות משולבות. בחר את המצב שתואם למטרה של כל קבוצת שדות; ACFML מגדיר את התנהגות התרגום באופן אוטומטי.

שליטה בתרגום ברמת השדה

בתוך קבוצת שדות, כל שדה מקבל העדפת תרגום משלו:

• Translate (תרגום). ערך השדה מתורגם לכל שפה.
• Copy (העתקה). ערך השדה נשאר מסונכרן בכל השפות; ערוך אותו פעם אחת והוא יופץ לשאר השפות.
• Copy once (העתק פעם אחת). ערך השדה משמש כבסיס לתרגומים חדשים, ולאחר מכן ניתן לערוך כל גרסת שפה באופן עצמאי.
• Don’t translate (אל תתרגם). המערכת מתעלמת מהשדה לחלוטין (לדוגמה, שדה פנימי המיועד למנהלים בלבד).

הגדרות ברירת מחדל הגיוניות לכל סוג שדה מגיעות מוכנות לשימוש מיד: שדות Text ו־Wysiwyg מוגדרים כברירת מחדל לתרגום (Translate), ושדות מובנים כמו Image, Link ו־Number מוגדרים כברירת מחדל להעתקה (Copy). ההפניה המלאה להגדרות הקבועות מראש נמצאת בעמוד כיצד לתרגם שדות מותאמים אישית של ACF.

שורות Repeater ו־Flexible Content נשארות מסונכרנות בכל השפות

שדות Repeater ו־Flexible Content הם המקומות שבהם הגדרות ACF רב-לשוניות נשברות לעתים קרובות בכלים אחרים: שורות יוצאות מסנכרון, פריסות מתפצלות, ומתרגמים רואים תוכן שהם לא מזהים. ACFML שומר על מבנה השורות מסונכרן בכל השפות כברירת מחדל. מתרגמים רואים את אותן שורות באותו סדר, כאשר כל תת-שדה הניתן לתרגום נמצא במקומו. אם אתה זקוק למבנים שונים לכל שפה (לדוגמה, רשימת אירועים שונה בכל שפה), ההעדפה Copy once מאפשרת זאת.

שדות מקומיים (הרשומים ב־PHP) מקבלים את אותה התנהגות תרגום

אתרים פעילים רבים רושמים שדות ACF ב־PHP במקום בממשק הניהול של ACF (לצורך ניידות, בקרת גרסאות או הגדרות המצורפות לערכת העיצוב). ACFML 2.2.0 (פברואר 2026) מביא תמיכה מלאה בשדות מקומיים. אתה מגדיר את העדפת התרגום של כל שדה באמצעות המפתח wpml_cf_preferences בהגדרת קבוצת השדות, מסנכרן אותה ל־WPML מתוך ACF > כלים (Tools), ומסכי הניהול משקפים את מה שקבוצת השדות מצהירה עליו. קובצי ה־JSON המקומיים של ACF נושאים איתם את ההעדפות כאשר אתה מייצא ומייבא בין אתרים. התהליך המפורט שלב אחר שלב נמצא בעמוד ההדרכה תחת הגדרת העדפות לשדות הרשומים ב־PHP או ב־JSON.

הוקים (Hooks) למפתחים למקרי קצה

עבור אתרים עם לוגיקת תרגום שדות מותאמת אישית (החרגת שדות מסוימים, דריסת העדפת ברירת המחדל לסוג שדה באופן גלובלי, הסתרת הערות ממתרגמים), ACFML חושף שני פילטרים (acfml_should_translate_acf_entity, acfml_field_group_mode_field_translation_preference) וארבעה קבועים (ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS, ACFML_HIDE_FIELD_ANNOTATIONS, ACFML_REPEATER_SYNC_DEFAULT, ACFML_SCAN_LOCAL_FIELDS). ההפניה המלאה עם דוגמאות קוד נמצאת בעמוד הפניה להוקים וקבועים של ACFML.

נבנה ומתוחזק יחד עם צוות ACF

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