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

$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

Return

string|void HTML content.

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

VersionDescription
3.1.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.