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.

Contents

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

Top ↑

Return

string|void HTML content.

Top ↑

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;
	}
}

View on Trac View on GitHub

Top ↑

Hooks

Top ↑

Top ↑

Uses

Uses
Uses Description
get_queried_object() wp-includes/query.php

Retrieves the currently queried object.
get_edit_term_link() wp-includes/link-template.php

Retrieves the URL for editing a given term.
current_user_can() wp-includes/capabilities.php

Returns whether the current user has the specified capability.
__() wp-includes/l10n.php

Retrieves the translation of $text.
get_term() wp-includes/taxonomy.php

Gets all term data from database by term ID.
get_taxonomy() wp-includes/taxonomy.php

Retrieves the taxonomy object of $taxonomy.
apply_filters() wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.
Show 5 more uses Hide more uses

Top ↑

Used By

Used By
Used By Description
edit_tag_link() wp-includes/link-template.php

Displays or retrieves the edit link for a tag with formatting.

Top ↑

Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes

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