email

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

Ti trovi in:
  1. blog Quali tipi di controlli per $wp_customize->add_control() puoi usare?

Pubblicato il , aggiornato il 11 Settembre 2021

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:

code

Casella di testo: $wp_customize->add_control() type=text

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',
       )
   ));
code

Numero: $wp_customize->add_control() type=number

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

oggetto numero di wp customizer
$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”.
code

Checkbox: $wp_customize->add_control() type=checkbox

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*/
   ));
code

Caselle scelta singola: $wp_customize->add_control() type=radio

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' ),
    ),
   ));
code

Numero: $wp_customize->add_control() type=text

para

Contattaci!

Preventivo sempre gratuito

Fabio Fresia, fondatore e titolare di Eureka Web di Asti

perm_device_information366 - 400 9542       emailinfo@agenziawebeureka.it

perm_identity
alternate_email
phonelink_ring
message