add_allowed_options

WordPress Version: 5.6

/**
 * Adds an array of options to the list of allowed options.
 *
 * @since 5.5.0
 *
 * @global array $allowed_options
 *
 * @param array        $new_options
 * @param string|array $options
 * @return array
 */
function add_allowed_options($new_options, $options = '')
{
    if ('' === $options) {
        global $allowed_options;
    } else {
        $allowed_options = $options;
    }
    foreach ($new_options as $page => $keys) {
        foreach ($keys as $key) {
            if (!isset($allowed_options[$page]) || !is_array($allowed_options[$page])) {
                $allowed_options[$page] = array();
                $allowed_options[$page][] = $key;
            } else {
                $pos = array_search($key, $allowed_options[$page], true);
                if (false === $pos) {
                    $allowed_options[$page][] = $key;
                }
            }
        }
    }
    return $allowed_options;
}