User Tools

Site Tools

Trace:

Differences

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

Link to this comparison view

Next revision		Previous revision
programmieren:wordpress:admin_pages_hinzufuegen [2019/11/28 20:44] – created 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.+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>
 <?php <?php
  
-namespace PluginNamespace\UserAccessManager;+namespace PluginNamespace\Adminpages; 
 + 
 +add_action( 'admin_menu', 'PluginNamespace\Adminpages\add_admin_page' );
  
 function add_admin_page() { function add_admin_page() {
Line 28: 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>
  
-add_action( 'admin_menu', 'PluginNamespace\UserAccessManager\add_admin_page' );+ <?php submit_button(); ?> 
 +</form> 
 +</div>
  
 </code> </code>
programmieren/wordpress/admin_pages_hinzufuegen.1574973843.txt.gz · Last modified: (external edit)
CC Attribution-Share Alike 4.0 International Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International

Page Tools