Читать книгу Entwicklung von WordPress-Plugins - Onno Gabriel - Страница 15
Die widget()
-Methode
ОглавлениеDie widget()
-Methode übernimmt die Ausgabe des Widget-Inhalts. Ihr werden dazu zwei Argumente ($args
und $instance
) übergeben:
$args
ist ein assoziatives Array, in dem u.a. HTML-Elemente gespeichert sind, die vor und nach dem Widget und vor und nach dem Widget-Titel eingesetzt werden können 1. Damit wird sicher gestellt, dass das Widget sich nahtlos an verschiedene Themes anpassen kann, denn diese HTML-Elemente werden vom Theme definiert. Ein einfaches Beispiel für das $args
-Array:
$args = array( 'before_widget' => '<div>', 'after_widget' => '</div>', 'before_title' => '<h2 class="rounded">', 'after_title' => '</h2>' );
Das zweite Argument $instance
enthält ein assoziatives Array mit den Einstellungen für das Widget. Diese werden im Administrationsbereich unter Design/Widgets vorgenommen.
Zum Beispiel enthält $instance['title']
den Widget-Titel. Genutzt werden diese Elemente bei der Widget-Ausgabe, zum Beispiel:
<?php public function widget( $args, $instance ) { echo $args['before_widget']; if ( ! empty( $instance['title'] ) ) { echo $args['before_title']; echo $instance['title']; echo $args['after_title']; } echo esc_html__( 'Hallo Welt!', 'text_domain' ); echo $args['after_widget']; } ?>