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 )
- Loại
- filter
- Danh mục
- Truy xuất nội dung đã bản địa hóa
- Phiên bản WPML
- 3.2
Miêu tả
Trả về liên kết loại bài viết hoặc liên kết thuật ngữ phân loại bằng ngôn ngữ hiện tại.
* Lưu ý: Có các cách thay thế để truy xuất liên kết của một phần tử, giúp các nhà phát triển kiểm soát đầy đủ hơn đối với đầu ra HTML.
WordPress cung cấp một số hàm để thực hiện việc này như get_permalink(), get_term_link(), v.v.
Nếu bạn dự định sử dụng các hàm yêu cầu loại bài viết hoặc ID thuật ngữ làm tham số thì bạn có thể muốn tìm hiểu bộ lọc wpml_object_id.
Đối số
- $element_id
- (int) (Bắt buộc) ID của loại bài viết (bài viết, trang, tệp đính kèm, bài viết tùy chỉnh) hoặc thuật ngữ phân loại (thẻ, chuyên mục, phân loại tùy chỉnh) cần liên kết đến
- $element_type
- (string) (Tùy chọn) Loại phần tử cần liên kết đến. Có thể là ‘post’, ‘page’, ‘attachment’, '{custom post}', ‘tag’, ‘category’, '{custom taxonomy}'. Mặc định là ‘post’
- $link_text
- (string) (Tùy chọn) Văn bản liên kết. Mặc định là tên của phần tử
- $optional_parameters
- (array) (Tùy chọn) Các đối số cho liên kết
- $anchor
- (string) (Tùy chọn) Neo cho liên kết
- $echo
- (bool) (Tùy chọn) 0|false để trả về hoặc 1|true để in ra liên kết đã được bản địa hóa. Mặc định là true
- $return_original_if_missing
- (bool) (Tùy chọn) Nếu được đặt thành true, nó sẽ luôn trả về một giá trị (giá trị gốc, nếu thiếu bản dịch). Mặc định là TRUE
Ví dụ sử dụng
Ví dụ
//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="/vi/?attachment_id=25">'Attachment image title</a> apply_filters( 'wpml_element_link', 25, 'attachment', __( 'Attachment image title' ) );
Các hook liên quan
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