Читать книгу Entwicklung von WordPress-Plugins - Onno Gabriel - Страница 16

Mit der form()-Methode wird im Administrationsbereich ein Formular für die Konfiguration des Widgets erzeugt. Ihr wird als Argument $instance übergeben, also wie in der widget()-Methode ein Array mit den bisherigen Einstellungen in Form von Schlüssel-Wert-Paaren.

Ausgegeben wird nur der innere Teil des Formulars in Form von Labeln und den Eingabefeldern, denn um den Rest wie das <form>-Tag oder den Submit-Button kümmert sich automatisch die WP_Widget-Klasse. Als Beispiel ein Eingabefeld für den Widget-Titel:

<?php public function form( $instance ) { $title = ! empty( $instance['title'] ) ? $instance['title'] : esc_html__( 'Ein Titel', 'text_domain' ); $label = esc_attr_e('Title:', 'text_domain'); $id = esc_attr($this->get_field_id( 'title')); $name = echo esc_attr($this->get_field_name('title')); ?><p> <label for="<?php echo $id; ?>"> <?php echo $label; ?> </label> <input class="widefat" id="<?php echo $id; ?>" name="<?php echo $name; ?>" type="text" value="<?php echo esc_attr( $title ); ?>"> </p><?php } ?>

Auch hier im Beispiel finden Escape-Funktionen wie esc_attr() esc_html__() Anwendung, mit denen problematische Zeichen bei der Ausgabe maskiert werden, siehe auch das Kapitel Absichern von Ausgabedaten.