ערכות נושא רבות WordPress כוללות קישורים מקודדים. לדוגמה, קישורי כותרת תחתונה המפנים לדפי תמיכה ויצירת קשר עשויים להיראות כך:
<a href="/support/">Support</a> | <a href="/contact-us/">Contact us</a>
כאשר האתר פועל במגוון שפות, קישורים אלו חייבים להתאים לשפת התצוגה. גם טקסט הקישור (מה שהמבקר רואה) וגם כתובת האתר (אליה הקישור מפנה) צריכים להשתנות בעת החלפת שפה.
הפונקציה WPML icl_link_to_element() תייצר קישורים מקומיים לדפים ויש להשתמש בה למטרה זו.
תיאור פונקציה
icl_link_to_element(מזהה, סוג, טקסט, ארגומנטים, עוגן);
| טַעֲנָה | תיאור | חובה / אופציונלי |
|---|---|---|
| תְעוּדַת זֶהוּת | המזהה של הפוסט, העמוד, התג או הקטגוריה שאליו יש קישור. | חובה |
| סוּג | סוג העמוד שאליו יש קישור. יכול להיות 'פוסט', 'עמוד', 'תג' או 'קטגוריה'. | אופציונלי, ברירת המחדל היא 'פוסט" |
| טֶקסט | טקסט הקישור. אם לא צוין ייצור את שם האלמנט בשפה הנוכחית. | אופציונלי, ברירת המחדל של שם האלמנט. כדי לצאת כברירת מחדל, הזן false . |
| טיעונים | טיעונים אופציונליים עבור הקישור. בשימוש, זה צריך להיות מערך PHP. | אופציונלי, ברירת המחדל היא ללא ארגומנטים |
| לְעַגֵן | עוגן אופציונלי עבור הקישור. | אופציונלי, ברירת המחדל היא ללא עוגן |
שימוש לדוגמה
| דוגמא | תכלית | הפקת HTML |
|---|---|---|
| <?php icl_link_to_element(10); ?> | קישור לעמוד 10 (דף תמיכה) | <a href="/support/"> תמיכה< /א> |
| <?php icl_link_to_element(10,'post',__('קבל עזרה')); ?> | קישור לדף תמיכה עם טקסט קישור חלופי | <a href="/support/"> תקבל עזרה< /א> |
| <?php icl_link_to_element(10,'post',false, array('category'=> 'מוצרים','priority'=> 'גָבוֹהַ'); ?> | קישור לדף תמיכה והוסף שני טיעונים | <a href="/support/?category=products&priority=high"> תמיכה< /א> |
| <?php icl_link_to_element(10,'post',false,'priority'=> 'גבוה', 'שאלות נפוצות'); ?> | ||
| <?php icl_link_to_element(3,'tag'); ?> | קישור לתג עם מזהה 3 (תג 'חדשות' שלנו) | <a href="/tag/news/"> חֲדָשׁוֹת< /א> |
איך זה עובד
אתה יכול לציין את המזהה של עמוד / פוסט / תג / קטגוריה בכל שפה. WPML יבדוק אם קיים תרגום לשפה הנוכחית. אם כן, זה ייצור את הקישור אליו. אם התרגום לא קיים, הוא יקשר לדף בשפת המקור.
כאשר אתה מציין את טקסט הקישור באופן ידני, מומלץ לעטוף אותו בקריאה gettext __() , כך שהטקסט יוצג בשפה הנכונה. אם לא תציין שום טקסט של קישור (כמו בדוגמה הראשונה), WPML ייצור את השם של אותו עמוד.