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، وليس جزءاً منه فقط.

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

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

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

التحكم في الترجمة لكل حقل

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

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

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

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

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

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

تُسجل العديد من المواقع المباشرة حقول ACF في PHP بدلاً من واجهة مسؤول ACF (من أجل قابلية النقل، أو التحكم في الإصدارات، أو الإعدادات المجمعة مع القالب). يضيف الإصدار ACFML 2.2.0 (فبراير 2026) دعماً كاملاً للحقول المحلية. يمكنك تعيين تفضيل الترجمة لكل حقل باستخدام المفتاح wpml_cf_preferences في تعريف مجموعة الحقول، ومزامنته في WPML من ACF > Tools، وستعكس شاشات المسؤول ما تعلنه مجموعة الحقول. تحمل ملفات 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 لسلوك ترجمة جديد، يتم بناء التكامل معاً بدلاً من استخدام الهندسة العكسية.