shortcode_atts() WordPress Function
Function: shortcode_atts() Description: Merges user shortcode attributes with known attributes and fills in defaults when needed. This function is used when you want to allow users to specify shortcode attributes while also providing default values in case the user doesn't specify anything.
shortcode_atts( array $pairs, array $atts, string $shortcode = '' ) #
Combine user attributes with known attributes and fill in defaults when needed.
Description
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.
Parameters
- $pairs
(array)(Required)Entire list of supported attributes and their defaults.
- $atts
(array)(Required)User defined attributes in shortcode tag.
- $shortcode
(string)(Optional) The name of the shortcode, provided for context to enable filtering
Default value: ''
Return
(array) Combined and filtered attribute list.
Source
File: wp-includes/shortcodes.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; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
2.5.0 | Introduced. |