apply_filters( 'wpml_element_link', int $element_id, string $element_type, string $link_text, array $optional_parameters, string $anchor, bool $echo, bool $return_original_if_missing )
- סוג
- filter
- קטגוריה
- אחזור תוכן מותאם מקומית
- גרסת WPML
- 3.2
תיאור
מחזיר קישור לסוג פוסט או קישור למונח טקסונומיה בשפה הנוכחית.
* הערה: קיימות דרכים חלופיות לקבל קישור של אלמנט המעניקות למפתחים שליטה מלאה יותר על פלט ה־HTML.
WordPress מציעה מספר פונקציות לשם כך, כגון get_permalink(), get_term_link() וכו’.
אם בכוונתך להשתמש בפונקציות שדורשות מזהה (ID) של סוג פוסט או של מונח כפרמטר, ייתכן שתרצה לבדוק את הפילטר wpml_object_id.
ארגומנטים
- $element_id
- (int) (נדרש) המזהה (ID) של סוג הפוסט (פוסט, עמוד, קובץ מצורף, סוג תוכן מותאם אישית) או של מונח הטקסונומיה (תגית, קטגוריה, טקסונומיה מותאמת אישית) שאליו תרצה לקשר
- $element_type
- (string) (אופציונלי) סוג הרכיב שאליו תרצה לקשר. יכול להיות ‘post’, ‘page’, ‘attachment’, '{custom post}', ‘tag’, ‘category’, '{custom taxonomy}'. ברירת המחדל היא ‘post’
- $link_text
- (string) (אופציונלי) טקסט הקישור. ברירת המחדל היא שם הרכיב
- $optional_parameters
- (array) (אופציונלי) ארגומנטים עבור הקישור
- $anchor
- (string) (אופציונלי) עוגן עבור הקישור
- $echo
- (bool) (אופציונלי) 0|false כדי להחזיר או 1|true כדי להדפיס (echo) את הקישור המתורגם. ברירת המחדל היא true
- $return_original_if_missing
- (bool) (אופציונלי) אם מוגדר כ־true, הוא תמיד יחזיר ערך (הערך המקורי, אם התרגום חסר). ברירת המחדל היא TRUE
דוגמה לשימוש
דוגמאות
//produces: <a href="/hello-world/">Hello World!</a> apply_filters( 'wpml_element_link', 1 ); //produces: <a href="/sample-page/">Custom link text for the sample page</a> apply_filters( 'wpml_element_link', 2, 'page', __( 'Custom link text for the sample page' ) ); //produces: <a href="/sample-page/?category=foo&bar=baz">Sample Page</a> apply_filters( 'wpml_element_link', 2, 'page', '', array( 'category'=>'foo', 'bar'=>'baz' ) ); //produces: <a href="/sample-page/#contact">Sample Page</a> apply_filters( 'wpml_element_link', 2, 'page', '', '', 'contact' ); //produces: <a href="/category/uncategorized/">Uncategorized</a> apply_filters( 'wpml_element_link', 1, 'category' ); //produces: <a href="/he/?attachment_id=25">'Attachment image title</a> apply_filters( 'wpml_element_link', 25, 'attachment', __( 'Attachment image title' ) );
הוקים קשורים
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_permalink, wpml_unfiltered_admin_string