d254551dd7
wp.Uploader is a wrapper that provides a simple way to upload an attachment (using the wp_ajax_upload_attachment handler). It is intentionally decoupled from the UI. When an upload succeeds, it will receive the attachment information (id, url, meta, etc) as a JSON response. If the upload fails, the wrapper handles both WordPress and plupload errors through a single handler. As todos, we should add drag classes for the uploader dropzone and account for the rough 100mb filesize limit in most browsers. The UI for the customizer upload controls could be improved as well. git-svn-id: https://develop.svn.wordpress.org/trunk@20179 602fd350-edb4-49c9-b593-d223f7449a82
514 lines
13 KiB
PHP
514 lines
13 KiB
PHP
<?php
|
|
/**
|
|
* Customize Setting Class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Customize
|
|
* @since 3.4.0
|
|
*/
|
|
|
|
class WP_Customize_Setting {
|
|
public $id;
|
|
public $priority = 10;
|
|
public $section = '';
|
|
public $label = '';
|
|
public $control = 'text';
|
|
public $type = 'theme_mod';
|
|
public $choices = array();
|
|
public $capability = 'edit_theme_options';
|
|
public $theme_supports = '';
|
|
public $default = '';
|
|
public $sanitize_callback = '';
|
|
|
|
protected $id_data = array();
|
|
private $_post_value; // Cached, sanitized $_POST value.
|
|
|
|
// Prefix for $_POST values to prevent naming conflicts.
|
|
const name_prefix = 'customize_';
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param string $id An specific ID of the setting. Can be a
|
|
* theme mod or option name.
|
|
* @param array $args Setting arguments.
|
|
*/
|
|
function __construct( $id, $args = array() ) {
|
|
$keys = array_keys( get_class_vars( __CLASS__ ) );
|
|
foreach ( $keys as $key ) {
|
|
if ( isset( $args[ $key ] ) )
|
|
$this->$key = $args[ $key ];
|
|
}
|
|
|
|
$this->id = $id;
|
|
|
|
// Parse the ID for array keys.
|
|
$this->id_data[ 'keys' ] = preg_split( '/\[/', str_replace( ']', '', $this->id ) );
|
|
$this->id_data[ 'base' ] = array_shift( $this->id_data[ 'keys' ] );
|
|
|
|
// Rebuild the ID.
|
|
$this->id = $this->id_data[ 'base' ];
|
|
if ( ! empty( $this->id_data[ 'keys' ] ) )
|
|
$this->id .= '[' . implode( '][', $this->id_data[ 'keys' ] ) . ']';
|
|
|
|
if ( $this->sanitize_callback != '' )
|
|
add_filter( "customize_sanitize_{$this->id}", $this->sanitize_callback );
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Enqueue setting related scripts/styles.
|
|
*
|
|
* @since 3.4.0
|
|
*/
|
|
public function enqueue() {
|
|
switch( $this->control ) {
|
|
case 'color':
|
|
wp_enqueue_script( 'farbtastic' );
|
|
wp_enqueue_style( 'farbtastic' );
|
|
break;
|
|
case 'upload':
|
|
wp_enqueue_script( 'wp-plupload' );
|
|
break;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handle previewing the setting.
|
|
*
|
|
* @since 3.4.0
|
|
*/
|
|
public function preview() {
|
|
switch( $this->type ) {
|
|
case 'theme_mod' :
|
|
add_filter( 'theme_mod_' . $this->id_data[ 'base' ], array( $this, '_preview_filter' ) );
|
|
break;
|
|
case 'option' :
|
|
if ( empty( $this->id_data[ 'keys' ] ) )
|
|
add_filter( 'pre_option_' . $this->id_data[ 'base' ], array( $this, '_preview_filter' ) );
|
|
else
|
|
add_filter( 'option_' . $this->id_data[ 'base' ], array( $this, '_preview_filter' ) );
|
|
break;
|
|
default :
|
|
do_action( 'customize_preview_' . $this->id );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Callback function to filter the theme mods and options.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param mixed Old value.
|
|
* @return mixed New or old value.
|
|
*/
|
|
public function _preview_filter( $original ) {
|
|
return $this->multidimensional_replace( $original, $this->id_data[ 'keys' ], $this->post_value() );
|
|
}
|
|
|
|
/**
|
|
* Set the value of the parameter for a specific theme.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @return bool False if cap check fails or value isn't set.
|
|
*/
|
|
public final function save() {
|
|
$value = $this->post_value();
|
|
|
|
if ( ! $this->check_capabilities() || ! isset( $value ) )
|
|
return false;
|
|
|
|
do_action( 'customize_save_' . $this->id_data[ 'base' ] );
|
|
|
|
$this->update( $value );
|
|
}
|
|
|
|
/**
|
|
* Fetches, validates, and sanitizes the $_POST value.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $default mixed A default value which is used as a fallback. Default is null.
|
|
* @return mixed Either the default value on failure or sanitized value.
|
|
*/
|
|
public final function post_value( $default = null ) {
|
|
if ( isset( $this->_post_value ) )
|
|
return $this->_post_value;
|
|
|
|
$base = self::name_prefix . $this->id_data[ 'base' ];
|
|
|
|
if ( ! isset( $_POST[ $base ] ) )
|
|
return $default;
|
|
|
|
$result = $this->multidimensional_get( $_POST[ $base ], $this->id_data[ 'keys' ] );
|
|
if ( ! isset( $result ) )
|
|
return $default;
|
|
|
|
$result = $this->sanitize( $result );
|
|
if ( isset( $result ) )
|
|
return $this->_post_value = $result;
|
|
else
|
|
return $default;
|
|
}
|
|
|
|
/**
|
|
* Sanitize an input.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $value mixed The value to sanitize.
|
|
* @return mixed Null if an input isn't valid, otherwise the sanitized value.
|
|
*/
|
|
public function sanitize( $value ) {
|
|
$value = stripslashes_deep( $value );
|
|
return apply_filters( "customize_sanitize_{$this->id}", $value );
|
|
}
|
|
|
|
/**
|
|
* Set the value of the parameter for a specific theme.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $value mixed The value to update.
|
|
* @return mixed The result of saving the value.
|
|
*/
|
|
protected function update( $value ) {
|
|
switch( $this->type ) {
|
|
case 'theme_mod' :
|
|
return $this->_update_theme_mod( $value );
|
|
break;
|
|
case 'option' :
|
|
return $this->_update_option( $value );
|
|
break;
|
|
default :
|
|
return do_action( 'customize_update_' . $this->type, $value );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Update the theme mod from the value of the parameter.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $value mixed The value to update.
|
|
* @return mixed The result of saving the value.
|
|
*/
|
|
protected function _update_theme_mod( $value ) {
|
|
// Handle non-array theme mod.
|
|
if ( empty( $this->id_data[ 'keys' ] ) )
|
|
return set_theme_mod( $this->id_data[ 'base' ], $value );
|
|
|
|
// Handle array-based theme mod.
|
|
$mods = get_theme_mod( $this->id_data[ 'base' ] );
|
|
$mods = $this->multidimensional_replace( $mods, $this->id_data[ 'keys' ], $value );
|
|
if ( isset( $mods ) )
|
|
return set_theme_mod( $this->id_data[ 'base' ], $mods );
|
|
}
|
|
|
|
/**
|
|
* Update the theme mod from the value of the parameter.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $value mixed The value to update.
|
|
* @return mixed The result of saving the value.
|
|
*/
|
|
protected function _update_option( $value ) {
|
|
// Handle non-array option.
|
|
if ( empty( $this->id_data[ 'keys' ] ) )
|
|
return update_option( $this->id_data[ 'base' ], $value );
|
|
|
|
// Handle array-based options.
|
|
$options = get_option( $this->id_data[ 'base' ] );
|
|
$options = $this->multidimensional_replace( $options, $this->id_data[ 'keys' ], $value );
|
|
if ( isset( $options ) )
|
|
return update_option( $this->id_data[ 'base' ], $options );
|
|
}
|
|
|
|
/**
|
|
* Fetch the value of the parameter for a specific theme.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @return mixed The requested value.
|
|
*/
|
|
public function value() {
|
|
switch( $this->type ) {
|
|
case 'theme_mod' :
|
|
$function = 'get_theme_mod';
|
|
break;
|
|
case 'option' :
|
|
$function = 'get_option';
|
|
break;
|
|
default :
|
|
return apply_filters( 'customize_value_' . $this->id_data[ 'base' ], $this->default );
|
|
}
|
|
|
|
// Handle non-array value
|
|
if ( empty( $this->id_data[ 'keys' ] ) )
|
|
return $function( $this->id_data[ 'base' ], $this->default );
|
|
|
|
// Handle array-based value
|
|
$values = $function( $this->id_data[ 'base' ] );
|
|
return $this->multidimensional_get( $values, $this->id_data[ 'keys' ], $this->default );
|
|
}
|
|
|
|
/**
|
|
* Check if the theme supports the setting and check user capabilities.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @return bool False if theme doesn't support the setting or user can't change setting, otherwise true.
|
|
*/
|
|
public final function check_capabilities() {
|
|
global $customize;
|
|
|
|
if ( ! $this->capability || ! current_user_can( $this->capability ) )
|
|
return false;
|
|
|
|
if ( $this->theme_supports && ! current_theme_supports( $this->theme_supports ) )
|
|
return false;
|
|
|
|
$section = $customize->get_section( $this->section );
|
|
if ( isset( $section ) && ! $section->check_capabilities() )
|
|
return false;
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Render the control.
|
|
*
|
|
* @since 3.4.0
|
|
*/
|
|
public final function _render() {
|
|
if ( ! $this->check_capabilities() )
|
|
return;
|
|
|
|
do_action( 'customize_render_' . $this->id );
|
|
|
|
$this->render();
|
|
}
|
|
|
|
/**
|
|
* Render the control.
|
|
*
|
|
* @since 3.4.0
|
|
*/
|
|
protected function render() {
|
|
$this->_render_type();
|
|
}
|
|
|
|
/**
|
|
* Retrieve the name attribute for an input.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @return string The name.
|
|
*/
|
|
public final function get_name() {
|
|
return self::name_prefix . esc_attr( $this->id );
|
|
}
|
|
|
|
/**
|
|
* Echo the HTML name attribute for an input.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @return string The HTML name attribute.
|
|
*/
|
|
public final function name() {
|
|
echo 'name="' . $this->get_name() . '"';
|
|
}
|
|
|
|
/**
|
|
* Render the control type.
|
|
*
|
|
* @todo Improve value and checked attributes.
|
|
*
|
|
* @since 3.4.0
|
|
*/
|
|
public final function _render_type() {
|
|
switch( $this->control ) {
|
|
case 'text':
|
|
?>
|
|
<label><?php echo esc_html( $this->label ); ?><br/>
|
|
<input type="text" value="<?php echo esc_attr( $this->value() ); ?>" <?php $this->name(); ?> />
|
|
</label>
|
|
<?php
|
|
break;
|
|
case 'color':
|
|
?>
|
|
<label>
|
|
<span><?php echo esc_html( $this->label ); ?></span>
|
|
<div class="color-picker">
|
|
<input type="hidden" value="<?php echo esc_attr( $this->value() ); ?>" <?php $this->name(); ?> />
|
|
<a href="#"></a>
|
|
<div class="color-picker-controls">
|
|
<div class="farbtastic-placeholder"></div>
|
|
<div class="color-picker-details">
|
|
<div class="color-picker-hex">
|
|
<span>#</span>
|
|
<input type="text" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</label>
|
|
<?php
|
|
break;
|
|
case 'checkbox':
|
|
?>
|
|
<label>
|
|
<input type="checkbox" value="<?php echo esc_attr( $this->value() ); ?>" <?php $this->name(); checked( $this->value() ); ?> />
|
|
<?php echo esc_html( $this->label ); ?>
|
|
</label>
|
|
<?php
|
|
break;
|
|
case 'radio':
|
|
if ( empty( $this->choices ) )
|
|
return;
|
|
|
|
echo esc_html( $this->label ) . '<br/>';
|
|
foreach ( $this->choices as $value => $label ) :
|
|
?>
|
|
<label>
|
|
<input type="radio" value="<?php echo esc_attr( $value ); ?>" <?php $this->name(); checked( $this->value(), $value ); ?> />
|
|
<?php echo esc_html( $label ); ?><br/>
|
|
</label>
|
|
<?php
|
|
endforeach;
|
|
break;
|
|
case 'select':
|
|
if ( empty( $this->choices ) )
|
|
return;
|
|
|
|
?>
|
|
<label><?php echo esc_html( $this->label ); ?><br/>
|
|
<select <?php $this->name(); ?>>
|
|
<?php
|
|
foreach ( $this->choices as $value => $label )
|
|
echo '<option value="' . esc_attr( $value ) . '"' . selected( $this->value(), $value, false ) . '>' . $label . '</option>';
|
|
?>
|
|
</select>
|
|
<?php
|
|
break;
|
|
case 'upload':
|
|
?>
|
|
<label><?php echo esc_html( $this->label ); ?><br/>
|
|
<input type="hidden" value="<?php echo esc_attr( $this->value() ); ?>" <?php $this->name(); ?> />
|
|
<a href="#" class="button-secondary upload"><?php _e( 'Upload' ); ?></a>
|
|
<a href="#" class="remove"><?php _e( 'Remove' ); ?></a>
|
|
</label>
|
|
<?php
|
|
break;
|
|
default:
|
|
do_action( 'customize_render_control-' . $this->control, $this );
|
|
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Multidimensional helper function.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $root
|
|
* @param $keys
|
|
* @param bool $create Default is false.
|
|
* @return null|array
|
|
*/
|
|
final protected function multidimensional( $root, $keys, $create = false ) {
|
|
if ( $create && empty( $root ) )
|
|
$root = array();
|
|
|
|
if ( ! isset( $root ) || empty( $keys ) )
|
|
return;
|
|
|
|
$last = array_pop( $keys );
|
|
$node = &$root;
|
|
|
|
foreach ( $keys as $key ) {
|
|
if ( $create && ! isset( $node[ $key ] ) )
|
|
$node[ $key ] = array();
|
|
|
|
if ( ! is_array( $node ) || ! isset( $node[ $key ] ) )
|
|
return;
|
|
|
|
$node = &$node[ $key ];
|
|
}
|
|
|
|
if ( $create && ! isset( $node[ $last ] ) )
|
|
$node[ $last ] = array();
|
|
|
|
if ( ! isset( $node[ $last ] ) )
|
|
return;
|
|
|
|
return array(
|
|
'root' => &$root,
|
|
'node' => &$node,
|
|
'key' => $last,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Will attempt to replace a specific value in a multidimensional array.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $root
|
|
* @param $keys
|
|
* @param mixed $value The value to update.
|
|
* @return
|
|
*/
|
|
final protected function multidimensional_replace( $root, $keys, $value ) {
|
|
if ( ! isset( $value ) )
|
|
return $root;
|
|
elseif ( empty( $keys ) ) // If there are no keys, we're replacing the root.
|
|
return $value;
|
|
|
|
$result = $this->multidimensional( $root, $keys, true );
|
|
|
|
if ( isset( $result ) )
|
|
$result['node'][ $result['key'] ] = $value;
|
|
|
|
return $root;
|
|
}
|
|
|
|
/**
|
|
* Will attempt to fetch a specific value from a multidimensional array.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $root
|
|
* @param $keys
|
|
* @param $default A default value which is used as a fallback. Default is null.
|
|
* @return mixed The requested value or the default value.
|
|
*/
|
|
final protected function multidimensional_get( $root, $keys, $default = null ) {
|
|
if ( empty( $keys ) ) // If there are no keys, test the root.
|
|
return isset( $root ) ? $root : $default;
|
|
|
|
$result = $this->multidimensional( $root, $keys );
|
|
return isset( $result ) ? $result['node'][ $result['key'] ] : $default;
|
|
}
|
|
|
|
/**
|
|
* Will attempt to check if a specific value in a multidimensional array is set.
|
|
*
|
|
* @since 3.4.0
|
|
*
|
|
* @param $root
|
|
* @param $keys
|
|
* @return bool True if value is set, false if not.
|
|
*/
|
|
final protected function multidimensional_isset( $root, $keys ) {
|
|
$result = $this->multidimensional_get( $root, $keys );
|
|
return isset( $result );
|
|
}
|
|
}
|