[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

title

Body

[close]

/wp-includes/ -> class-wp-customize-widgets.php (summary)

WordPress Customize Widgets classes

File Size: 2074 lines (67 kb)
Included or required: 1 time
Referenced: 0 times
Includes or requires: 1 file
 wp-admin/includes/widgets.php

Defines 66 functions

  __construct()
  get_selective_refreshable_widgets()
  is_widget_selective_refreshable()
  get_setting_type()
  register_settings()
  filter_customize_dynamic_setting_args()
  get_post_value()
  override_sidebars_widgets_for_theme_switch()
  filter_customize_value_old_sidebars_widgets_data()
  filter_option_sidebars_widgets_for_theme_switch()
  customize_controls_init()
  schedule_customize_register()
  customize_register()
  is_panel_active()
  get_setting_id()
  is_wide_widget()
  parse_widget_id()
  parse_widget_setting_id()
  print_styles()
  print_scripts()
  enqueue_scripts()
  output_widget_control_templates()
  print_footer_scripts()
  get_setting_args()
  sanitize_sidebar_widgets()
  get_available_widgets()
  _sort_name_callback()
  get_widget_control()
  get_widget_control_parts()
  customize_preview_init()
  refresh_nonces()
  preview_sidebars_widgets()
  customize_preview_enqueue()
  print_preview_css()
  export_preview_data()
  tally_rendered_widgets()
  is_widget_rendered()
  is_sidebar_rendered()
  tally_sidebars_via_is_active_sidebar_calls()
  tally_sidebars_via_dynamic_sidebar_calls()
  get_instance_hash_key()
  sanitize_widget_instance()
  sanitize_widget_js_instance()
  sanitize_sidebar_widgets_js_instance()
  call_widget_update()
  wp_ajax_update_widget()
  customize_dynamic_partial_args()
  selective_refresh_init()
  filter_dynamic_sidebar_params()
  filter_wp_kses_allowed_data_attributes()
  start_dynamic_sidebar()
  end_dynamic_sidebar()
  filter_sidebars_widgets_for_rendering_widget()
  render_widget_partial()
  is_option_capture_ignored()
  get_captured_options()
  get_captured_option()
  count_captured_options()
  start_capturing_option_updates()
  capture_filter_pre_update_option()
  capture_filter_pre_get_option()
  stop_capturing_option_updates()
  setup_widget_addition_previews()
  prepreview_added_sidebars_widgets()
  prepreview_added_widget_instance()
  remove_prepreview_filters()

Functions
Functions that are not part of a class:

__construct( $manager )   X-Ref
Initial loader.

param: WP_Customize_Manager $manager Customize manager bootstrap instance.

get_selective_refreshable_widgets()   X-Ref
List whether each registered widget can be use selective refresh.

If the theme does not support the customize-selective-refresh-widgets feature,
then this will always return an empty array.

return: array Mapping of id_base to support. If theme doesn't support

is_widget_selective_refreshable( $id_base )   X-Ref
Determines if a widget supports selective refresh.

param: string $id_base Widget ID Base.
return: bool Whether the widget can be selective refreshed.

get_setting_type( $setting_id )   X-Ref
Retrieves the widget setting type given a setting ID.

param: string $setting_id Setting ID.
return: string|void Setting type.

register_settings()   X-Ref
Inspects the incoming customized data for any widget settings, and dynamically adds
them up-front so widgets will be initialized properly.


filter_customize_dynamic_setting_args( $args, $setting_id )   X-Ref
Determines the arguments for a dynamically-created setting.

param: false|array $args       The arguments to the WP_Customize_Setting constructor.
param: string      $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`.
return: false|array Setting arguments, false otherwise.

get_post_value( $name, $default = null )   X-Ref
Retrieves an unslashed post value or return a default.

param: string $name    Post value.
param: mixed  $default Default post value.
return: mixed Unslashed post value or default value.

override_sidebars_widgets_for_theme_switch()   X-Ref
Override sidebars_widgets for theme switch.

When switching a theme via the Customizer, supply any previously-configured
sidebars_widgets from the target theme as the initial sidebars_widgets
setting. Also store the old theme's existing settings so that they can
be passed along for storing in the sidebars_widgets theme_mod when the
theme gets switched.


filter_customize_value_old_sidebars_widgets_data( $old_sidebars_widgets )   X-Ref
Filters old_sidebars_widgets_data Customizer setting.

When switching themes, filter the Customizer setting old_sidebars_widgets_data
to supply initial $sidebars_widgets before they were overridden by retrieve_widgets().
The value for old_sidebars_widgets_data gets set in the old theme's sidebars_widgets
theme_mod.

param: array $old_sidebars_widgets
return: array

filter_option_sidebars_widgets_for_theme_switch( $sidebars_widgets )   X-Ref
Filters sidebars_widgets option for theme switch.

When switching themes, the retrieve_widgets() function is run when the Customizer initializes,
and then the new sidebars_widgets here get supplied as the default value for the sidebars_widgets
option.

param: array $sidebars_widgets
return: array

customize_controls_init()   X-Ref
Ensures all widgets get loaded into the Customizer.

Note: these actions are also fired in wp_ajax_update_widget().


schedule_customize_register()   X-Ref
Ensures widgets are available for all types of previews.

When in preview, hook to {@see 'customize_register'} for settings after WordPress is loaded
so that all filters have been initialized (e.g. Widget Visibility).


customize_register()   X-Ref
Registers Customizer settings and controls for all sidebars and widgets.


is_panel_active()   X-Ref
Determines whether the widgets panel is active, based on whether there are sidebars registered.

return: bool Active.

get_setting_id( $widget_id )   X-Ref
Converts a widget_id into its corresponding Customizer setting ID (option name).

param: string $widget_id Widget ID.
return: string Maybe-parsed widget ID.

is_wide_widget( $widget_id )   X-Ref
Determines whether the widget is considered "wide".

Core widgets which may have controls wider than 250, but can still be shown
in the narrow Customizer panel. The RSS and Text widgets in Core, for example,
have widths of 400 and yet they still render fine in the Customizer panel.

This method will return all Core widgets as being not wide, but this can be
overridden with the {@see 'is_wide_widget_in_customizer'} filter.

param: string $widget_id Widget ID.
return: bool Whether or not the widget is a "wide" widget.

parse_widget_id( $widget_id )   X-Ref
Converts a widget ID into its id_base and number components.

param: string $widget_id Widget ID.
return: array Array containing a widget's id_base and number components.

parse_widget_setting_id( $setting_id )   X-Ref
Converts a widget setting ID (option path) to its id_base and number components.

param: string $setting_id Widget setting ID.
return: WP_Error|array Array containing a widget's id_base and number components,

print_styles()   X-Ref
Calls admin_print_styles-widgets.php and admin_print_styles hooks to
allow custom styles from plugins.


print_scripts()   X-Ref
Calls admin_print_scripts-widgets.php and admin_print_scripts hooks to
allow custom scripts from plugins.


enqueue_scripts()   X-Ref
Enqueues scripts and styles for Customizer panel and export data to JavaScript.


output_widget_control_templates()   X-Ref
Renders the widget form control templates into the DOM.


print_footer_scripts()   X-Ref
Calls admin_print_footer_scripts and admin_print_scripts hooks to
allow custom scripts from plugins.


get_setting_args( $id, $overrides = array()   X-Ref
Retrieves common arguments to supply when constructing a Customizer setting.

param: string $id        Widget setting ID.
param: array  $overrides Array of setting overrides.
return: array Possibly modified setting arguments.

sanitize_sidebar_widgets( $widget_ids )   X-Ref
Ensures sidebar widget arrays only ever contain widget IDS.

Used as the 'sanitize_callback' for each $sidebars_widgets setting.

param: string[] $widget_ids Array of widget IDs.
return: string[] Array of sanitized widget IDs.

get_available_widgets()   X-Ref
Builds up an index of all available widgets for use in Backbone models.

return: array List of available widgets.

_sort_name_callback( $widget_a, $widget_b )   X-Ref
Naturally orders available widgets by name.

param: array $widget_a The first widget to compare.
param: array $widget_b The second widget to compare.
return: int Reorder position for the current widget comparison.

get_widget_control( $args )   X-Ref
Retrieves the widget control markup.

param: array $args Widget control arguments.
return: string Widget control form HTML markup.

get_widget_control_parts( $args )   X-Ref
Retrieves the widget control markup parts.

param: array $args Widget control arguments.
return: array {

customize_preview_init()   X-Ref
Adds hooks for the Customizer preview.


refresh_nonces( $nonces )   X-Ref
Refreshes the nonce for widget updates.

param: array $nonces Array of nonces.
return: array $nonces Array of nonces.

preview_sidebars_widgets( $sidebars_widgets )   X-Ref
When previewing, ensures the proper previewing widgets are used.

Because wp_get_sidebars_widgets() gets called early at {@see 'init' } (via
wp_convert_widget_settings()) and can set global variable `$_wp_sidebars_widgets`
to the value of `get_option( 'sidebars_widgets' )` before the Customizer preview
filter is added, it has to be reset after the filter has been added.

param: array $sidebars_widgets List of widgets for the current sidebar.
return: array

customize_preview_enqueue()   X-Ref
Enqueues scripts for the Customizer preview.


print_preview_css()   X-Ref
Inserts default style for highlighted widget at early point so theme
stylesheet can override.


export_preview_data()   X-Ref
Communicates the sidebars that appeared on the page at the very end of the page,
and at the very end of the wp_footer,


tally_rendered_widgets( $widget )   X-Ref
Tracks the widgets that were rendered.

param: array $widget Rendered widget to tally.

is_widget_rendered( $widget_id )   X-Ref
Determine if a widget is rendered on the page.

param: string $widget_id Widget ID to check.
return: bool Whether the widget is rendered.

is_sidebar_rendered( $sidebar_id )   X-Ref
Determines if a sidebar is rendered on the page.

param: string $sidebar_id Sidebar ID to check.
return: bool Whether the sidebar is rendered.

tally_sidebars_via_is_active_sidebar_calls( $is_active, $sidebar_id )   X-Ref
Tallies the sidebars rendered via is_active_sidebar().

Keep track of the times that is_active_sidebar() is called in the template,
and assume that this means that the sidebar would be rendered on the template
if there were widgets populating it.

param: bool   $is_active  Whether the sidebar is active.
param: string $sidebar_id Sidebar ID.
return: bool Whether the sidebar is active.

tally_sidebars_via_dynamic_sidebar_calls( $has_widgets, $sidebar_id )   X-Ref
Tallies the sidebars rendered via dynamic_sidebar().

Keep track of the times that dynamic_sidebar() is called in the template,
and assume this means the sidebar would be rendered on the template if
there were widgets populating it.

param: bool   $has_widgets Whether the current sidebar has widgets.
param: string $sidebar_id  Sidebar ID.
return: bool Whether the current sidebar has widgets.

get_instance_hash_key( $serialized_instance )   X-Ref
Retrieves MAC for a serialized widget instance string.

Allows values posted back from JS to be rejected if any tampering of the
data has occurred.

param: string $serialized_instance Widget instance.
return: string MAC for serialized widget instance.

sanitize_widget_instance( $value )   X-Ref
Sanitizes a widget instance.

Unserialize the JS-instance for storing in the options. It's important that this filter
only get applied to an instance *once*.

param: array $value Widget instance to sanitize.
return: array|void Sanitized widget instance.

sanitize_widget_js_instance( $value )   X-Ref
Converts a widget instance into JSON-representable format.

param: array $value Widget instance to convert to JSON.
return: array JSON-converted widget instance.

sanitize_sidebar_widgets_js_instance( $widget_ids )   X-Ref
Strips out widget IDs for widgets which are no longer registered.

One example where this might happen is when a plugin orphans a widget
in a sidebar upon deactivation.

param: array $widget_ids List of widget IDs.
return: array Parsed list of widget IDs.

call_widget_update( $widget_id )   X-Ref
Finds and invokes the widget update and control callbacks.

Requires that `$_POST` be populated with the instance data.

param: string $widget_id Widget ID.
return: WP_Error|array Array containing the updated widget information.

wp_ajax_update_widget()   X-Ref
Updates widget settings asynchronously.

Allows the Customizer to update a widget using its form, but return the new
instance info via Ajax instead of saving it to the options table.

Most code here copied from wp_ajax_save_widget().


customize_dynamic_partial_args( $partial_args, $partial_id )   X-Ref
Filters arguments for dynamic widget partials.

param: array|false $partial_args Partial arguments.
param: string      $partial_id   Partial ID.
return: array (Maybe) modified partial arguments.

selective_refresh_init()   X-Ref
Adds hooks for selective refresh.


filter_dynamic_sidebar_params( $params )   X-Ref
Inject selective refresh data attributes into widget container elements.

param: array $params {
return: array Params.

filter_wp_kses_allowed_data_attributes( $allowed_html )   X-Ref
Ensures the HTML data-* attributes for selective refresh are allowed by kses.

This is needed in case the `$before_widget` is run through wp_kses() when printed.

param: array $allowed_html Allowed HTML.
return: array (Maybe) modified allowed HTML.

start_dynamic_sidebar( $index )   X-Ref
Begins keeping track of the current sidebar being rendered.

Insert marker before widgets are rendered in a dynamic sidebar.

param: int|string $index Index, name, or ID of the dynamic sidebar.

end_dynamic_sidebar( $index )   X-Ref
Finishes keeping track of the current sidebar being rendered.

Inserts a marker after widgets are rendered in a dynamic sidebar.

param: int|string $index Index, name, or ID of the dynamic sidebar.

filter_sidebars_widgets_for_rendering_widget( $sidebars_widgets )   X-Ref
Filters sidebars_widgets to ensure the currently-rendered widget is the only widget in the current sidebar.

param: array $sidebars_widgets Sidebars widgets.
return: array Filtered sidebars widgets.

render_widget_partial( $partial, $context )   X-Ref
Renders a specific widget using the supplied sidebar arguments.

param: WP_Customize_Partial $partial Partial.
param: array                $context {
return: string|false

is_option_capture_ignored( $option_name )   X-Ref
Determines whether the captured option update should be ignored.

param: string $option_name Option name.
return: bool Whether the option capture is ignored.

get_captured_options()   X-Ref
Retrieves captured widget option updates.

return: array Array of captured options.

get_captured_option( $option_name, $default = false )   X-Ref
Retrieves the option that was captured from being saved.

param: string $option_name Option name.
param: mixed  $default     Optional. Default value to return if the option does not exist. Default false.
return: mixed Value set for the option.

count_captured_options()   X-Ref
Retrieves the number of captured widget option updates.

return: int Number of updated options.

start_capturing_option_updates()   X-Ref
Begins keeping track of changes to widget options, caching new values.


capture_filter_pre_update_option( $new_value, $option_name, $old_value )   X-Ref
Pre-filters captured option values before updating.

param: mixed  $new_value   The new option value.
param: string $option_name Name of the option.
param: mixed  $old_value   The old option value.
return: mixed Filtered option value.

capture_filter_pre_get_option( $value )   X-Ref
Pre-filters captured option values before retrieving.

param: mixed $value Value to return instead of the option value.
return: mixed Filtered option value.

stop_capturing_option_updates()   X-Ref
Undoes any changes to the options since options capture began.


setup_widget_addition_previews()   X-Ref
{@internal Missing Summary}

See the {@see 'customize_dynamic_setting_args'} filter.


prepreview_added_sidebars_widgets()   X-Ref
{@internal Missing Summary}

See the {@see 'customize_dynamic_setting_args'} filter.


prepreview_added_widget_instance()   X-Ref
{@internal Missing Summary}

See the {@see 'customize_dynamic_setting_args'} filter.


remove_prepreview_filters()   X-Ref
{@internal Missing Summary}

See the {@see 'customize_dynamic_setting_args'} filter.




Generated: Fri Oct 18 08:20:01 2019 Cross-referenced by PHPXref 0.7