Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
programmieren:wordpress:admin_pages_hinzufuegen [2019/11/28 20:45] jgehrkeprogrammieren:wordpress:admin_pages_hinzufuegen [2022/12/17 12:28] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Wordpress Admin Pages Hinzufügen ======+====== 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. 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.
 +
 +===== 1. Settings-Page Registrieren (ohne Klasse) =====
  
 <code php> <code php>
Line 30: Line 32:
  
 } }
 +</code>
 +
 +Damit Unterseiten bei bestehenden Setting-Seiten eingebaut werden, muss der parent-slug angepasst werden.  Um z.b. unter "plugins" im Menü aufzutauchen:
 +
 +<code php>
 + $parent_slug   = 'plugins.php'; // <--
 +
 + // ...
 +
 + add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $page_function );
 +</code>
 +
 +Mehr dazu in der [[https://developer.wordpress.org/reference/functions/add_submenu_page/#used-by|Doku (siehe "used by"-Sektion)]].
 +
 +
 +===== 2. Settings-Page als PHP-Klasse =====
 +
 +Es kann nützlich sein Settings als PHP Class oder Objekt zu registrieren, damit alles in einem geschlossenem Objekt bleibt, z.b. für Plugins. Mit diesem Code wird eine Backendpage erzeugt. 
 +
 +<code php>
 +<?php
 +
 +namespace mein_namespace;
 +
 +/**
 + *
 + */
 +class Overview
 +{
 +
 + private $plugin_url = '';
 +
 + function __construct( $plugin_url )
 + {
 + $this->plugin_url = $plugin_url;
 + add_action( 'admin_menu', [ $this, 'add_page'] );
 + add_action( 'admin_enqueue_scripts', [ $this, 'register_scripts_styles' ] );
 + }
 +
 + public function add_page()
 + {
 + $page_title    = 'Tracking';
 + $menu_title    = 'Tracking';
 + $capability    = 'edit_posts';
 + $menu_slug     = 'plugin-hauptseite';
 + $page_function = [ $this, 'render_page'];
 + $icon          = $this->plugin_url . 'assets/gfx/icon-line-chart-fill-white.png';
 + $position      = 50;
 + add_menu_page( $page_title, $menu_title, $capability, $menu_slug,  $page_function, $icon, $position );
 + }
 +
 + public function register_scripts_styles(){
 + // Style Registrieren (noch nicht einbetten)
 + /*
 + $handle  = 'plugin-admin-style';
 + $src     = this->plugin_url . 'css/plugin_style.css';
 + $deps    = [];
 + $version = '1.0';
 + wp_register_style( $handle, $src, $deps, $version );
 + */
 +
 + // Script Registrieren (noch nicht einbetten)
 + /*
 + $handle    = 'alpine';
 + $src       = this->plugin_url  . 'js/alpine.min.js';
 + $deps      = [];
 + $version   = '3.0';
 + $in_footer = false;
 + wp_register_script( $handle, $src, $deps, $version,$in_footer );
 + */
 + }
 +
 + public function render_page()
 + {
 + //wp_enqueue_script( 'alpine' ); // Registriertes Script einbinden
 + //wp_enqueue_style( 'moewe-arrowchat-admin-style' ); // Registrierten Style einbinden
 +
 + echo "<h1>Test</h1>";
 + include "html-datei.html";
 + }
 +}
 +
 +</code>
 +
 +===== 3. HTML Ausgabe und Speichern (rudimentär) =====
 +
 +Page Renderer Function, so etwas wie:
 +<code php>
 +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;
 +}
 +
 +</code>
 +
 +HTML-Sub-File für das Template der Settings-Page, z.b.: ''tpl/page.php''
 +<code 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>
  
 </code> </code>

Page Tools