Displays or retrieves the edit term link with formatting.
Parameters
$linkstringoptional- Anchor text. If empty, default is ‘Edit This’.
Default:
'' $beforestringoptional- Display before edit link.
Default:
'' $afterstringoptional- Display after edit link.
Default:
'' $termint|WP_Term|nulloptional- Term ID or object. If null, the queried object will be inspected.
Default:
null $displaybooloptional- Whether or not to echo the return.
Default:
true
Source
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. |
Display link to edit term