Несколько входов в элементе настройки настройщика

16

Скажем, у меня есть один пользовательский элемент управления, но этот элемент управления имеет 2 входа, которые требуют сохранения, например:

  • Тип валюты и стоимость
  • Размер и единица измерения
  • Имя и фамилия
  • Текст и стиль
  • Изображение и размер изображения
  • Семейство шрифтов и вес шрифта

Как бы я это сделал? Я вижу, что есть опция настройки при создании элемента управления, но нет документации, которая бы подсказывала, как он используется, и единственным примером того, как это делается в дикой природе, является Easy Google Fonts, который не имеет объяснения относительно того, как это делается, и трудно читать. Можно ли вложить элементы управления и разделы?

Пока что все учебники и документация, которые я нашел, говорят об элементе управления с одним вводом html, ни в одном из них не упоминаются элементы управления с несколькими входами / настройками, несмотря на то, что это было предложено API

Том Дж Новелл
источник
Используется ли пользовательский элемент управления с API настройки темы WordPress: codex.wordpress.org/Theme_Customization_API или API настроек: codex.wordpress.org/Settings_API ?
Рэйчел Бейкер
Тематический мод - это то, что мои тесты использовали до сих пор, хотя я не предпочитаю ни одного, и приму объяснение для одного или другого или обоих
Том Дж. Новелл

Ответы:

17

Этот плагин демонстрирует, как это сделать. Следует отметить следующие шаги:

  • Зарегистрируйте каждую настройку для обновления / изменения
  • При создании элемента управления передайте массив в качестве аргумента настройки
  • При рендеринге входных данных передайте ключ настроек для ссылки и значения
  • Ключ настроек - это не имя настройки, а индексы массива, например 0, 1, 2
  • Доступ к настройкам, зарегистрированным для элемента управления, через $this->settings

Вот код:

<?php
/*
Plugin Name: TJN Typography Control Demo
Author: Tom J Nowell
Version: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
*/

add_action( 'customize_register', 'tjn_customize_register' );
function tjn_customize_register( $wp_customize ) {
    if ( ! isset( $wp_customize ) ) {
        return;
    }
    if ( class_exists( 'WP_Customize_Control' ) ) {

        class Toms_Control_Builder extends WP_Customize_Control {

            public $html = array();

            public function build_field_html( $key, $setting ) {
                $value = '';
                if ( isset( $this->settings[ $key ] ) )
                    $value = $this->settings[ $key ]->value();
                $this->html[] = '<div><input type="text" value="'.$value.'" '.$this->get_link( $key ).' /></div>';
            }

            public function render_content() {
                $output =  '<label>' . $this->label .'</label>';
                echo $output;
                foreach( $this->settings as $key => $value ) {
                    $this->build_field_html( $key, $value );
                }
                echo implode( '', $this->html );
            }

        }

        $section = new TJN_Customizer_Section( $wp_customize, 'test', 'Test', 11 );
        $field = new TJN_Customizer_Field( 'testfield','','Test Control' );
        $field->add_to_section( $wp_customize, $section );
    }
}


class TJN_Customizer_Section {
    public $name='';
    public $pretty_name='';
    public function __construct( WP_Customize_Manager $wp_customize, $name, $pretty_name, $priority=25 ) {
        $this->name = $name;
        $this->pretty_name = $pretty_name;

        $wp_customize->add_section( $this->getName(), array(
            'title'          => $pretty_name,
            'priority'       => $priority,
            'transport'      => 'refresh'
        ) );
    }

    public function getName() {
        return $this->name;
    }
    public function getPrettyName() {
        return $this->pretty_name;
    }
}

class TJN_Customizer_Field {

    private $name;
    private $default;
    private $pretty_name;

    public function __construct( $name, $default, $pretty_name ) {
        $this->name = $name;
        $this->default = $default;
        $this->pretty_name = $pretty_name;
    }

    public function add_to_section( WP_Customize_Manager $wp_customize, TJN_Customizer_Section $section ) {

        $wp_customize->add_setting( $this->name, array(
            'default'        => $this->default,
            'type'           => 'theme_mod',
            'capability'     => 'edit_theme_options'
        ) );
        $wp_customize->add_setting( 'moomins', array(
            'default'        => $this->default,
            'type'           => 'theme_mod',
            'capability'     => 'edit_theme_options'
        ) );
        $wp_customize->add_setting( 'papa', array(
            'default'        => $this->default,
            'type'           => 'theme_mod',
            'capability'     => 'edit_theme_options'
        ) );

        $control = new Toms_Control_Builder(
            $wp_customize, $this->name, array(
            'label'    => $this->pretty_name,
            'section'  => $section->getName(),
            'settings'   => array (
                $this->name,
                'moomins',
                'papa'
            )
        ) );

        $wp_customize->add_control( $control );
    }
}
Том Дж Новелл
источник
2
Как раз то, что мне было нужно, Теперь я могу спать спокойно
chifliiiii