Eigene Einstellungen im WordPress-Admin anlegen

Individuelle WordPress-Funktionen lassen sich über eigene Einstellungen an den jeweiligen Einsatz anpassen. Die Settings API verbindet diese Auswahl mit der gewohnten Admin-Oberfläche, der Speicherung und den WordPress-Berechtigungen.

2 Min. von Erhard Sigrist

Individuelle Funktionen erhalten mit einer eigenen Einstellung eine verständliche Bedienoberfläche im WordPress-Admin. Die Settings API registriert die Option, prüft die Berechtigung beim Speichern und bindet das Feld in eine Admin-Seite ein.

Das folgende Beispiel ergänzt eine Einstellung für eine optionale Weiterleitung der Shop-Übersicht.

Einstellungsseite und Option registrieren

Der Code gehört in ein Plugin und ergänzt unter «Einstellungen» eine Seite für die Shop-Weiterleitung:

add_action( 'admin_menu', function() {
	add_options_page(
		'Shop-Weiterleitung',
		'Shop-Weiterleitung',
		'manage_options',
		'ud-shop-redirect',
		'ud_render_shop_redirect_settings'
	);
} );

add_action( 'admin_init', function() {
	register_setting(
		'ud_shop_redirect',
		'ud_shop_redirect_enabled',
		[
			'type'              => 'boolean',
			'sanitize_callback' => fn( $value ) => ! empty( $value ),
			'default'           => false,
		]
	);
} );

Die Option erhält einen eindeutigen Namen und speichert einen booleschen Wert. Die Berechtigung manage_options begrenzt den Zugang zur Seite auf Administratorinnen und Administratoren.

Kontrollfeld im Admin anzeigen

Die Funktion für die Einstellungsseite gibt das Kontrollfeld und die von WordPress verwalteten Formularfelder aus:

function ud_render_shop_redirect_settings() {
	if ( ! current_user_can( 'manage_options' ) ) {
		return;
	}

	$enabled = (bool) get_option( 'ud_shop_redirect_enabled' );
	?>
	<div class="wrap">
		<h1>Shop-Weiterleitung</h1>
		<form action="options.php" method="post">
			<?php settings_fields( 'ud_shop_redirect' ); ?>
			<label>
				<input name="ud_shop_redirect_enabled" type="checkbox" value="1" <?php checked( $enabled ); ?>>
				Shop-Übersicht auf die Startseite weiterleiten
			</label>
			<?php submit_button(); ?>
		</form>
	</div>
	<?php
}

Die Funktion settings_fields() ergänzt die notwendigen Felder für die WordPress-Speicherung. Der gespeicherte Wert steht anschliessend im gesamten Plugin über get_option( 'ud_shop_redirect_enabled' ) bereit.

Gespeicherte Option in der Funktion verwenden

Die Weiterleitung liest den gespeicherten Wert aus und führt die entsprechende Funktion aus:

add_action( 'template_redirect', function() {
	if ( is_shop() && get_option( 'ud_shop_redirect_enabled' ) ) {
		wp_safe_redirect( home_url( '/' ) );
		exit;
	}
} );

Admin-Formular und Weiterleitung bleiben dadurch getrennt. Die Einstellung lässt sich an einer Stelle erweitern, während ihre Verwendung im Frontend nachvollziehbar bleibt.

Admin-Kontrollfeld, gespeicherte Option und Weiterleitung zeigen die Steuerung einer Plugin-Funktion über WordPress.
Der gespeicherte Optionswert verbindet die Auswahl im Admin mit der Weiterleitung im Frontend.

Ergebnis

WordPress-Funktionen über eine eigene Einstellung bedienen

Die Settings API verbindet eine kleine Admin-Oberfläche mit der Speicherung und Berechtigung von WordPress. Das Plugin verwendet den gespeicherten Wert für die jeweilige Funktion.

Option im Admin pflegen

Die Einstellungsseite macht die Weiterleitung der Shop-Übersicht als Kontrollfeld sichtbar.

Wert sicher speichern

Settings API, Berechtigung und Bereinigung verbinden die Eingabe mit der WordPress-Option.

Funktion getrennt steuern

Das Plugin liest den gespeicherten Wert dort aus, wo die Weiterleitung ausgeführt wird.