Cómo utilizar la API de selección de color de WordPress
Para agregar un selector de color, necesitamos hacer referencia a sus archivos de estilo jQuery y CSS. El siguiente código le indicará cómo citar:
add_action( 'admin_enqueue_scripts', 'wptuts_add_color_picker' );
función wptuts_add_color_picker( $hook ) {
if( is_admin() ){
//Agregar archivo CSS para el selector de color
wp_enqueue_style( 'wp-color-picker' );
// Haga referencia a nuestro archivo jQuery personalizado y agregue soporte para el selector de color
wp_ enqueue_script( 'custom-script-handle', plugins_url( 'custom-script.js', __FILE__ ), array( 'wp- selector de color' ), falso, verdadero );
}
}
add_action( 'admin_enqueue_scripts', 'wptuts_add_color_picker' );
p >función wptuts_add_color_picker( $hook ) {
if( is_ admin() ){
//Agregar archivo CSS para el selector de color
wp_enqueue_style( 'wp-color-picker' );
// Haga referencia a nuestro archivo jQuery personalizado y agregue soporte para el selector de color
wp_enqueue_ script( 'custom-script-handle ', plugins_url( 'custom-script.js', __FILE__), matriz ('wp-color-picker'), falso, verdadero);
}
}
}
}
Tenga en cuenta que una vez que hayamos hecho referencia al archivo jQuery personalizado y hayamos agregado soporte para el selector de color, podemos aplicar el selector de color al campo de texto jQuery en el archivo.
(function( $ ) {
// Agregar selector de color a todas las entradas que contengan la clase "campo de color"
$(function() {
$('.color-field').wpColorPicker();
});
})( jQuery );
Crear un complemento que utiliza el selector de color
A continuación mostraremos cómo integrar el selector de color en un complemento real.
Esto es lo que cubriremos:
Cómo agregar una página de opciones del panel para simular la página de configuración del tema.
Cómo agregar un campo de configuración listo para usar un selector de color.
Cómo validar y guardar entradas.
Paso 1
Una vez que haya configurado su complemento en la carpeta wp-content/plugins de WordPress, estamos listos para comenzar. La siguiente imagen muestra la estructura del complemento que creé para este tutorial.
Paso 2
En el archivo color-picker-plugin.php, completamos la información básica del complemento y luego creamos una clase PHP llamada CPA_Theme_Options, la siguiente code Muestra todos los métodos de clase que implementaremos paso a paso.
/*
Nombre del complemento: API del selector de color
URI del complemento:
Descripción: Demostración sobre la nueva API del selector de color
/*
p>
Versión: 1.0
Autor: code.tutsplus.com
URI del autor:
*/
/ * *
* Clase principal: CPA significa API de selector de color
*/
clase CPA_ Theme_Options {
/*--- -------------------------------*
* Atributos
*------------------------------------ ----- - --*/
/** Se refiere a una única instancia de esta clase.*/
private static $instance = null;
/* Opciones de guardado */
opciones $ públicas;
/*-------------------------- -- -*
* Constructor
*------------- --- ------------------------- ---*/
/**
* Crear o devolver una instancia de esta clase.
*
* @return ?CPA_Theme_Options Una instancia de esta clase.
*/
función estática pública get_instance() {
if ( null == self::$instancia ) {
self ::$instancia = new self;
}
return self::$instancia;
}// end get_instance;
/**
*Inicialice el complemento configurando localización, filtros y funciones de administración.
*/
función privada __construct() { }
/*------------------ -----------------*
* Función
*------ -----------------------------------------*/
/**
*Agregue una función a la página de opciones en el menú de configuración.
*/
función pública add_page() { }
/**
* Función utilizada para mostrar la página de opciones.
*/
función pública display_page() { }
/**
* Función utilizada para registrar las opciones de la página de administración.
*/
función pública Register_page_ options() { }
/**
* Función para agregar archivos javascript para Color Piker .
*/
función pública enqueue_admin_js() { }
/**
* Función para verificar todos los campos.
*/
función pública validar_opciones( $fields ) { }
/**
* La función comprobará si el valor es un color HEX válido.
*/
función pública check_color( $value ) { }
/**
* Establecer la función de devolución de llamada
p>
*/
función pública display_section() { /* Dejar en blanco*/ }
/**
* Función para mostrar campos.
*/
función pública title_settings_field() { }
función pública bg_settings_field() { }
}// clase final
CPA_Theme_ Options::get_instance();
Paso 3
Primero, implementemos el constructor de la clase. El siguiente código muestra que cuando el complemento esté en línea, se creará una nueva instancia.
Esto:
Agregará una nueva página de opciones en la sección Configuración del menú de administración de WordPress
Registrará los campos de configuración en la página Opciones de registro
Agregue una hoja de estilo CSS para el selector de color de WordPress
Agregue un archivo JavaScript personalizado que llame al selector de color
Establezca las propiedades de la opción y guarde la configuración.
función privada __construct() {
//Agregar la página al menú de administración
add_action( 'admin_menu', array( &$this, 'add_page ' ) );
//Opciones de página de registro
add_action ('admin_init', array( &$this, 'register_page_options')
// Reglas CSS de color para selectores
wp_enqueue_style( 'wp-color-picker' );
//Registrar javascript
add_action('admin_enqueue_scripts', array( $ esto, 'admin_enqueue_scripts');