ACFML – שדות מותאמים אישית רב-לשוניים של ACF ו־ACF Pro ב־WordPress
הפוך כל שדה מותאם אישית באתר שלך לרב-לשוני. ACFML מוסיף תמיכה רב-לשונית ל־Advanced Custom Fields ול־ACF Pro. הוא מכסה כל סוג שדה, כל קבוצת שדות (Field Group), כל עמוד אפשרויות (Options Page), וגם את תוויות השדות עצמן. ישנה תמיכה מלאה בהגדרות ACF Pro הכוללות Repeater, Flexible Content, Clone, לוגיקה מותנית (conditional logic) ושדות מקומיים הרשומים ב־PHP. כלול בחשבונות Multilingual CMS ו־Agency.
כל סוג שדה של ACF הוא רב-לשוני
אם אתה בונה אתרים על גבי ACF, ACFML מכסה כל סוג שדה בקטלוג של ACF ושל ACF Pro:
- שדות Text ו־Wysiwyg מתורגמים לכל שפה.
- שורות של Repeater ו־Flexible Content נשארות מסונכרנות בין השפות.
- שדות Image, File ו־Gallery יכולים להתחלף לקבצים מותאמים מקומית לכל שפה.
- שדות Link, Relationship ו־Post Object נשארים מקושרים כראוי בין השפות.
- שדות Date Picker, Color Picker, Map ושדות אינטראקטיביים אחרים מתנהגים כראוי בכל שפה.
גם סוגי תוכן מותאמים אישית (Custom Post Types), טקסונומיות ועמודי אפשרויות שאתה רושם דרך ACF מתורגמים – כולל התוויות שלהם. האתר שאתה בונה עם ACF הוא האתר שהופך לרב-לשוני עם ACFML, ולא רק חלק ממנו.
בחירת מה שזהה ומה ששונה בכל שפה
לקבוצות שדות (Field Groups) של ACF אין התנהגות תרגום אחת שמתאימה לכולם. עמוד Our Team (הצוות שלנו) באתר שלך מציג את אותם חברי צוות בכל שפה: עליך לתרגם את השמות והביוגרפיות שלהם, ולשמור על המבנה שלהם שלם. עמוד Events (אירועים) מציג אירועים שונים לקהלים שונים: עליך להציג אירועים שונים לחלוטין לכל שפה. עמוד Product Specs (מפרט מוצר) מציג שילוב: עליך לתרגם את התיאור, אך לשמור על המק"ט (SKU) והמחיר זהים.


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) מביא תמיכה מלאה ב־Local Fields (שדות מקומיים). אתה מגדיר את העדפת התרגום של כל שדה באמצעות המפתח wpml_cf_preferences בהגדרת קבוצת השדות, מסנכרן אותו לתוך WPML מתוך ACF > Tools (כלים), ומסכי הניהול משקפים את מה שקבוצת השדות מצהירה עליו. קובצי ה־Local 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 עבור התנהגות תרגום חדשה, האינטגרציה נבנית יחד במקום בהנדסה לאחור.
ACFML כלול ב־WPML
ACFML מגיע עם Multilingual CMS ו־WPML Agency. אין צורך ברכישה נפרדת, ואין תשלום לכל אתר. קנה את WPML פעם אחת וכל אתר ACF שהחשבון שלך מכסה יהפוך לרב-לשוני. אם כבר יש לך את WPML, הפעל את ACFML מתוך עמוד ההורדות של WPML שלך.