# shortcode_atts()

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

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

## Сигнатура

```php
shortcode_atts( array $pairs, array $atts, string $shortcode = '' ): array
```

## Описание

Пары следует рассматривать как все атрибуты, поддерживаемые вызывающей стороной и переданные в виде списка. Возвращаемые атрибуты будут содержать только атрибуты из списка $pairs.
Если список $atts содержит неподдерживаемые атрибуты, они будут проигнорированы и удалены из итогового возвращаемого списка.

## Параметры

- `$pairs` `array` — обязательный. Полный список поддерживаемых атрибутов и их значений по умолчанию.
- `$atts` `array` — обязательный. Атрибуты, заданные пользователем в теге шорткода.
- `$shortcode` `string` — необязательный, по умолчанию `''`. Имя шорткода, предоставляемое для контекста, чтобы обеспечить возможность фильтрации.

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

`array`

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

Файл: `wp-includes/shortcodes.php:664`

```php
function shortcode_atts( $pairs, $atts, $shortcode = '' ) {
	$atts = (array) $atts;
	$out  = array();
	foreach ( $pairs as $name => $default ) {
		if ( array_key_exists( $name, $atts ) ) {
			$out[ $name ] = $atts[ $name ];
		} else {
			$out[ $name ] = $default;
		}
	}

	if ( $shortcode ) {
		/**
		 * Filters shortcode attributes.
		 *
		 * If the third parameter of the shortcode_atts() function is present then this filter is available.
		 * The third parameter, $shortcode, is the name of the shortcode.
		 *
		 * @since 3.6.0
		 * @since 4.4.0 Added the `$shortcode` parameter.
		 *
		 * @param array  $out       The output array of shortcode attributes.
		 * @param array  $pairs     The supported attributes and their defaults.
		 * @param array  $atts      The user defined shortcode attributes.
		 * @param string $shortcode The shortcode name.
		 */
		$out = apply_filters( "shortcode_atts_{$shortcode}", $out, $pairs, $atts, $shortcode );
	}

	return $out;
}
```

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

- 2.5.0 — Introduced.

## Связанные

Использует: [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`wp_video_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_video_shortcode/), [`gallery_shortcode`](https://chugunov.pro/api-wordpress/functions/gallery_shortcode/), [`wp_playlist_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_playlist_shortcode/), [`wp_audio_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_audio_shortcode/), [`img_caption_shortcode`](https://chugunov.pro/api-wordpress/functions/img_caption_shortcode/).

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