WPML
apply_filters( 'wpml_display_language_names', mixed $empty_value, string $native_name, string|bool $translated_name, bool $lang_native_hidden, bool $lang_translated_hidden )
النوع
filter
إصدار WPML
3.2

الوصف

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

يُستخدم هذا المرشِّح عادةً في مبدلات لغة مخصصة.

الوسطاء

$empty_value
(mixed) (مطلوب) هذه عادةً هي القيمة التي سيقوم المرشِّح بتعديلها. نحن لا نرشح أي شيء هنا لذا عيِّن هذه القيمة إلى NULL. هذا لكي تتلقى دالة المرشِّح قائمة الوسائط الكاملة فعلياً
$native_name
(string) (مطلوب) اسم اللغة الأصلي
$translated_name
(string|bool) (مطلوب) اسم اللغة المترجم. الافتراضي هو FALSE
$lang_native_hidden
(bool) (اختياري) الافتراضي هو FALSE 0|false أو 1|true ما إذا كان سيتم إخفاء اسم اللغة الأصلي أم لا
$lang_translated_hidden
(bool) (اختياري) الافتراضي هو FALSE 0|false أو 1|true ما إذا كان سيتم إخفاء اسم اللغة المترجم أم لا

مثال على الاستخدام

مثال
function my_footer_languages_list(){
    $languages = apply_filters( 'wpml_active_languages', NULL, 'skip_missing=0&orderby=code' );
    if( !empty( $languages ) ){
        echo '<div id="footer_language_list"><ul>';
        foreach( $languages as $l ){
            echo '<li>';
            if( $l['country_flag_url'] ){
                if( !$l['active'] ) echo '<a href="'.$l['url'].'">';
                echo '<img src="'.$l['country_flag_url'].'" height="12" alt="'.$l['language_code'].'" width="18" />';
                if( !$l['active'] ) echo '</a>';
            }
            if(!$l['active']) echo '<a href="'.$l['url'].'">';
            echo apply_filters( 'wpml_display_language_names', NULL, $l['native_name'], $l['translated_name'] );
            if( !$l['active'] ) echo '</a>';
            echo '</li>';
        }
        echo '</ul></div>';
    }
}

تقوم دالة المثال أعلاه بما يلي:

  1. إذا كانت هناك أي لغات، فإنها تنشئ DIV وتبدأ قائمة غير مرتبة

  2. ثم تمر عبر كل لغة وتضيفها كعنصر قائمة.
    إذا لم تكن اللغة هي اللغة النشطة، فإنها تضيف رابطاً إلى الصفحة المترجمة لتلك اللغة

  3. ثم تضيف علم اللغة

  4. أخيراً، تضيف اسمي اللغة الأصلي والمترجم إذا كانا مختلفين

wpml_decode_custom_field, wpml_footer_language_selector, wpml_add_language_form_field, wpml_ls_exclude_in_menu, wpml_is_rtl, wpml_alternate_hreflang, wpml_head_langs, wpml_must_translate_canonical_url, wpml_browser_redirect_language_params, wpml_active_languages

جميع خطاطيف معلومات اللغة على مستوى الموقع البالغ عددها 29 →