wpml_permalink

$converted_url = apply_filters( 'wpml_permalink', string $permalink, string $language_code = null, bool $full_resolution = false );

סוג

filter

קטגוריה

אחזור תוכן מותאם מקומית

גרסת WPML

3.2.2

תיאור

מסנן קישור קבוע של WordPress וממיר אותו לקישור קבוע ספציפי לשפה בהתבסס על פורמט כתובת URL של שפה שהוגדר בהגדרות השפה של WPML.

המשמעות היא שכאשר “פורמט כתובת URL של שפה” מוגדר בתור “שפות שונות בספריות”, הקישור הקבוע יוחזר בתבנית http://domain.com/de. כאשר נבחרת האפשרות “דומיין שונה לכל שפה”, הקישור הקבוע יומר כך שיכלול את הדומיין הנכון שהוקצה לשפה המבוקשת.

ארגומנטים

$permalink

(string) (נדרש) כתובת ה־URL שנוצרה על ידי WordPress לסינון.

$language_code

(string) (אופציונלי) השפה שאליה תומר כתובת ה־URL. הוא מקבל קוד בן 2 אותיות. כאשר הוא מוגדר כ־null, הוא חוזר אל שפת ברירת מחדל עבור עמוד השורש, או אל השפה הנוכחית בכל שאר המקרים. ברירת המחדל היא null

$full_resolution

(boolean) (אופציונלי) הפעלת המרה מלאה של כתובות URL בקידוד קשיח.

דוגמה לשימוש

דוגמה 1

לדוגמה, אם בחרנו באפשרות “שפות שונות בספריות”, נוכל להשתמש בקוד הבא:

// will return http://domain.com/de/contact
$wpml_permalink = apply_filters( 'wpml_permalink', 'http://domain.com/contact', 'de' );	

דוגמה 2

יש לנו עמוד http://example.org/hello/ והתרגום שלו http://example.org/fr/bonjour/. נניח שאנו קוראים לפילטר בזמן שאנו מציגים את עמוד הבית http://example.org.

// displays http://example.org/fr/hello/ (wrong)
echo apply_filters( 'wpml_permalink', 'http://example.org/hello/', 'fr' ); 

// displays http://example.org/fr/bonjour/ (correct)
echo apply_filters( 'wpml_permalink', 'http://example.org/hello/', 'fr', true ); 

הערות חשובות לגבי הדוגמה השנייה:

• ההמרה המלאה היא תהליך כבד, ולכן WPML חייב לשמור את כתובות ה־URL המומרות במסד הנתונים. הקריאה הראשונה ל־wpml_permalink צפויה להגדיל משמעותית את שאילתות מסד הנתונים ואת זמן הטעינה. אך הקריאות הבאות לא אמורות להעמיס על התהליך.
• הנתונים השמורים במסד הנתונים נמחקים חלקית כאשר פוסט/מונחים מעודכנים או נמחקים. והם נמחקים במלואם בעת מעבר אל הגדרות -> קישורים קבועים (זוהי אפשרות טובה עבור פתרון בעיות במקרה שאתה נתקל בבעיות כלשהן).
• במקרה שלא ניתן היה להמיר את ה־URL, הפילטר wpml_permalink יחזיר את ה־URL המקורי.

הוקים קשורים

wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_single_string, wpml_translate_string, wpml_elements_without_translations, wpml_unfiltered_admin_string, wpml_element_link

כל 12 ההוקים בקטגוריה אחזור תוכן מותאם מקומית →