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 ההוקים בקטגוריה מידע שפה ברחבי האתר →