Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: dynamic_sidebar_before

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 2 times in this file.

Line Code
964                     $index = $key;
965                     break;
966                }
967           }
968      }
969
970      $sidebars_widgets = wp_get_sidebars_widgets();
971      if ( empty( $wp_registered_sidebars[ $index ] ) || empty( $sidebars_widgets[ $index ] ) || ! is_array( $sidebars_widgets[ $index ] ) ) {
972           /** This action is documented in wp-includes/widgets.php */
973           do_action( 'dynamic_sidebar_before', $index, false );
974           /** This action is documented in wp-includes/widgets.php */
975           do_action( 'dynamic_sidebar_after',  $index, false );
976           /** This filter is documented in wp-includes/widgets.php */
977           return apply_filters( 'dynamic_sidebar_has_widgets', false, $index );
978      }
979
980      /**
981       * Fires before widgets are rendered in a dynamic sidebar.
982       *
983       * Note: The action also fires for empty sidebars, and on both the front-end
984       * and back-end, including the Inactive Widgets sidebar on the Widgets screen.
985       *
986       * @since 3.9.0
987       *
988       * @param int|string $index       Index, name, or ID of the dynamic sidebar.
989       * @param bool       $has_widgets Whether the sidebar is populated with widgets.
990       *                                Default true.
991       */
992      do_action( 'dynamic_sidebar_before', $index, true );
993      $sidebar = $wp_registered_sidebars[$index];
994
995      $did_one = false;
996      foreach ( (array) $sidebars_widgets[$index] as $id ) {
997
998           if ( !isset($wp_registered_widgets[$id]) ) continue;
999
1000           $params = array_merge(
1001                array( array_merge( $sidebar, array('widget_id' => $id, 'widget_name' => $wp_registered_widgets[$id]['name']) ) ),