update_custom_css_data │ filter-hook │ WP 4.7.0

Filters the css (post_content) and preprocessed (post_content_filtered) args for a custom_css post being updated.

This filter can be used by plugin that offer CSS pre-processors, to store the original pre-processed CSS in post_content_filtered and then store processed CSS in post_content. When used in this way, the post_content_filtered should be supplied as the setting value instead of post_content via a the customize_value_custom_css filter, for example:

add_filter( 'customize_value_custom_css', function( $value, $setting ) {
	$post = wp_get_custom_css_post( $setting->stylesheet );
	if ( $post && ! empty( $post->post_content_filtered ) ) {
		$css = $post->post_content_filtered;
	}
	return $css;
}, 10, 2 );

Usage

add_filter( 'update_custom_css_data', 'wp_kama_update_custom_css_data_filter', 10, 2 );

/**
 * Function for `update_custom_css_data` filter-hook.
 * 
 * @param array $data Custom CSS data.
 * @param array $args The args passed into `wp_update_custom_css_post()` merged with defaults.
 *
 * @return array
 */
function wp_kama_update_custom_css_data_filter( $data, $args ){

	// filter...
	return $data;
}

$data(array)

Custom CSS data.

• css(string)
  CSS stored in post_content.

• preprocessed(string)
  Pre-processed CSS stored in post_content_filtered. Normally empty string.

$args(array)

The args passed into wp_update_custom_css_post() merged with defaults.

• css(string)
  The original CSS passed in to be updated.

• preprocessed(string)
  The original preprocessed CSS passed in to be updated.

• stylesheet(string)
  The stylesheet (theme) being updated.

Changelog

Where the hook is called

$data = apply_filters( 'update_custom_css_data', $data, array_merge( $args, compact( 'css' ) ) );

Where the hook is used in WordPress