WordPress.org

Languages: English • Italiano • atts 日本語 (Add your language)

Description

Combines user shortcode attributes with known attributes and fills in defaults when needed. The result will contain every key from the known attributes, merged with values from shortcode attributes.

Usage

<?php shortcode_atts( $pairs, $atts, $shortcode ); ?>

Parameters

$pairs

(array) (required) Entire list of supported attributes and their defaults

Default: None

$atts

(array) (required) User defined attributes in shortcode tag

Default: None

$shortcode

(string) (optional) Shortcode name to be used by the shortcode_atts_{$shortcode} filter. If this is present, it makes a "shortcode_atts_$shortcode" filter available for other code to filter the attributes. It should always be included for maximum compatibility, however it is an optional variable.

Default: None

Return Values

(array) 

Combined and filtered attribute list.

Examples

function bartag_func( $atts ) {
	$atts = shortcode_atts(
		array(
			'foo' => 'no foo',
			'bar' => 'default bar',
		), $atts, 'bartag' );

	return 'bartag: ' . $atts['foo'] . ' ' . $atts['bar'];
}
add_shortcode( 'bartag', 'bartag_func' );

[bartag foo="koala" bar="bears"] outputs the following:
bartag: koala bears

[bartag foo="koala"] outputs the following:
bartag: koala default bar

This creates a "[bartag]" shortcode that supports two attributes: [bartag foo="something" bar="something else"]. Both attributes are optional and will take on default options if they are not provided.

Notes

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.

Change Log

• 3.6: The function now passes the $atts through the 'shortcode_atts_{$shortcode}' filter, when the $shortcode parameter is supplied.
• Since: 2.5

Source File

shortcode_atts() is located in wp-includes/shortcodes.php.

Resources

• WordPress Shortcodes Generator

Related

wp_parse_args()

Shortcode API

• Function: do_shortcode()
• Function: add_shortcode()
• Function: remove_shortcode()
• Function: remove_all_shortcodes()
• Function: shortcode_atts()
• Function: strip_shortcodes()
• Function: shortcode_exists()
• Function: has_shortcode()
• Function: get_shortcode_regex()
• Function: wp_audio_shortcode()
• Function: wp_video_shortcode()
• Filter: no_texturize_shortcodes