Читать книгу Entwicklung von WordPress-Plugins - Onno Gabriel - Страница 10
Shortcodes mit Attributen
ОглавлениеSehr flexibel wird der Einsatz von Shortcodes durch die Möglichkeit, der aufzurufenden Funktion zusätzlich eigene Attribute übergeben zu können, zum Beispiel:
[shortcode attribut_1='wert_1' attribut_2='wert_2']
Im Plugin werden diese Attribute einfach der Funktion übergeben:
<?php // Eigene Funktion definieren function meine_plugin_funktion( $atts ) { // eigener Code } // Shortcode bekannt machen und mit Funktion verbinden add_shortcode( 'mein_shortcode', 'meine_plugin_funktion' ); ?>
Die Attibute werden der Funktion dabei in Form eines assoziativen Arrays $atts
übergeben, im obigen Beispiel also
$atts = array( 'attribut_1' => 'wert_1', 'attribut_2' => 'wert_2' )
Über die WordPress-Funktion shortcode_atts()
können dem Array $atts
auch Standardwerte zugewiesen werden, die eingesetzt werden falls die Attribute nicht schon im Shortcode mit Werten versehen wurden:
<?php function meine_shortcode_funktion( $atts ) { $neue_atts = shortcode_atts( array( 'attribut_1' => 'Standardwert 1', 'attribut_2' => 'Standardwert 2', ), $atts ); // weiterer Code der Funktion } ?>