wp_add_inline_style

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

WordPress Version: 6.2

/**
 * Adds extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet is already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    _wp_scripts_maybe_doing_it_wrong(__FUNCTION__, $handle);
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, sprintf(
            /* translators: 1: <style>, 2: wp_add_inline_style() */
            __('Do not pass %1$s tags to %2$s.'),
            '<code>&lt;style&gt;</code>',
            '<code>wp_add_inline_style()</code>'
        ), '3.7.0');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return wp_styles()->add_inline_style($handle, $data);
}

WordPress Version: 5.5

/**
 * Add extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet is already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    _wp_scripts_maybe_doing_it_wrong(__FUNCTION__, $handle);
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, sprintf(
            /* translators: 1: <style>, 2: wp_add_inline_style() */
            __('Do not pass %1$s tags to %2$s.'),
            '<code>&lt;style&gt;</code>',
            '<code>wp_add_inline_style()</code>'
        ), '3.7.0');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return wp_styles()->add_inline_style($handle, $data);
}

WordPress Version: 5.1

/**
 * Add extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet is already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    _wp_scripts_maybe_doing_it_wrong(__FUNCTION__);
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, sprintf(
            /* translators: 1: <style>, 2: wp_add_inline_style() */
            __('Do not pass %1$s tags to %2$s.'),
            '<code>&lt;style&gt;</code>',
            '<code>wp_add_inline_style()</code>'
        ), '3.7.0');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return wp_styles()->add_inline_style($handle, $data);
}

WordPress Version: 4.6

/**
 * Add extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet in already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    _wp_scripts_maybe_doing_it_wrong(__FUNCTION__);
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, sprintf(
            /* translators: 1: <style>, 2: wp_add_inline_style() */
            __('Do not pass %1$s tags to %2$s.'),
            '<code>&lt;style&gt;</code>',
            '<code>wp_add_inline_style()</code>'
        ), '3.7.0');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return wp_styles()->add_inline_style($handle, $data);
}

WordPress Version: 4.5

/**
 * Add extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet in already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    _wp_scripts_maybe_doing_it_wrong(__FUNCTION__);
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, __('Do not pass style tags to wp_add_inline_style().'), '3.7');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return wp_styles()->add_inline_style($handle, $data);
}

WordPress Version: 4.2

/**
 * Add extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet in already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to. Must be lowercase.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    _wp_scripts_maybe_doing_it_wrong(__FUNCTION__);
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, __('Do not pass style tags to wp_add_inline_style().'), '3.7');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return wp_styles()->add_inline_style($handle, $data);
}

WordPress Version: 4.1

/**
 * Add extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet in already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 * @global WP_Styles $wp_styles The WP_Styles object for printing styles.
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to. Must be lowercase.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    global $wp_styles;
    if (!is_a($wp_styles, 'WP_Styles')) {
        if (!did_action('init')) {
            _doing_it_wrong(__FUNCTION__, sprintf(__('Scripts and styles should not be registered or enqueued until the %1$s, %2$s, or %3$s hooks.'), '<code>wp_enqueue_scripts</code>', '<code>admin_enqueue_scripts</code>', '<code>login_enqueue_scripts</code>'), '3.3');
        }
        $wp_styles = new WP_Styles();
    }
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, __('Do not pass style tags to wp_add_inline_style().'), '3.7');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return $wp_styles->add_inline_style($handle, $data);
}

WordPress Version: 3.7

/**
 * Add extra CSS styles to a registered stylesheet.
 *
 * Styles will only be added if the stylesheet in already in the queue.
 * Accepts a string $data containing the CSS. If two or more CSS code blocks
 * are added to the same stylesheet $handle, they will be printed in the order
 * they were added, i.e. the latter added styles can redeclare the previous.
 *
 * @see WP_Styles::add_inline_style()
 * @global WP_Styles $wp_styles The WP_Styles object for printing styles.
 *
 * @since 3.3.0
 *
 * @param string $handle Name of the stylesheet to add the extra styles to. Must be lowercase.
 * @param string $data   String containing the CSS styles to be added.
 * @return bool True on success, false on failure.
 */
function wp_add_inline_style($handle, $data)
{
    global $wp_styles;
    if (!is_a($wp_styles, 'WP_Styles')) {
        if (!did_action('init')) {
            _doing_it_wrong(__FUNCTION__, sprintf(__('Scripts and styles should not be registered or enqueued until the %1$s, %2$s, or %3$s hooks.'), '<code>wp_enqueue_scripts</code>', '<code>admin_enqueue_scripts</code>', '<code>login_enqueue_scripts</code>'), '3.3');
        }
        $wp_styles = new WP_Styles();
    }
    if (false !== stripos($data, '</style>')) {
        _doing_it_wrong(__FUNCTION__, 'Do not pass style tags to wp_add_inline_style().', '3.7');
        $data = trim(preg_replace('#<style[^>]*>(.*)</style>#is', '$1', $data));
    }
    return $wp_styles->add_inline_style($handle, $data);
}