Функция wp_parse_slug_list() предназначена для обработки и очистки списка ярлыков (slug), который может быть представлен в виде массива или строки, разделенной запятыми или пробелами. Она позволяет удобно создавать массив уникальных и очищенных ярлыков, что особенно полезно при работе с метаданными и таксономиями в WordPress.
wp_parse_slug_list( array|string $input_list ): string[]
Параметры
$input_list(array|string, обязательный) – Список ярлыков, который может быть представлен как строка, разделенная запятыми или пробелами, или как массив ярлыков.
Возвращаемое значение
Функция возвращает массив строк, содержащий очищенные и уникальные ярлыки.
Пример 1: Обработка строки с ярлыками
Давайте начнем с простого примера, где мы передаем строку с ярлыками, разделенными запятыми и пробелами.
$str = 'apple, banana, orange, apple';
$unique_slugs = wp_parse_slug_list($str);
print_r($unique_slugs);
/*
Array
(
[0] => apple
[1] => banana
[2] => orange
)
*/
Пример 2: Использование строки с пробелами
Вы можете также использовать строку, где ярлыки разделены только пробелами. Функция будет корректно обрабатывать такие случаи.
$slug_string = 'carrot cucumber carrot';
$slugs = wp_parse_slug_list($slug_string);
print_r($slugs);
/*
Array
(
[0] => carrot
[1] => cucumber
)
*/
Пример 3: Разделение ярлыков с различными разделителями
Функция поддерживает различные форматы входных данных, включая смешанные разделители.
$input = 'tomato, potato potato, cucumber, tomato';
$result = wp_parse_slug_list($input);
print_r($result);
/*
Array
(
[0] => tomato
[1] => potato
[2] => cucumber
)
*/
Пример 4: Обработка массива ярлыков
Функция также позволяет передавать массив, который будет очищен и возвращен как массив уникальных значений.
$slug_array = ['grape', 'pear', 'grape', 'kiwi'];
$cleaned_slugs = wp_parse_slug_list($slug_array);
print_r($cleaned_slugs);
/*
Array
(
[0] => grape
[1] => pear
[2] => kiwi
)
*/
Пример 5: Сложные случаи с дополнительными пробелами
Функция эффективно обрабатывает строки с лишними пробелами между ярлыками.
$complex_string = ' strawberry, raspberry, strawberry ';
$parsed_slugs = wp_parse_slug_list($complex_string);
print_r($parsed_slugs);
/*
Array
(
[0] => strawberry
[1] => raspberry
)
*/
Заключение
Функция wp_parse_slug_list() в WordPress — это мощный инструмент для обработки и очистки списков ярлыков. Она обеспечивает простоту и удобство работы с метаданными, позволяя легко извлекать уникальные значения из строк и массивов. Благодаря этой функции разработчики могут легко управлять ярлыками в своих проектах, обеспечивая их корректное хранение и использование.