функция since 2.5.0

shortcode_atts()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

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

Описание

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

Оригинал (английский)

The pairs should be considered to be all of the attributes which are supported by the caller and given as a list. The returned attributes will only contain the attributes in the $pairs list.

If the $atts list has unsupported attributes, then they will be ignored and removed from the final returned list.

Параметры

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

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

array

Исходный код

wp-includes/shortcodes.php:664

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.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.