wp_get_sidebars_widgets

The timeline below displays how wordpress function wp_get_sidebars_widgets has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.3

//
// Internal Functions.
//
/**
 * Retrieve full list of sidebars and their widget instance IDs.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @global array $_wp_sidebars_widgets
 * @global array $sidebars_widgets
 *
 * @param bool $deprecated Not used (argument deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if (true !== $deprecated) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    /*
     * If loading from front page, consult $_wp_sidebars_widgets rather than options
     * to see if wp_convert_widget_settings() has made manipulations in memory.
     */
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    /**
     * Filters the list of sidebars and their widgets.
     *
     * @since 2.7.0
     *
     * @param array $sidebars_widgets An associative array of sidebars and their widgets.
     */
    return apply_filters('sidebars_widgets', $sidebars_widgets);
}

WordPress Version: 5.4

//
// Internal Functions.
//
/**
 * Retrieve full list of sidebars and their widget instance IDs.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @global array $_wp_sidebars_widgets
 * @global array $sidebars_widgets
 *
 * @param bool $deprecated Not used (argument deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if (true !== $deprecated) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    // If loading from front page, consult $_wp_sidebars_widgets rather than options
    // to see if wp_convert_widget_settings() has made manipulations in memory.
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    /**
     * Filters the list of sidebars and their widgets.
     *
     * @since 2.7.0
     *
     * @param array $sidebars_widgets An associative array of sidebars and their widgets.
     */
    return apply_filters('sidebars_widgets', $sidebars_widgets);
}

WordPress Version: 4.6

//
// Internal Functions
//
/**
 * Retrieve full list of sidebars and their widget instance IDs.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @global array $_wp_sidebars_widgets
 * @global array $sidebars_widgets
 *
 * @param bool $deprecated Not used (argument deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if ($deprecated !== true) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    // If loading from front page, consult $_wp_sidebars_widgets rather than options
    // to see if wp_convert_widget_settings() has made manipulations in memory.
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    /**
     * Filters the list of sidebars and their widgets.
     *
     * @since 2.7.0
     *
     * @param array $sidebars_widgets An associative array of sidebars and their widgets.
     */
    return apply_filters('sidebars_widgets', $sidebars_widgets);
}

WordPress Version: 4.4

//
// Internal Functions
//
/**
 * Retrieve full list of sidebars and their widget instance IDs.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @global array $_wp_sidebars_widgets
 * @global array $sidebars_widgets
 *
 * @param bool $deprecated Not used (argument deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if ($deprecated !== true) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    // If loading from front page, consult $_wp_sidebars_widgets rather than options
    // to see if wp_convert_widget_settings() has made manipulations in memory.
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    /**
     * Filter the list of sidebars and their widgets.
     *
     * @since 2.7.0
     *
     * @param array $sidebars_widgets An associative array of sidebars and their widgets.
     */
    return apply_filters('sidebars_widgets', $sidebars_widgets);
}

WordPress Version: 4.3

/* Internal Functions */
/**
 * Retrieve full list of sidebars and their widget instance IDs.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @global array $_wp_sidebars_widgets
 * @global array $sidebars_widgets
 *
 * @param bool $deprecated Not used (argument deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if ($deprecated !== true) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    // If loading from front page, consult $_wp_sidebars_widgets rather than options
    // to see if wp_convert_widget_settings() has made manipulations in memory.
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    /**
     * Filter the list of sidebars and their widgets.
     *
     * @since 2.7.0
     *
     * @param array $sidebars_widgets An associative array of sidebars and their widgets.
     */
    return apply_filters('sidebars_widgets', $sidebars_widgets);
}

WordPress Version: 4.1

/* Internal Functions */
/**
 * Retrieve full list of sidebars and their widget instance IDs.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @param bool $deprecated Not used (argument deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if ($deprecated !== true) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    // If loading from front page, consult $_wp_sidebars_widgets rather than options
    // to see if wp_convert_widget_settings() has made manipulations in memory.
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    /**
     * Filter the list of sidebars and their widgets.
     *
     * @since 2.7.0
     *
     * @param array $sidebars_widgets An associative array of sidebars and their widgets.
     */
    $sidebars_widgets = apply_filters('sidebars_widgets', $sidebars_widgets);
    return $sidebars_widgets;
}

WordPress Version: 3.9

/* Internal Functions */
/**
 * Retrieve full list of sidebars and their widgets.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @param bool $deprecated Not used (deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if ($deprecated !== true) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    // If loading from front page, consult $_wp_sidebars_widgets rather than options
    // to see if wp_convert_widget_settings() has made manipulations in memory.
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    /**
     * Filter the list of sidebars and their widgets.
     *
     * @since 2.7.0
     *
     * @param array $sidebars_widgets An associative array of sidebars and their widgets.
     */
    $sidebars_widgets = apply_filters('sidebars_widgets', $sidebars_widgets);
    return $sidebars_widgets;
}

WordPress Version: 3.7

/* Internal Functions */
/**
 * Retrieve full list of sidebars and their widgets.
 *
 * Will upgrade sidebar widget list, if needed. Will also save updated list, if
 * needed.
 *
 * @since 2.2.0
 * @access private
 *
 * @param bool $deprecated Not used (deprecated).
 * @return array Upgraded list of widgets to version 3 array format when called from the admin.
 */
function wp_get_sidebars_widgets($deprecated = true)
{
    if ($deprecated !== true) {
        _deprecated_argument(__FUNCTION__, '2.8.1');
    }
    global $_wp_sidebars_widgets, $sidebars_widgets;
    // If loading from front page, consult $_wp_sidebars_widgets rather than options
    // to see if wp_convert_widget_settings() has made manipulations in memory.
    if (!is_admin()) {
        if (empty($_wp_sidebars_widgets)) {
            $_wp_sidebars_widgets = get_option('sidebars_widgets', array());
        }
        $sidebars_widgets = $_wp_sidebars_widgets;
    } else {
        $sidebars_widgets = get_option('sidebars_widgets', array());
    }
    if (is_array($sidebars_widgets) && isset($sidebars_widgets['array_version'])) {
        unset($sidebars_widgets['array_version']);
    }
    $sidebars_widgets = apply_filters('sidebars_widgets', $sidebars_widgets);
    return $sidebars_widgets;
}