Costruttore.

Descrizione

Gli $args forniti sovrascrivono le proprietà predefinite della classe.

Parametri

$gestore

(WP_Customize_Manager)(Richiesto)Istanza bootstrap del customizer.

$id

(stringa)(Richiesto)Un ID specifico dell'impostazione. Può essere il nome di un tema o di un'opzione.

$args

(array)(Opzionale)Array di proprietà per il nuovo oggetto Setting.

  • 'tipo'
    (stringa) Tipo di impostazione. Predefinito 'theme_mod'.
  • 'capacità'
    (stringa) Capacità richiesta per l'impostazione. Predefinito 'edit_theme_options'
  • 'temi_supportati'
    (stringa|stringa[]) Caratteristiche del tema necessarie per supportare il pannello. L'impostazione predefinita è nessuna.
  • 'predefinito'
    (stringa) Valore predefinito per l'impostazione. Il valore predefinito è una stringa vuota.
  • 'trasporto'
    (stringa) Opzioni per il rendering dell'anteprima live delle modifiche nel Customizer. L'uso di 'refresh' rende visibile la modifica ricaricando l'intera anteprima. L'uso di 'postMessage' consente a un JavaScript personalizzato di gestire le modifiche in tempo reale. L'impostazione predefinita è "aggiorna".
  • 'validate_callback'
    (richiamabile) Richiamo di convalida lato server per il valore dell'impostazione.
  • 'sanitize_callback'
    (richiamabile) Callback per filtrare il valore di un'impostazione di Personalizza in forma non scheggiata.
  • 'sanitize_js_callback'
    (richiamabile) Callback per convertire il valore di un'impostazione PHP personalizzata in un valore serializzabile JSON.
  • 'dirty'
    (bool) Se l'impostazione è inizialmente sporca o meno quando viene creata.

Valore predefinito: array()

Fonte

File: wp-includes/class-wp-customize-setting.php

publicfunction__construct($manager,$id,$args=array()){$keys=array_keys(get_object_vars($this));foreach($keysas$key){if(isset($args[$key])){$this->$key=$args[$key];}}$this->manager=$manager;$this->id=$id;// Parse the ID for array keys.$this->id_data['keys']=preg_split('/[/',str_replace(']','',$this->id));$this->id_data['base']=array_shift($this->id_data['keys']);// Rebuild the ID.$this->id=$this->id_data['base'];if(!empty($this->id_data['keys'])){$this->id.='['implode('][',$this->id_data['keys'])']';}if($this->validate_callback){add_filter("customize_validate_{$this->id}",$this->validate_callback,10,3);}if($this->sanitize_callback){add_filter("customize_sanitize_{$this->id}",$this->sanitize_callback,10,2);}if($this->sanitize_js_callback){add_filter("customize_sanitize_js_{$this->id}",$this->sanitize_js_callback,10,2);}if('option'===$this->type||'theme_mod'===$this->type){// Other setting types can opt-in to aggregate multidimensional explicitly.$this->aggregate_multidimensional();// Allow option settings to indicate whether they should be autoloaded.if('option'===$this->type&&isset($args['autoload'])){self::$aggregated_multidimensionals[$this->type][$this->id_data['base']]['autoload']=$args['autoload'];}}}

Correlato

Utilizzi

Usi Descrizione
wp-includes/class-wp-customize-setting.php: WP_Customize_Setting::aggregate_multidimensional()

Imposta l'impostazione per i valori multidimensionali aggregati.
wp-includes/plugin.php: add_filter()

Aggancia una funzione o un metodo a un'azione di filtro specifica.

Utilizzato da

Usato da Descrizione
wp-includes/customize/class-wp-customize-custom-css-setting.php: WP_Customize_Custom_CSS_Setting::__construct()

Costruttore di WP_Customize_Custom_CSS_Setting.
wp-includes/customize/class-wp-customize-nav-menu-setting.php: WP_Customize_Nav_Menu_Setting::__construct()

Costruttore.
wp-includes/customize/class-wp-customize-nav-menu-item-setting.php: WP_Customize_Nav_Menu_Item_Setting::__construct()

Costruttore.

Changelog

Versione Descrizione
3.4.0 Introdotto.