Wordpress Admin Settings Pages Hinzufügen

Mit diesem Code Beispiel werden zwei Options / Settings Pages für Wordpress hinzugefügt. Dieser Code fügt nur die Seiten ins Menü ein. Es müssen noch Render Funktionen geschrieben werden, die eine Ausgabe erzeugen. Der Namespace ist optional, macht die Sache aber sauberer.

Settings-Page Registrieren

<?php
 
namespace PluginNamespace\Adminpages;
 
add_action( 'admin_menu', 'PluginNamespace\Adminpages\add_admin_page' );
 
function add_admin_page() {
 
	$page_title    = 'Hauptseite';
	$menu_title    = 'Hauptseite';
	$capability    = 'edit_posts';
	$menu_slug     = 'plugin-hauptseite';
	$page_function = 'renderer_function_hauptseite'; // --> function renderer_function_hauptseite()
	$icon          = TDSR_URL . 'assets/gfx/icon_shield.png';
	$position      = 50;
	add_menu_page( $page_title, $menu_title, $capability, $menu_slug,  $page_function, $icon, $position );
 
	$parent_slug   = 'plugin-hauptseite';
	$page_title    = 'Submenü Titel';
	$menu_title    = 'Submenü Titel';
	$capability    = 'edit_posts';
	$menu_slug     = 'plugin-unterseite';
	$page_function = 'renderer_function_unterseite'; // --> function renderer_function_unterseite()
	add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $page_function );
 
}

Damit Unterseiten bei bestehenden Setting-Seiten eingebaut werden, muss der parent-slug angepasst werden. Um z.b. unter “plugins” im Menü aufzutauchen:

	$parent_slug   = 'plugins.php'; // <--
 
	// ...
 
	add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $page_function );

Mehr dazu in der Doku (siehe "used by"-Sektion).

HTML Ausgabe und Speichern

Page Renderer Function, so etwas wie:

function admin_setting_page_theme_links(){
	$menu_slug   = 'theme-links';
	$echo        = false;
	$form_action = menu_page_url( $menu_slug, $echo );
 
	$v = [
		'test_input' => save_and_load_option( 'test_input' ),
	];
 
	require_once 'tpl/admin-theme-links.php';
}
 
/* Rudimentäre Saving & Lade Function */
function save_and_load_option( $key, $default = null ){
	$value = get_option( $key, $default );
 
	if( isset( $_POST[$key] ) ){
		$new_value = $_POST[$key];
		$autoload  = false;
		update_option( $key, $new_value, $autoload );
		$value     = $new_value;
	}
 
	return $new_value;
}

HTML-Sub-File für das Template der Settings-Page, z.b.: tpl/page.php

<div class="wrap">
<h1>Your Plugin Page Title</h1>
<form method="post" action="<?php echo $form_action; ?>&action=save">
 
	<table class="form-table" role="presentation">
		<tbody>
			<tr>
				<th scope="row">
					<label for="">Label</label>
				</th>
				<td>
					<input name="test_input" type="text" id="" value="<?php echo $v['test_input']; ?>" class="regular-text" />
					<p class="description" id="tagline-description">Beschreibung</p>
				</td>
			</tr>
 
		</tbody>
	</table>
 
	<?php submit_button(); ?>
</form>
</div>

Page Tools