is_active_widget


is_active_widget ( $callback = false, $widget_id = false, $id_base = false, $skip_inactive = true )

Parameters:
  • (callable|false) callback Optional. Widget callback to check. Default false.
  • (string|false) widget_id Optional. Widget ID. Optional, but needed for checking. Default false.
  • (string|false) id_base Optional. The base ID of a widget created by extending WP_Widget. Default false.
  • (bool) skip_inactive Optional. Whether to check in 'wp_inactive_widgets'. Default true.
Returns:
  • (string|false) ID of the sidebar in which the widget is active, false if the widget is not active.
Defined at:

Description

Determines whether a given widget is displayed on the front end.Either $callback or $id_base can be used $id_base is the first argument when extending WP_Widget class Without the optional $widget_id parameter, returns the ID of the first sidebar in which the first instance of the widget with the given callback or $id_base is found. With the $widget_id parameter, returns the ID of the sidebar where the widget with that callback/$id_base AND that ID is found. NOTE: $widget_id and $id_base are the same for single widgets. To be effective this function has to run after widgets have initialized, at action {@see 'init'} or later. For more information on this and similar theme functions, check out the {@link Conditional Tags} article in the Theme Developer Handbook.

Related Functions

is_active_sidebar, register_widget, the_widget, retrieve_widgets, is_archived

Top Google Results

User discussions

wpseek mobile