edit_term_link()WP 3.1.0

Получает или выводит ссылку (html тег A) на редактирования указанного элемента таксономии (термина).

Если пользователь не имеет права редактировать текущую таксономию, то функция ничего не вернет (вернет null).

Чтобы получить URL на редактирование термина, используйте get_edit_term_link().

Работает на основе: get_edit_term_link()
Основа для: edit_tag_link()
Хуки из функции

Возвращает

Строку|null. HTML тег <a>. null когда у пользователя нет прав редактировать термин.

Использование

edit_term_link( $link, $before, $after, $term, $echo );
$link(строка)
Анкор ссылки.
По умолчанию: __('Edit This')
$before(строка)
Текст перед ссылкой - до тега A.
По умолчанию: ''
$after(строка)
Текст после ссылки - после тега A.
По умолчанию: ''
$term(объект)
Объект термина. Если null, то будет использовать текущий объект запроса. см. get_queried_object().
По умолчанию: null
$echo(логический)
Выводить на экран или возвращать для обработки в PHP.
По умолчанию: true

Примеры

0

#1 Выведем на экран ссылку на редактирование текущего термина

Предполагается, что ссылка вызывается при просмотре страницы (на странице) элемента таксономии.

edit_term_link();

// выведет:
// <a href="http://example.com/wp-admin/edit-tags.php?action=edit&taxonomy=funccat&tag_ID=154&post_type=func">Редактировать</a>
0

#2 Выведем ссылку на редактирование указанного термина

$term = get_term( 154 );

edit_term_link( 'Редактировать термин', '', '', $term, 0 );

// выведет:
// <a href="http://example.com/wp-admin/edit-tags.php?action=edit&taxonomy=funccat&tag_ID=154&post_type=func">Редактировать термин</a>

Список изменений

С версии 3.1.0 Введена.

Код edit_term_link() WP 6.5.2

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