This page redirects to an external site: https://developer.wordpress.org/reference/functions/shortcode_atts/

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

Descrizione

Combina gli attributi dello shortcode indicati dall'utente con gli attributi conosciuti utilizzando i valori predefiniti quando necessario. Il risultato sarà composto da ogni chiave degli attributi conosciuti combinati con i valori degli attributi dello shortcode.

Utilizzo

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

Parametri

$pairs

(array) (richiesto) Lista con tutti gli attributi supportati e i loro valori predefiniti

Default: Nessuno

$atts

(array) (richiesto) Attributi definiti dall'utente nel tag dello shortcode

Default: Nessuno

$shortcode

(string) (opzionale) Nome dello shortcode da usare nel filtro shortcode_atts_{$shortcode} - Anche se questo parametro è opzionale, è meglio indicarlo, altrimenti sarà impossibile per i plugin fare riferimento a questo shortcode per la pre-elaborazione.

Default: Nessuno

Valori restituiti

(array) 

Lista di attributi combinata e filtrata.

Esempi

function bartag_func( $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"] produce quanto segue:
bartag: koala bears

L'esempio sopra crea uno shortcode "[bartag]" che supporta due attributi: [bartag foo="something" bar="something else"]. Entrambi gli attributi sono opzionali e assumeranno valori predefiniti se non vengono indicati.

Note

Le coppie presenti in $pairs sono tutti gli attributi supportati dal chiamante, forniti come lista. Gli attributi restituiti conterranno solo quelli indicati in $pairs.

Se la lista $atts ha attributi non supportati, questi verranno ignorati e rimossi dalla lista finale restituita.

Log delle modfiche

• 3.6: La funzione ora passa l'array $atts attraverso il filtro shortcode_atts_{$shortcode}, quando il parametro $shortcode è indicato.
• Da: 2.5

File sorgente

shortcode_atts() si trova in wp-includes/shortcodes.php.

Correlati

wp_parse_args()

API degli Shortcode

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