Nhiều chủ đề WordPress bao gồm các liên kết được mã hóa cứng. Ví dụ: các liên kết chân trang trỏ đến các trang hỗ trợ và liên hệ có thể trông như thế này:
<a href="/support/">Support</a> | <a href="/contact-us/">Contact us</a>
Khi trang web đang chạy đa ngôn ngữ, các liên kết này phải thích ứng với ngôn ngữ hiển thị. Cả văn bản liên kết (những gì khách truy cập nhìn thấy) và URL (nơi liên kết trỏ tới) đều cần thay đổi khi chuyển đổi ngôn ngữ.
Hàm WPML icl_link_to_element() sẽ tạo ra các liên kết được bản địa hóa đến các trang và nên được sử dụng cho mục đích này.
Mô tả chức năng
icl_link_to_element(ID, loại, văn bản, đối số, neo);
| Lý lẽ | Sự miêu tả | Bắt buộc/tùy chọn |
|---|---|---|
| NHẬN DẠNG | ID của bài viết, trang, thẻ hoặc danh mục để liên kết tới. | Bắt buộc |
| kiểu | Loại trang để liên kết đến. Có thể là ‘bài đăng’, ‘trang’, ‘thẻ’ hoặc ‘danh mục’. | Tùy chọn, mặc định là ‘đăng” |
| chữ | Văn bản liên kết. Nếu không được chỉ định sẽ tạo ra tên của thành phần trong ngôn ngữ hiện tại. | Tùy chọn, mặc định là tên của phần tử. Để để mặc định thì nhập false . |
| tranh luận | Đối số tùy chọn cho liên kết. Khi được sử dụng, đây phải là một mảng PHP. | Tùy chọn, mặc định là không có đối số |
| mỏ neo | Neo tùy chọn cho liên kết. | Tùy chọn, mặc định là không có neo |
Cách sử dụng ví dụ
| Ví dụ | Mục đích | HTML được sản xuất |
|---|---|---|
| <?php icl_link_to_element(10); ?> | Link tới trang 10 (trang hỗ trợ) | <a href=”/support/”> Ủng hộ< /Một> |
| <?php icl_link_to_element(10,’post’,__(‘Nhận trợ giúp’)); ?> | Liên kết tới trang hỗ trợ bằng văn bản liên kết thay thế | <a href=”/support/”> Được giúp đỡ< /Một> |
| <?php icl_link_to_element(10,’post’,false, array(‘category’=> ‘sản phẩm’,’ưu tiên’=> ‘cao’); ?> | Liên kết đến trang hỗ trợ và thêm hai đối số | <a href=”/support/?category=products&priority=high”> Ủng hộ< /Một> |
| <?php icl_link_to_element(10,’post’,false,’priority’=> ‘cao’,’câu hỏi thường gặp’); ?> | ||
| <?php icl_link_to_element(3,’tag’); ?> | Liên kết đến thẻ có ID 3 (thẻ ‘Tin tức’ của chúng tôi) | <a href=”/tag/news/”> Tin tức< /Một> |
Làm thế nào nó hoạt động
Bạn có thể chỉ định ID của trang/bài đăng/thẻ/danh mục bằng bất kỳ ngôn ngữ nào. WPML sẽ kiểm tra xem ngôn ngữ hiện tại có tồn tại bản dịch hay không. Nếu vậy, nó sẽ tạo ra liên kết đến nó. Nếu bản dịch không tồn tại, nó sẽ liên kết đến trang bằng ngôn ngữ gốc.
Khi bạn chỉ định văn bản liên kết theo cách thủ công, bạn nên gói nó trong lệnh gọi gettext __() để văn bản hiển thị theo đúng ngôn ngữ. Nếu bạn không chỉ định bất kỳ văn bản liên kết nào (như trong ví dụ đầu tiên), WPML sẽ tạo tên của trang đó.