WordPress.org

Ready to get started?Download WordPress

Codex

it:Riferimento funzioni/shortcode atts

Contents

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 ) {
	extract( shortcode_atts( array(
		'foo' => 'no foo',
		'bar' => 'default bar',
	), $atts, 'bartag' ) );

	return 'bartag: ' . $foo . ' ' . $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. Si noti che l'uso del metodo extract fa sì che ogni chiave nell'array combinato si trasformi nella corrispondente variabile, come $foo e $bar, per un facile accesso. L'array $atts e l'array di default non saranno modificati dopo la chiamata a shortcode_atts.

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

File sorgente

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

Correlati

wp_parse_args()

API degli Shortcode

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.