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 )
- Typ
- filter
- Kategorie
- Abrufen lokalisierter Inhalte
- WPML-Version
- 3.2
Beschreibung
Gibt einen Link zu einem Beitragstyp oder einem Taxonomie-Begriff in der aktuellen Sprache zurück.
* Hinweis: Es gibt alternative Möglichkeiten, den Link eines Elements abzurufen, die Entwicklern eine umfassendere Kontrolle über die HTML-Ausgabe geben.
WordPress bietet eine Reihe von Funktionen hierfür an, wie etwa get_permalink(), get_term_link() usw.
Wenn Sie planen, Funktionen zu verwenden, die einen Beitragstyp oder eine Begriffs-ID als Parameter erfordern, könnte der Filter wpml_object_id für Sie von Interesse sein.
Argumente
- $element_id
- (int) (Erforderlich) Die ID des Beitragstyps (Beitrag, Seite, Anhang, benutzerdefinierter Beitrag) oder Taxonomie-Begriffs (Schlagwort, Kategorie, benutzerdefinierte Taxonomie), auf den verlinkt werden soll
- $element_type
- (string) (Optional) Der Typ des Elements, auf das verlinkt werden soll. Kann ‘post’, ‘page’, ‘attachment’, '{custom post}', ‘tag’, ‘category’, '{custom taxonomy}' sein. Standardwert ist ‘post’
- $link_text
- (string) (Optional) Der Linktext. Standardwert ist der Name des Elements
- $optional_parameters
- (array) (Optional) Argumente für den Link
- $anchor
- (string) (Optional) Anker für den Link
- $echo
- (bool) (Optional) 0|false zur Rückgabe oder 1|true zur Ausgabe (echo) des lokalisierten Links. Standardwert ist true
- $return_original_if_missing
- (bool) (Optional) Wenn auf true gesetzt, wird immer ein Wert zurückgegeben (der Originalwert, falls die Übersetzung fehlt). Standardwert ist TRUE
Anwendungsbeispiel
Beispiele
//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="/de/?attachment_id=25">'Attachment image title</a> apply_filters( 'wpml_element_link', 25, 'attachment', __( 'Attachment image title' ) );
Verwandte Hooks
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