функция
since 5.1.0
taxonomy_meta_box_sanitize_cb_input()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
taxonomy_meta_box_sanitize_cb_input( string $taxonomy, array|string $terms ): array
Описание
Очищает значения POST из метабокса таксономии с текстовым вводом.
Параметры
$taxonomy
string
обязательный
Имя таксономии.
$terms
array|string
обязательный
Необработанные данные термина из поля 'tax_input'.
Возвращаемое значение
array
Исходный код
wp-admin/includes/post.php:2258
function taxonomy_meta_box_sanitize_cb_input( $taxonomy, $terms ) {
/*
* Assume that a 'tax_input' string is a comma-separated list of term names.
* Some languages may use a character other than a comma as a delimiter, so we standardize on
* commas before parsing the list.
*/
if ( ! is_array( $terms ) ) {
$comma = _x( ',', 'tag delimiter' );
if ( ',' !== $comma ) {
$terms = str_replace( $comma, ',', $terms );
}
$terms = explode( ',', trim( $terms, " \n\t\r\0\x0B," ) );
}
$clean_terms = array();
foreach ( $terms as $term ) {
// Empty terms are invalid input.
if ( empty( $term ) ) {
continue;
}
$_term = get_terms(
array(
'taxonomy' => $taxonomy,
'name' => $term,
'fields' => 'ids',
'hide_empty' => false,
)
);
if ( ! empty( $_term ) ) {
$clean_terms[] = (int) $_term[0];
} else {
// No existing term was found, so pass the string. A new term will be created.
$clean_terms[] = $term;
}
}
return $clean_terms;
}
История изменений
| Версия | Описание |
|---|---|
| 5.1.0 | Introduced. |

