Customizer Optionen in Child Theme hinzufügen

Es gibt die Möglichkeit im Child Theme eigene Customizer Optionen hinzuzufügen. In der functions.php sollte eine Funktion an die hook „add_customizer_options“ gebunden werden:

add_action( 'add_customizer_options' , function($panel){
    $section = bundesweit_theme_customize::add_customizer_section("Child Theme Section", $panel);

    bundesweit_theme_customize::add_customizer_text_option("Telefon", "company_phone", $section);
});

Dieser Code fügt eine neue Sektion mit einem neuen Select Feld hinzu. Eine Sektion muss immer einem Panel zugefügt werden, in diesem Fall wird das bundesweit.digital Panel bereits im Funktionsparameter $panel übergeben.

Mögliche Felder sind:

  • bundesweit_theme_customize::add_customizer_section($section_name, $panel); – Gibt eine $section zurück die für die folgenden Optionen verwendet werden kann.
  • bundesweit_theme_customize::add_customizer_text_option($text, $variable_name, $section, $default = 0);
  • bundesweit_theme_customize::add_customizer_color_option($name, $variable_name, $section);
  • bundesweit_theme_customize::add_customizer_select_option($name, $variable_name, $options_array, $section);
  • bundesweit_theme_customize::add_customizer_color_option($name, $variable_name, $section, $default = “);
  • bundesweit_theme_customize::add_customizer_image_option($name, $variable_name, $section);

Neue Option in eine bestehende Sektion einfügen (ab v 1.7.0) #

Mit der Hook add_customizer_options_in_section kann auch ein neues Optionsfeld in eine bestehende Kategorie eingefügt werden. Die Hook übergibt dabei 2 Parameter:

  • String $section_name
    • Header
    • Footer
    • Farben
    • Schriftarten
    • Allgemeine Einstellungen
    • Unternehmen
    • Buttons
    • Seitenoptionen
  • SektionHandle $section
    • Handle der aktuellen Sektion

Und der zweite Parameter ist das Sektions-Handle in das die Option hinzugefügt werden kann.

add_action('add_customizer_options_in_section', 'customizer_sections', 10, 2);

function customizer_sections($section_name, $section){

    if( $section_name == "Unternehmen" ){
        bundesweit_theme_customize::add_customizer_text_option("Handelskammer", "company_handelskammer", $section);
    }

}

Daten auf WordPress Seite auslesen #

Die Daten können innerhalb jeder PHP Datei mit dem Befehl get_theme_mod($variable_name, ‚Default‘) ausgelesen werden. Sollte der Wert im Customizer nicht gesetzt sein, wird der Default Wert (2. Parameter) zurück gegeben. Der Default Parameter ist optional.

Eingeführt zu budigital 1.6.0

Powered by BetterDocs