shortcode_atts_(shortcode) │ хук-фільтр │ WP 3.6.0

Фільтрує дефолтні атрибути вказаного шорткоду.

Фільтри викликається у функції gallery_shortcode() .

Базові варіанти хука:

• shortcode_atts_gallery
• shortcode_atts_caption
• shortcode_atts_playlist
• shortcode_atts_audio
• shortcode_atts_video

Про хуку та функції shortcode_atts() у відеоформаті:

Використання

add_filter( 'shortcode_atts_(shortcode)', 'wp_kama_shortcode_atts_filter', 10, 4);

/**
 * Function for `shortcode_atts_(shortcode)` filter-hook.
 *
 * @param array $out output array shortcode attributes.
 * @param array $pairs Допоможуть атрибути і їх defaults.
 * @param array $atts User defined shortcode attributes.
 * @param string $shortcode The shortcode name.
 *
 * @return array
 */
function wp_kama_shortcode_atts_filter( $out, $pairs, $atts, $shortcode ){

	// Filter...
	return $out;
}

$out
(масив)

Асоціативний масив атрибутів шорткоду, який змінюватиметься під час фільтрації.

$pairs
(масив)

Масив усіх можливих атрибутів шорткоду та їх значення за промовчанням.

$atts
(масив)

Атрибути вказані для шорткоду користувачем.

$shortcode
(рядок)

Назва шорткоду, наприклад
gallery. Ця назва вказується в назву цього фільтра в кінці.

Приклади

## Встановимо дві колонки в галереї за замовчуванням
add_filter( 'shortcode_atts_'. 'gallery', 'set_default_gallery_columns', 10, 3);
function set_default_gallery_columns( $out, $pairs, $atts ){
	// Змінимо значення за замовчуванням, якщо значення не встановлено
	if( ! isset($atts['columns']) ){
		$out['columns'] = 2;
	}

	return $out;
}

Додати свій приклад