ترجمة النصوص التي يحفظها القالب والإضافات في wp_options

تعرّف على كيفية جعل النصوص المحفوظة في جدول wp_options قابلة للترجمة وتحويل معرفات الكائنات تلقائياً.

تتضمن القوالب والإضافات أحياناً نصوصاً كجزء من الخيارات التي تحفظها في جدول wp_options. يتيح لك WPML ترجمة هذه النصوص عن طريق استبدال استدعاءات get_option بالترجمات التي تحددها في ملف wpml-config.xml.

ملف wpml-config.xml هو مستند تكوين يوجه WPML إلى السلاسل التي تحتاج إلى ترجمة في الخيارات المحفوظة.

هذا الدليل مخصص للمطورين الذين ينشئون قوالبهم وإضافاتهم الخاصة. إذا كنت تحاول ترجمة سلاسل قادمة من قوالب وإضافات تابعة لجهات خارجية، فاقرأ صفحتنا حول العثور على السلاسل التي لا تظهر في صفحة ترجمة النصوص.

هل تحتاج إلى إنشاء ملف wpml-config.xml؟ تفضل بزيارة دليلنا التفصيلي حول إنشاء ملف تكوين تلقائياً باستخدام إضافة Multilingual Tools.

ترجمة السلاسل في جدول wp_options

عندما تستخدم القوالب والإضافات get_option، فإنها تقرأ القيم من جدول wp_options. يمكن لـ WPML تصفية هذه الاستدعاءات وتوفير ترجمة لقيم هذه الخيارات.

ينجح هذا إذا كان سجل wp_option عبارة عن سلسلة بسيطة، ولكنه ينجح أيضاً عندما يكون مصفوفة متسلسلة.

لترجمة خيار واحد، أضف إدخال key تحت admin-texts. لترجمة مصفوفة متسلسلة، أضف عدة مفاتيح تحت key، كما ترى في my_plugin_options في المثال أدناه.

نصوص المسؤول في ملف تكوين اللغة

<wpml-config>
  <admin-texts>
    <key name="my_plugins_options">
      <key name="option_name_1" />
      <key name="option_name_2" />
    <key name="options_group_1">
      <key name="sub_option_name_11" />
      <key name="sub_option_name_12" />
    </key>
      <key name="options_group_2">
      <key name="sub_option_name_21" />
    <key name="sub_option_name_22" />
    </key>
    </key>
  <key name="simple_string_option"/>
</admin-texts>
 
</wpml-config>

من الممكن استخدام حرف البدل * في المفاتيح الفرعية كما في الحالة التالية.

مثال على استخدام حرف البدل

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="*"/>
    </key>
  </admin-texts>
</wpml-config>

وهو يعادل هذا الكود:

الكود المكافئ

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="sub_key_1"/>
      <key name="sub_key_2">
        <key name="sub_sub_21">
          <key name="sub_sub_211"/> 
        </key> 
        <key name="sub_sub_21"/>
        </key>
      <key name="more_sub_keys"/>
    </key>
  </admin-texts>
</wpml-config>

يرجى ملاحظة أن حرف البدل * لا يعمل في المفاتيح الأصلية:

حرف البدل لا يعمل في المفاتيح الأصلية

<wpml-config>
  <admin-texts>
    <key name="some_option_*" />
    <key name="*"/>
  </admin-texts>
</wpml-config>

تحويل معرفات الكائنات تلقائياً في نصوص المسؤول

بدءاً من إصدار WPML 4.8، يمكنك التصريح بأن نصوص مسؤول معينة تحتوي على معرفات كائنات مثل معرفات المقالات أو المنتجات أو التصنيفات. يحول WPML هذه المعرفات تلقائياً في الواجهة الأمامية للموقع.

يُعد هذا امتداداً للوظيفة الحالية حول تحويل معرفات الأكواد المختصرة تلقائياً ويستخدم نفس البنية.

في إدخالات key تحت admin-texts، استخدم:

type لتحديد الكائن المشار إليه، أي post-ids أو taxonomy-ids
sub-type (اختياري) عندما تريد التصريح بالكيان المحدد (مثل product)

يمكن إضافة السمتين Type و sub-type في أي مستوى متداخل.

يمكن لـ WPML اكتشاف المعرفات وتحويلها بهذه التنسيقات:

معرف واحد (مثل 123)
مصفوفة (ومصفوفة مشفرة) من المعرفات (مثل [123,456,789])
قائمة معرفات مفصولة بفواصل (مثل «123,456,789»)

مثال على التصريح بمعرفات الكائنات في نصوص المسؤول

<wpml-config>
  <admin-texts>
    <key name="admin_text_option_key" type="post-ids" sub-type="product" />
    <key name="admin_text_with_nested_ids">
      <key name="admin_text_nested_key_with_ids" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_ids_with_wildcard_*" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_subkey">
        <key name="admin_text_nested_key_with_subkey_with_ids" type="post-ids" sub-type="product" />
          </key>
      </key>
  </admin-texts>
</wpml-config>

موارد إضافية

لمعرفة المزيد حول ملف wpml-config.xml ، تفضل بزيارة دليل ملفات تكوين اللغة.

لتخصيص عناصر أخرى باستخدام ملف wpml-config.xml، تفضل بزيارة أدلتنا الإضافية: