REDROOM

Navigation

Breadcrumbs

/ / home / certprox / www / wpinst / wordpress / wp-includes / customize

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 5.16 KB

/home/certprox/www/wpinst/wordpress/wp-includes/customize/class-wp-customize-custom-css-setting.php

Text Base64

<?php
/**
 * Customize API: WP_Customize_Custom_CSS_Setting class
 *
 * This handles validation, sanitization and saving of the value.
 *
 * @package WordPress
 * @subpackage Customize
 * @since 4.7.0
 */

/**
 * Custom Setting to handle WP Custom CSS.
 *
 * @since 4.7.0
 *
 * @see WP_Customize_Setting
 */
final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {

/**
	 * The setting type.
	 *
	 * @since 4.7.0
	 * @var string
	 */
	public $type = 'custom_css';

/**
	 * Setting Transport
	 *
	 * @since 4.7.0
	 * @var string
	 */
	public $transport = 'postMessage';

/**
	 * Capability required to edit this setting.
	 *
	 * @since 4.7.0
	 * @var string
	 */
	public $capability = 'edit_css';

/**
	 * Stylesheet
	 *
	 * @since 4.7.0
	 * @var string
	 */
	public $stylesheet = '';

/**
	 * WP_Customize_Custom_CSS_Setting constructor.
	 *
	 * @since 4.7.0
	 *
	 * @throws Exception If the setting ID does not match the pattern `custom_css[$stylesheet]`.
	 *
	 * @param WP_Customize_Manager $manager Customizer bootstrap instance.
	 * @param string               $id      A specific ID of the setting.
	 *                                      Can be a theme mod or option name.
	 * @param array                $args    Setting arguments.
	 */
	public function __construct( $manager, $id, $args = array() ) {
		parent::__construct( $manager, $id, $args );
		if ( 'custom_css' !== $this->id_data['base'] ) {
			throw new Exception( 'Expected custom_css id_base.' );
		}
		if ( 1 !== count( $this->id_data['keys'] ) || empty( $this->id_data['keys'][0] ) ) {
			throw new Exception( 'Expected single stylesheet key.' );
		}
		$this->stylesheet = $this->id_data['keys'][0];
	}

/**
	 * Add filter to preview post value.
	 *
	 * @since 4.7.9
	 *
	 * @return bool False when preview short-circuits due no change needing to be previewed.
	 */
	public function preview() {
		if ( $this->is_previewed ) {
			return false;
		}
		$this->is_previewed = true;
		add_filter( 'wp_get_custom_css', array( $this, 'filter_previewed_wp_get_custom_css' ), 9, 2 );
		return true;
	}

/**
	 * Filters `wp_get_custom_css` for applying the customized value.
	 *
	 * This is used in the preview when `wp_get_custom_css()` is called for rendering the styles.
	 *
	 * @since 4.7.0
	 *
	 * @see wp_get_custom_css()
	 *
	 * @param string $css        Original CSS.
	 * @param string $stylesheet Current stylesheet.
	 * @return string CSS.
	 */
	public function filter_previewed_wp_get_custom_css( $css, $stylesheet ) {
		if ( $stylesheet === $this->stylesheet ) {
			$customized_value = $this->post_value( null );
			if ( ! is_null( $customized_value ) ) {
				$css = $customized_value;
			}
		}
		return $css;
	}

/**
	 * Fetch the value of the setting. Will return the previewed value when `preview()` is called.
	 *
	 * @since 4.7.0
	 *
	 * @see WP_Customize_Setting::value()
	 *
	 * @return string
	 */
	public function value() {
		if ( $this->is_previewed ) {
			$post_value = $this->post_value( null );
			if ( null !== $post_value ) {
				return $post_value;
			}
		}
		$id_base = $this->id_data['base'];
		$value   = '';
		$post    = wp_get_custom_css_post( $this->stylesheet );
		if ( $post ) {
			$value = $post->post_content;
		}
		if ( empty( $value ) ) {
			$value = $this->default;
		}

/** This filter is documented in wp-includes/class-wp-customize-setting.php */
		$value = apply_filters( "customize_value_{$id_base}", $value, $this );

return $value;
	}

/**
	 * Validate a received value for being valid CSS.
	 *
	 * Checks for imbalanced braces, brackets, and comments.
	 * Notifications are rendered when the customizer state is saved.
	 *
	 * @since 4.7.0
	 * @since 4.9.0 Checking for balanced characters has been moved client-side via linting in code editor.
	 * @since 5.9.0 Renamed `$css` to `$value` for PHP 8 named parameter support.
	 *
	 * @param string $value CSS to validate.
	 * @return true|WP_Error True if the input was validated, otherwise WP_Error.
	 */
	public function validate( $value ) {
		// Restores the more descriptive, specific name for use within this method.
		$css = $value;

$validity = new WP_Error();

if ( preg_match( '#</?\w+#', $css ) ) {
			$validity->add( 'illegal_markup', __( 'Markup is not allowed in CSS.' ) );
		}

if ( ! $validity->has_errors() ) {
			$validity = parent::validate( $css );
		}
		return $validity;
	}

/**
	 * Store the CSS setting value in the custom_css custom post type for the stylesheet.
	 *
	 * @since 4.7.0
	 * @since 5.9.0 Renamed `$css` to `$value` for PHP 8 named parameter support.
	 *
	 * @param string $value CSS to update.
	 * @return int|false The post ID or false if the value could not be saved.
	 */
	public function update( $value ) {
		// Restores the more descriptive, specific name for use within this method.
		$css = $value;

if ( empty( $css ) ) {
			$css = '';
		}

$r = wp_update_custom_css_post(
			$css,
			array(
				'stylesheet' => $this->stylesheet,
			)
		);

if ( $r instanceof WP_Error ) {
			return false;
		}
		$post_id = $r->ID;

// Cache post ID in theme mod for performance to avoid additional DB query.
		if ( $this->manager->get_stylesheet() === $this->stylesheet ) {
			set_theme_mod( 'custom_css_post_id', $post_id );
		}

return $post_id;
	}
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 0 × Files: 36

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
class-wp-customize-background-image-control.php	1.25 KB	lrw-r--r--	2022-05-18 15:24:14	Edit Download recursive recursive
class-wp-customize-background-image-setting.php	639 B	lrw-r--r--	2022-05-18 15:24:14	Edit Download recursive recursive
class-wp-customize-background-position-control.php	2.89 KB	lrw-r--r--	2021-08-19 02:07:56	Edit Download recursive recursive
class-wp-customize-code-editor-control.php	2.26 KB	lrw-r--r--	2020-06-16 21:07:14	Edit Download recursive recursive
class-wp-customize-color-control.php	2.99 KB	lrw-r--r--	2020-02-26 13:30:08	Edit Download recursive recursive
class-wp-customize-cropped-image-control.php	1.43 KB	lrw-r--r--	2017-07-27 00:41:44	Edit Download recursive recursive
class-wp-customize-custom-css-setting.php	5.16 KB	lrw-r--r--	2021-09-09 15:18:55	Edit Download recursive recursive
class-wp-customize-date-time-control.php	8.70 KB	lrw-r--r--	2021-12-11 19:50:59	Edit Download recursive recursive
class-wp-customize-filter-setting.php	588 B	lrw-r--r--	2017-07-27 00:41:44	Edit Download recursive recursive
class-wp-customize-header-image-control.php	7.71 KB	lrw-r--r--	2022-10-17 11:26:11	Edit Download recursive recursive
class-wp-customize-header-image-setting.php	1.73 KB	lrw-r--r--	2022-05-18 15:24:14	Edit Download recursive recursive
class-wp-customize-image-control.php	1.18 KB	lrw-r--r--	2020-11-22 15:53:03	Edit Download recursive recursive
class-wp-customize-media-control.php	9.16 KB	lrw-r--r--	2021-05-04 14:44:58	Edit Download recursive recursive
class-wp-customize-nav-menu-auto-add-control.php	1.10 KB	lrw-r--r--	2017-10-05 02:22:49	Edit Download recursive recursive
class-wp-customize-nav-menu-control.php	2.02 KB	lrw-r--r--	2022-03-22 16:25:03	Edit Download recursive recursive
class-wp-customize-nav-menu-item-control.php	6.83 KB	lrw-r--r--	2022-01-15 08:44:03	Edit Download recursive recursive
class-wp-customize-nav-menu-item-setting.php	26.92 KB	lrw-r--r--	2022-06-01 18:14:10	Edit Download recursive recursive
class-wp-customize-nav-menu-location-control.php	2.23 KB	lrw-r--r--	2019-07-02 23:42:58	Edit Download recursive recursive
class-wp-customize-nav-menu-locations-control.php	2.73 KB	lrw-r--r--	2022-03-22 16:25:03	Edit Download recursive recursive
class-wp-customize-nav-menu-name-control.php	1.10 KB	lrw-r--r--	2017-10-05 02:22:49	Edit Download recursive recursive
class-wp-customize-nav-menu-section.php	716 B	lrw-r--r--	2020-10-08 21:15:13	Edit Download recursive recursive
class-wp-customize-nav-menu-setting.php	18.49 KB	lrw-r--r--	2022-01-18 20:29:06	Edit Download recursive recursive
class-wp-customize-nav-menus-panel.php	3.01 KB	lrw-r--r--	2022-10-07 20:48:12	Edit Download recursive recursive
class-wp-customize-new-menu-control.php	1.67 KB	lrw-r--r--	2020-02-26 13:30:08	Edit Download recursive recursive
class-wp-customize-new-menu-section.php	1.65 KB	lrw-r--r--	2020-02-26 15:33:05	Edit Download recursive recursive
class-wp-customize-partial.php	10.32 KB	lrw-r--r--	2022-09-12 15:47:14	Edit Download recursive recursive
class-wp-customize-selective-refresh.php	13.41 KB	lrw-r--r--	2022-09-12 15:47:14	Edit Download recursive recursive
class-wp-customize-sidebar-section.php	1.03 KB	lrw-r--r--	2017-11-30 23:11:00	Edit Download recursive recursive
class-wp-customize-site-icon-control.php	3.21 KB	lrw-r--r--	2022-10-17 11:26:11	Edit Download recursive recursive
class-wp-customize-theme-control.php	11.24 KB	lrw-r--r--	2022-03-22 16:25:03	Edit Download recursive recursive
class-wp-customize-themes-panel.php	3.16 KB	lrw-r--r--	2022-01-20 23:53:05	Edit Download recursive recursive
class-wp-customize-themes-section.php	6.60 KB	lrw-r--r--	2020-11-09 10:53:10	Edit Download recursive recursive
class-wp-customize-upload-control.php	1.17 KB	lrw-r--r--	2020-11-22 15:51:03	Edit Download recursive recursive
class-wp-sidebar-block-editor-control.php	686 B	lrw-r--r--	2021-05-25 08:52:58	Edit Download recursive recursive
class-wp-widget-area-customize-control.php	1.62 KB	lrw-r--r--	2020-11-22 15:12:03	Edit Download recursive recursive
class-wp-widget-form-customize-control.php	2.58 KB	lrw-r--r--	2019-04-13 04:46:52	Edit Download recursive recursive