Функция EDIT_TERM_LINK() в WordPress

Функция edit_term_link() позволяет создать ссылку на редактирование элемента таксономии в WordPress. Эта ссылка представлена в виде HTML-тега <a>.

Важные сведения

• Версия: Доступна с WordPress 3.1.0
• Использование функции: Чтобы получить URL для редактирования элемента таксономии, используйте функцию get_edit_term_link().

Хуки функции

• edit_term_link – это хук, который позволяет изменять ссылку редактирования термина.

Возврат

Функция возвращает строку с HTML-тегом <a>, если у пользователя есть права для редактирования термина. В противном случае возвращает null.

Использование функции

Сигнатура функции

edit_term_link( $link, $before, $after, $term, $display );

• $link (строка) – текст ссылки. По умолчанию пустой. Если оставить пустым, будет показано значение 'Редактировать это'.
• $before (строка) – текст, который будет отображён перед ссылкой. По умолчанию пустой.
• $after (строка) – текст, который будет отображён после ссылки. По умолчанию пустой.
• $term (int|WP_Term|null) – ID термина или объект термина. Если null, будет проверен текущий объект.
• $display (true|false) – выводить ссылку на экран или вернуть её. По умолчанию true.

Примеры использования

Пример 1: Вывод ссылки для редактирования текущего термина

edit_term_link();

Результат:

Редактировать

Пример 2: Вывод ссылки для редактирования конкретного термина

$term = get_term( 154 );

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

Результат:

Редактировать термин

Код функции

Вот как выглядит функция edit_term_link():

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 = __( 'Редактировать это' );
}

$link = '' . $link . '';

/**
 * Фильтрация тега ссылке редактирования термина.
 *
 * @since 3.1.0
 *
 * @param string $link    Тег ссылки для редактирования.
 * @param int    $term_id ID термина.
 */
$link = $before . apply_filters( 'edit_term_link', $link, $term->term_id ) . $after;

if ( $display ) {
    echo $link;
} else {
    return $link;
}

}

Связанные функции

• get_edit_term_link() – получение URL для редактирования термина.
• get_taxonomies() – получение всех зарегистрированных таксономий.
• get_term() – получение термина по его ID.

Эти функции помогут вам работать с терминами и таксономиями, облегчая процесс управления содержимым вашего сайта на WordPress.