Constructor.
Description
Any supplied $args override class property defaults.
Parameters
$manager
WP_Customize_Managerrequired- Customizer bootstrap instance.
$id
stringrequired- A specific ID of the section.
$args
arrayoptional- Array of properties for the new Section object.
priority
intPriority of the section, defining the display order of panels and sections. Default 160.panel
stringThe panel this section belongs to (if any).
capability
stringCapability required for the section.
Default'edit_theme_options'
theme_supports
string|string[]Theme features required to support the section.title
stringTitle of the section to show in UI.description
stringDescription to show in the UI.type
stringType of the section.active_callback
callableActive callback.description_hidden
boolHide the description behind a help icon, instead of inline above the first control.
Default false.
Default:
array()
Source
public function __construct( $manager, $id, $args = array() ) {
$keys = array_keys( get_object_vars( $this ) );
foreach ( $keys as $key ) {
if ( isset( $args[ $key ] ) ) {
$this->$key = $args[ $key ];
}
}
$this->manager = $manager;
$this->id = $id;
if ( empty( $this->active_callback ) ) {
$this->active_callback = array( $this, 'active_callback' );
}
self::$instance_count += 1;
$this->instance_number = self::$instance_count;
$this->controls = array(); // Users cannot customize the $controls array.
}
Changelog
Version | Description |
---|---|
3.4.0 | Introduced. |
active_callback
argument is a callback that determines when this section will be visible (active) in the customizer. Its value can be something likeis_front_page
In case you want to change the location of your Panel (or Section), these are the priorities of the core sections:
Site Title & Tagline (title_tagline): 20
Colors (colors): 40
Header Image (header_image): 60
Background Image (background_image): 80
Menus (Panel) (nav_menus): 100
Widgets (Panel) (widgets): 110
Static Front Page (static_front_page): 120
default: 160
Additional CSS (custom_css): 200