Quali tipi di controlli per $wp_customize->add_control() puoi usare?

Quanti e quali tipi di controlli per $wp_customize->add_control() puoi inserire nel pannello “personalizza”? Se stai sviluppando un tema questo elenco di controlli può aiutarti, se riscontri errori leggi la guida che ho scritto per te su come aggiungere controlli in modo corretto.

Iniziamo subito: nel pannello di amministrazione “Personalizza” di WordPress puoi aggiungere i seguenti controlli:

• Casella di testo -> text
• Numero -> number
• Casella di controllo -> checkbox

L’oggetto di tipo testo crea una casella di testo (input type=”text”) nella tua schermata di personalizzazione, il codice già pronto qui sotto spiega come si usa.

 $wp_customize->add_control( 'footer-copyright-text', array(
   'type'  => 'text',
   'label' => 'Copyright del footer',
   'description'    => 'Aggiungi testo di copyright del footer',
   'section' => 'your-section-name',
   'settings' => 'your-settings-name',
   'input_attrs' => array(
         'placeholder' => 'Powered by Eureka Theme',
         'disabled' => '', /* mantiene il pulsante disabilitato con ogni valore inserito */

         'class' => 'ekw_prova_class',
       )
   ));

Il campo di tipo numero ti permette di aggiungere appunto un numero alla tua schermata personalizza di WordPress, vediamo come funziona:

$wp_customize->add_control( 'h1-font-size', array(
    'type'  => 'number',
    'label' => 'Titoli h1',
    'description'    => 'Dimensione del font titoli h1 (px)',
    'section' => 'your-section-name', /*obbligatorio*/
    'settings' => 'your-settings-name', /*obbligatorio*/
    'priority' => 10,
    'input_attrs' => array(
            'placeholder' => '80px',
            'min' => -5,
            'max' => 200,
            'step' => 0.1,
            'class' => 'ekw_prova_class',
        ),
    ));

Gli unici parametri che necessitano un minimo di spiegazione sono i seguenti:

• input_attrs: Permette di inserire un qualsiasi attributo al campo input appena creato semplicemente specificando il nome (come elemento dell’array) e il suo valore (come valore di quell’elemento), ad esempio per inserire una classe personalizzata puoi aggiungere: ‘class’ => ‘ekw_prova_class’,
• min, max e step: servono per specificare un intervallo di numeri che la casella può contenere. Se il valore inserito esce da questo intervallo allora darà un errore al click sul tasto “Pubblica”.

Questo controllo permette di creare un checkbox selezionabile dall’utente. Non necessita di molti controlli e restituisce solo un parametro booleano 0 (false) o 1 (true).

$wp_customize->add_control( 'my-custom-checkbox', array(
     'type'  => 'checkbox',
     'label' => 'Mostra casella di controllo',
     'section' => 'your-section-name', /*obbligatorio*/
     'settings' => 'your-settings-name', /*obbligatorio*/
   ));

Questo controllo ti permette di creare una casella con diverse opzioni selezionabili, in pratica un elemento input type=”radio”.

   $wp_customize->add_control( 'your-control-name', array(
   'type'  => 'radio',
   'label' => 'Casella di controllo',
   'section' => 'your-section-name', /*obbligatorio*/
   'settings' => 'your-settings-name', /*obbligatorio*/
   'choices' => array(
      'right' => __( 'Destra' ),
      'left' => __( 'Sinistra' ),
    ),
   ));

para