# wp_list_pluck()

URL: https://chugunov.pro/api-wordpress/functions/wp_list_pluck/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.1.0.

## Сигнатура

```php
wp_list_pluck( array $input_list, int|string $field, int|string $index_key = null ): array
```

## Описание

Обладает той же функциональностью и сигнатурой, что и array_column() (PHP 5.5), но также поддерживает объекты.

## Параметры

- `$input_list` `array` — обязательный. Список объектов или массивов.
- `$field` `int|string` — обязательный. Поле объекта, которое подставляется вместо всего объекта.
- `$index_key` `int|string` — необязательный, по умолчанию `null`. Поле объекта, которое используется в качестве ключей нового массива.

## Возвращаемое значение

`array` — $index_key $index_key $index_key $input_list

## Исходный код

Файл: `wp-includes/functions.php:5395`

```php
function wp_list_pluck( $input_list, $field, $index_key = null ) {
	if ( ! is_array( $input_list ) ) {
		return array();
	}

	$util = new WP_List_Util( $input_list );

	return $util->pluck( $field, $index_key );
}
```

## История изменений

- 4.7.0 — Uses WP_List_Util class.
- 4.0.0 — $index_key parameter added.
- 3.1.0 — Introduced.

## Связанные

Использует: `WP_List_Util::__construct`.
Используется в: `WP_Script_Modules::get_dependents`, `WP_Textdomain_Registry::invalidate_mo_files_cache`, [`update_post_parent_caches`](https://chugunov.pro/api-wordpress/functions/update_post_parent_caches/), [`update_post_author_caches`](https://chugunov.pro/api-wordpress/functions/update_post_author_caches/), `WP_REST_Menu_Items_Controller::prepare_item_for_response`, [`get_block_templates`](https://chugunov.pro/api-wordpress/functions/get_block_templates/), `WP_REST_Term_Search_Handler::search_items`, [`get_media_states`](https://chugunov.pro/api-wordpress/functions/get_media_states/), [`get_feed_build_date`](https://chugunov.pro/api-wordpress/functions/get_feed_build_date/), `WP_Query`, [`wp_filter_oembed_iframe_title_attribute`](https://chugunov.pro/api-wordpress/functions/wp_filter_oembed_iframe_title_attribute/), `WP_REST_Post_Search_Handler::search_items`, `WP_Widget_Media_Gallery::render_media`, `WP_Widget_Media_Audio::render_media`, `WP_Widget_Media_Video::render_media`, `WP_Widget_Media::form`, `WP_Widget_Media::widget`, `WP_Widget_Media_Image::render_media`, `WP_Community_Events::trim_events`, `WP_Customize_Manager::import_theme_starter_content`, `WP_REST_Posts_Controller::prepare_item_for_response`, `WP_REST_Post_Types_Controller::prepare_item_for_response`, `WP_Term_Query::get_terms`, `WP_Comment_Query::fill_descendants`, `WP_Customize_Manager::unsanitized_post_values`, `WP_Automatic_Updater::send_debug_email`, [`get_terms_to_edit`](https://chugunov.pro/api-wordpress/functions/get_terms_to_edit/), `WP_Plugin_Install_List_Table::prepare_items`, [`get_inline_data`](https://chugunov.pro/api-wordpress/functions/get_inline_data/), `WP_Media_List_Table::display_rows`, `WP_Comments_List_Table::prepare_items`, [`get_the_terms`](https://chugunov.pro/api-wordpress/functions/get_the_terms/), `WP_Query::get_posts`, [`_default_wp_die_handler`](https://chugunov.pro/api-wordpress/functions/_default_wp_die_handler/), `WP_Widget_Recent_Comments::widget`, `WP_Tax_Query::transform_query`, [`is_object_in_term`](https://chugunov.pro/api-wordpress/functions/is_object_in_term/), [`wp_insert_term`](https://chugunov.pro/api-wordpress/functions/wp_insert_term/), [`wp_delete_term`](https://chugunov.pro/api-wordpress/functions/wp_delete_term/), [`get_post_galleries`](https://chugunov.pro/api-wordpress/functions/get_post_galleries/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_list_pluck/