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