apply_filters( 'wpml_language_codes_map', array $map )
- סוג
- filter
- קטגוריה
- מידע שפה ברחבי האתר
- גרסת WPML
- 5.0.0
תיאור
מסנן את מפת קודי השפות לקודים שבהם WPML משתמש בכתובות URL.
לשפה יש שני קודים ב־WPML 5.0. language_code הוא הקוד השמור, והוא לעולם אינו משתנה. קוד ה־URL הוא המקטע שמבקר רואה, לדוגמה /de-de/. השניים שונים כאשר WPML מייחד את קוד ה־URL, דבר שקורה כאשר אתה מוסיף שתי מדינות של שפה אחת באותו שלב, וכאשר בעל האתר עורך את קוד ה־URL.
פילטר זה הוא המפה שממיר ה־URL עצמו קורא, ולכן הוא לעולם אינו יכול להיות בסתירה לקישורים ש־WPML בונה. השתמש בו כדי לדעת את הכתובת של שפה. כדי לקרוא את כל הנתונים של השפות הפעילות, כולל הדגל וכתובת ה־URL המלאה, השתמש ב־wpml_active_languages.
אתה בונה את המפה ו־WPML משכתב אותה. WPML מחליף את הערך של כל מפתח שהוא מכיר בקוד ה־URL של אותה שפה, ומשאיר כל מפתח אחר כפי שהעברת אותו. WPML לעולם אינו מוסיף שפה, לכן מערך ריק חוזר ריק. בנה את המפה תחילה, כ־WPML code => WPML code, ולאחר מכן החל את הפילטר. WPML עושה את אותו הדבר בקוד שלו.
ארגומנטים
- פרמטרים
-
- $map(מערך) מפה של
WPML code => codeשאתה בונה בעצמך. WPML מחליף את הערך של כל מפתח שהוא מכיר בקוד ה־URL של אותה שפה. מפתח ש־WPML אינו מכיר שומר על הערך שהעברת.
- $map(מערך) מפה של
- ערכים מוחזרים
- (מערך) אותה מפה, עם קוד ה־URL של כל שפה ש־WPML מכיר. WPML לא מוסיף מפתחות, לכן העבר כל שפה שאתה רוצה לקרוא.
דוגמת שימוש
קרא את המפה כדי ללמוד באיזה מקטע URL משתמשת שפה. הדוגמה כותבת שורה אחת לכל שפה. היא קוראת את רשימת השפות בעזרת wpml_active_languages, ולכן היא רצה אחרי הפעולה wp, כמו אותו פילטר.
דוגמה
function my_language_url_codes() {
$codes = apply_filters( 'wpml_active_languages', null );
if ( empty( $codes ) ) {
return;
}
$identity = array_combine( array_keys( $codes ), array_keys( $codes ) );
$map = apply_filters( 'wpml_language_codes_map', $identity );
foreach ( $map as $language_code => $url_code ) {
echo esc_html( $language_code . ' is served at /' . $url_code . '/' ) . '<br />';
}
}
כדי לשנות את קוד ה־URL של שפה, ערוך אותו ב־WPML » הגדרות » שפות. אל תשתמש בפילטר זה כדי להעביר שפה לכתובת אחרת: WPML קורא את המפה כשהוא מנתח URL נכנס וכשהוא בונה קישור, כך שערך שאינו שייך לאף שפה מייצר כתובות ש־WPML אינו יכול לפענח.
הוקים קשורים
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