| [ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Source view] [Print] [Project Stats]
WordPress Customize Control classes
WP_Customize_Control:: (17 methods):
__construct()
enqueue()
active()
active_callback()
value()
to_json()
json()
check_capabilities()
get_content()
maybe_render()
render()
get_link()
link()
input_attrs()
render_content()
print_template()
content_template()
Class: WP_Customize_Control - X-Ref
Customize Control class.| __construct( $manager, $id, $args = array() X-Ref |
| Constructor. Supplied `$args` override class property defaults. If `$args['settings']` is not defined, use the `$id` as the setting ID. param: WP_Customize_Manager $manager Customizer bootstrap instance. param: string $id Control ID. param: array $args { |
| enqueue() X-Ref |
| Enqueues control related scripts/styles. |
| active() X-Ref |
| Checks whether control is active to current Customizer preview. return: bool Whether the control is active to the current preview. |
| active_callback() X-Ref |
| Default callback used when invoking WP_Customize_Control::active(). Subclasses can override this with their specific logic, or they may provide an 'active_callback' argument to the constructor. return: true Always true. |
| value( $setting_key = 'default' ) X-Ref |
| Fetches a setting's value. Grabs the main setting by default. return: mixed The requested setting's value, if the setting exists. param: string $setting_key |
| to_json() X-Ref |
| Refreshes the parameters passed to the JavaScript via JSON. |
| json() X-Ref |
| Gets the data to export to the client via JSON. return: array Array of parameters passed to the JavaScript. |
| check_capabilities() X-Ref |
| Checks if the user can use this control. Returns false if the user cannot manipulate one of the associated settings, or if one of the associated settings does not exist. Also returns false if the associated section does not exist or if its capability check returns false. return: bool False if theme doesn't support the control or user doesn't have the required permissions, otherwise true. |
| get_content() X-Ref |
| Gets the control's content for insertion into the Customizer pane. return: string Contents of the control. |
| maybe_render() X-Ref |
| Checks capabilities and render the control. |
| render() X-Ref |
| Renders the control wrapper and calls $this->render_content() for the internals. |
| get_link( $setting_key = 'default' ) X-Ref |
| Gets the data link attribute for a setting. return: string Data link parameter, a `data-customize-setting-link` attribute if the `$setting_key` refers param: string $setting_key |
| link( $setting_key = 'default' ) X-Ref |
| Renders the data link attribute for the control's input element. param: string $setting_key Default 'default'. |
| input_attrs() X-Ref |
| Renders the custom attributes for the control's input element. |
| render_content() X-Ref |
| Renders the control's content. Allows the content to be overridden without having to rewrite the wrapper in `$this::render()`. Supports basic input types `text`, `checkbox`, `textarea`, `radio`, `select` and `dropdown-pages`. Additional input types such as `email`, `url`, `number`, `hidden` and `date` are supported implicitly. Control content can alternately be rendered in JS. See WP_Customize_Control::print_template(). |
| print_template() X-Ref |
| Renders the control's JS template. This function is only run for control types that have been registered with WP_Customize_Manager::register_control_type(). In the future, this will also print the template for the control's container element and be override-able. |
| content_template() X-Ref |
| An Underscore (JS) template for this control's content (but not its container). Class variables for this control class are available in the `data` JS object; export custom variables by overriding WP_Customize_Control::to_json(). |
| Generated : Fri Feb 21 08:20:01 2025 | Cross-referenced by PHPXref |