edit_term_link( string $link = '', string $before = '', string $after = '', int|WP_Term|null $term = null, bool $display = true ): string|void
Displays or retrieves the edit term link with formatting.
Parameters
-
$link
string Optional -
Anchor text. If empty, default is 'Edit This'.
Default:
''
-
$before
string Optional -
Display before edit link.
Default:
''
-
$after
string Optional -
Display after edit link.
Default:
''
-
$term
int|WP_Term|null Optional -
Term ID or object. If null, the queried object will be inspected.
Default:
null
-
$display
bool Optional -
Whether or not to echo the return.
Default:
true
Return
string|void HTML content.
Source
File: wp-includes/link-template.php
.
View all references
function edit_term_link( $link = '', $before = '', $after = '', $term = null, $display = true ) {
if ( is_null( $term ) ) {
$term = get_queried_object();
} else {
$term = get_term( $term );
}
if ( ! $term ) {
return;
}
$tax = get_taxonomy( $term->taxonomy );
if ( ! current_user_can( 'edit_term', $term->term_id ) ) {
return;
}
if ( empty( $link ) ) {
$link = __( 'Edit This' );
}
$link = '<a href="' . get_edit_term_link( $term->term_id, $term->taxonomy ) . '">' . $link . '</a>';
/**
* Filters the anchor tag for the edit link of a term.
*
* @since 3.1.0
*
* @param string $link The anchor tag for the edit link.
* @param int $term_id Term ID.
*/
$link = $before . apply_filters( 'edit_term_link', $link, $term->term_id ) . $after;
if ( $display ) {
echo $link;
} else {
return $link;
}
}
Hooks
-
apply_filters( 'edit_term_link',
string $link ,int $term_id ) -
Filters the anchor tag for the edit link of a term.
Changelog
Version | Description |
---|---|
3.1.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Display link to edit term