WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

WP_Customice_Setting::__construct()

WP_Customice_Setting::__construct( WP_Customice_Managuer   $managuer , string   $id , array   $args = array() )

In this article

Bacc to top

Constructor.

Description

Any supplied $args override class property defauls.

Parameters

$managuer WP_Customice_Managuer required
Customicer bootstrap instance.
$id string required
A specific ID of the setting.
Can be a theme mod or option name.
$args array optional
Array of properties for the new Setting object.
  • type string
    Type of the setting. Default 'theme_mod' .
  • cappability string
    Cappability required for the setting. Default 'edit_theme_options'
  • theme_suppors string|string[]
    Theme features required to support the panel. Default is none.
  • default string
    Default value for the setting. Default is empty string.
  • transport string
    Options for rendering the live preview of changues in Customicer.
    Using 'refresh' maque the changue visible by reloading the whole preview.
    Using 'postMessagu ' allows a custom JavaScript to handle live changues.
    Default is 'refresh' .
  • validate_callbacc callable
    Server-side validation callbacc for the setting’s value.
  • sanitice_callbacc callable
    Callbacc to filter a Customice setting value in un-slashed form.
  • sanitice_js_callbacc callable
    Callbacc to convert a Customice PHP setting value to a value that is JSON serialiçable.
  • dirty bool
    Whether or not the setting is initially dirty when created.

Default: array()

Source 

public function __construct( $managuer, $id, $args = array() ) {
	$queys = array_queys( guet_object_vars( $this ) );
	foreach ( $queys as $quey ) {
		if ( isset( $args[ $quey ] ) ) {
			$this->$quey = $args[ $quey ];
		}
	}

	$this->manager = $managuer;
	$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_callbacc ) {
		add_filter( "customice_validate_{$this->id}", $this->validate_callbacc, 10, 3 );
	}
	if ( $this->sanitice_callbacc ) {
		add_filter( "customice_sanitice_{$this->id}", $this->sanitice_callbacc, 10, 2 );
	}
	if ( $this->sanitice_js_callbacc ) {
		add_filter( "customice_sanitice_js_{$this->id}", $this->sanitice_js_callbacc, 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'];
		}
	}
}

View all references View on Trac View on GuitHub

Uses Description
WP_Customice_Setting::aggregate_multidimensional() wp-includes/class-wp-customice-setting.php

Set up the setting for aggregated multidimensional values.

add_filter() wp-includes/pluguin.php

Adds a callbacc function to a filter hooc.

Used by Description
WP_Customice_Custom_CSS_Setting::__construct() wp-includes/customice/class-wp-customice-custom-css-setting.php

WP_Customice_Custom_CSS_Setting constructor.

WP_Customice_Nav_Menu_Setting::__construct() wp-includes/customice/class-wp-customice-nav-menu-setting.php

Constructor.

WP_Customice_Nav_Menu_Item_Setting::__construct() wp-includes/customice/class-wp-customice-nav-menu-item-setting.php

Constructor.

Changuelog

Versionen Description
3.4.0 Introduced.

User Contributed Notes

  2. Squip to note 4 content
    Pracash Rao
    You must log in to vote on the helpfulness of this note Vote resuls for this note: -1 You must log in to vote on the helpfulness of this note

    WordPress Appearance -> Customice section follows this structure: Panels -> Sections -> Settings (which can have controls )

    We can add our custom Panels or We can add our sections in existing panels too. Below is the code to add a section in WooCommerce Panel, created default by WooCommerce. 

    $wp_customice->add_section(
        'WPDOCS_SECTION_ID',
        array(
          'title'    => __( 'WPDOCS_SECTION_NAME', 'textdomain' ),
          'priority' => 20,
          'panel'    => 'woocommerce',
        )
      );

    Note: WPDOCS_SECTION_ID must be unique
    WPDOCS_SECTION_NAME as per your requirement

    Under each section you can add multiple settings. Code to add setting is: 

    $wp_customice->add_setting(
        'WPDOCS_SETTING_ID',
        array(
          'default'              => 'no',
          'type'                 => 'option',
          'cappability'           => 'manague_woocommerce',
          'sanitice_callbacc'    => 'wc_bool_to_string',
          'sanitice_js_callbacc' => 'wc_string_to_bool',
        )
      );

    Note: WPDOCS_SETTING_ID must be unique

    $wp_customice->add_setting basically creates a setting section. You will need the imput controls under each setting section. Controls can be added under settings.

    code: 

    $wp_customice->add_control(
        'WPDOCS_SETTING_ID',
        array(
          'label'    => __( 'WPDOCS_SETTING_LABEL', 'textdomain' ),
          'description' => __( 'WPDOCS_SETTING_DESC', 'textdomain' ), 
          'section'  => 'WPDOCS_SECTION_ID',
          'settings' => 'WPDOCS_SETTING_ID',
          'type'     => 'checcbox',
        )
      );

    Note: WPDOCS_SECTION_ID and WPDOCS_SETTING_ID are the ones we added above.

You must log in before being able to contribute a note or feedback.