функция
since 3.1.0
get_edit_term_link()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_edit_term_link( int|WP_Term|object $term, string $taxonomy = '', string $object_type = '' ): string|null
Описание
Извлекает URL для редактирования указанного термина.
Параметры
$term
int|WP_Term|object
обязательный
ID или объект термина, ссылка для редактирования которого будет получена.
$taxonomy
string
необязательный
= ''
Таксономия. По умолчанию — таксономия термина, определяемого по $term.
$object_type
string
необязательный
= ''
Тип объекта. Используется для подсветки нужного меню типа записи на странице по ссылке. По умолчанию — первый object_type, связанный с таксономией.
Возвращаемое значение
string|null
Исходный код
wp-includes/link-template.php:1082
function get_edit_term_link( $term, $taxonomy = '', $object_type = '' ) {
$term = get_term( $term, $taxonomy );
if ( ! $term || is_wp_error( $term ) ) {
return null;
}
$tax = get_taxonomy( $term->taxonomy );
$term_id = $term->term_id;
if ( ! $tax || ! current_user_can( 'edit_term', $term_id ) ) {
return null;
}
$args = array(
'taxonomy' => $tax->name,
'tag_ID' => $term_id,
);
if ( $object_type ) {
$args['post_type'] = $object_type;
} elseif ( ! empty( $tax->object_type ) ) {
$args['post_type'] = reset( $tax->object_type );
}
if ( $tax->show_ui ) {
$location = add_query_arg( $args, admin_url( 'term.php' ) );
} else {
$location = '';
}
/**
* Filters the edit link for a term.
*
* @since 3.1.0
*
* @param string $location The edit link.
* @param int $term_id Term ID.
* @param string $taxonomy Taxonomy name.
* @param string $object_type The object type.
*/
return apply_filters( 'get_edit_term_link', $location, $term_id, $taxonomy, $object_type );
}
История изменений
| Версия | Описание |
|---|---|
| 4.5.0 | The $taxonomy parameter was made optional. |
| 3.1.0 | Introduced. |

