mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-26 23:59:40 +02:00
Renames the parameter to match the parent's method signature. Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match. Adds `@since` to clearly specify why the change happened. Reassigns the generic parameter to the original parameter. Why? Restoring the original name keeps the context intact within the method and makes the code more readable. An inline comment explains why this reassignment is made Follow-up to [37476], [38829], [41376]. Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion. See #51553. Built from https://develop.svn.wordpress.org/trunk@51785 git-svn-id: http://core.svn.wordpress.org/trunk@51392 1a063a9b-81f0-0310-95a4-ce76da25c4cd
213 lines
5.2 KiB
PHP
213 lines
5.2 KiB
PHP
<?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;
|
|
}
|
|
}
|