ACFML – حقول مخصصة متعددة اللغات لـ ACF و ACF Pro في WordPress

كل نوع حقل في ACF متعدد اللغات

إذا كنت تبني مواقع باستخدام ACF، فإن ACFML يغطي كل نوع حقل في كتالوج ACF و ACF Pro:

• تُترجم حقول النص و Wysiwyg لكل لغة.
• تبقى صفوف Repeater و Flexible Content متوافقة عبر اللغات.
• يمكن لحقول الصورة والملف والمعرض التبديل إلى أصول محلية لكل لغة.
• تبقى حقول الرابط والعلاقة وكائن المنشور مرتبطة بشكل صحيح بين اللغات.
• تتصرف حقول منتقي التاريخ ومنتقي الألوان والخريطة والحقول التفاعلية الأخرى بشكل صحيح لكل لغة.

تُترجم أيضاً أنواع المنشورات المخصصة والتصنيفات وصفحات الخيارات التي تسجلها من خلال ACF – بما في ذلك تسمياتها. الموقع الذي تبنيه باستخدام ACF هو الموقع الذي يصبح متعدد اللغات باستخدام ACFML، وليس مجرد جزء منه.

اختر ما هو متطابق وما هو مختلف لكل لغة

لا تمتلك مجموعات حقول ACF سلوك ترجمة يناسب الجميع. تعرض صفحة فريقنا في موقعك نفس أعضاء الفريق في كل لغة: ترجم أسماءهم وسيرهم الذاتية، وحافظ على هيكلهم سليماً. تعرض صفحة الأحداث أحداثاً مختلفة لجماهير مختلفة: اعرض أحداثاً مختلفة لكل لغة بالكامل. تعرض صفحة مواصفات المنتج مزيجاً: ترجم الوصف، وحافظ على تطابق رمز SKU والسعر.

يتعامل ACFML مع الحالات الثلاث على مستوى مجموعة الحقول: نفس الحقول عبر اللغات، و حقول مختلفة عبر اللغات، و الوضع المتقدم للإعدادات المختلطة. اختر الوضع الذي يطابق الغرض من كل مجموعة حقول؛ وسيقوم ACFML بربط سلوك الترجمة تلقائياً.

التحكم في الترجمة على مستوى الحقل

داخل مجموعة الحقول، يحصل كل حقل على تفضيل الترجمة الخاص به:

• ترجمة. تُترجم قيمة الحقل لكل لغة.
• نسخ. تبقى قيمة الحقل متزامنة عبر اللغات؛ عدّلها مرة واحدة وسيبدأ تعميمها.
• نسخ مرة واحدة. تزرع قيمة الحقل الترجمات الجديدة، ثم يمكن تعديل كل نسخة لغة بشكل مستقل.
• عدم الترجمة. يتم تجاهل الحقل بالكامل (على سبيل المثال، حقل داخلي للمسؤول فقط).

تتوفر إعدادات افتراضية منطقية لكل نوع حقل جاهزة للاستخدام فوراً: تُعيّن حقول النص و Wysiwyg افتراضياً إلى ترجمة، وتُعيّن الحقول المهيكلة مثل الصورة والرابط والرقم افتراضياً إلى نسخ. المرجع الكامل للإعدادات المسبقة موجود في كيفية ترجمة حقول ACF المخصصة.

بقاء صفوف Repeater و Flexible Content متوافقة عبر اللغات

حقول Repeater و Flexible Content هي المكان الذي غالباً ما تتعطل فيه إعدادات ACF متعددة اللغات في الأدوات الأخرى: تفقد الصفوف تزامنها، وتتباعد التخطيطات، ويرى المترجمون محتوى لا يتعرفون عليه. يحافظ ACFML على توافق هيكل الصفوف عبر اللغات افتراضياً. يرى المترجمون نفس الصفوف بنفس الترتيب، مع وجود كل حقل فرعي قابل للترجمة في مكانه. إذا كنت بحاجة إلى هياكل متباينة لكل لغة (على سبيل المثال، قائمة أحداث مختلفة في كل لغة)، فإن تفضيل نسخ مرة واحدة يتيح لك ذلك.

الحقول المحلية (المسجلة عبر PHP) تحصل على نفس سلوك الترجمة

تُسجل العديد من المواقع المباشرة حقول ACF في PHP بدلاً من واجهة مستخدم مسؤول ACF (من أجل قابلية النقل، أو التحكم في الإصدارات، أو الإعدادات المجمّعة مع القالب). يجلب إصدار ACFML 2.2.0 (فبراير 2026) دعماً كاملاً للحقول المحلية. أنت تضبط تفضيل الترجمة لكل حقل باستخدام المفتاح wpml_cf_preferences في تعريف مجموعة الحقول، وتزامنه في WPML من ACF > أدوات، وستعكس شاشات لوحة التحكم ما تعلنه مجموعة الحقول. تحمل ملفات JSON المحلية الخاصة بـ ACF التفضيلات معها عندما تقوم بالتصدير والاستيراد بين المواقع. الإجراء خطوة بخطوة موجود في صفحة الإرشادات تحت تعيين التفضيلات للحقول المسجلة في PHP أو JSON.

خطاطيف المطورين للحالات الاستثنائية

بالنسبة للمواقع التي تحتوي على منطق مخصص لترجمة الحقول (استبعاد حقول معينة، أو تجاوز التفضيل الافتراضي لنوع حقل بشكل عام، أو إخفاء التعليقات التوضيحية عن المترجمين)، يوفر 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 لسلوك ترجمة جديد، يتم بناء التكامل معاً بدلاً من الاعتماد على الهندسة العكسية.