WP Customizer API - Controles por defecto del personalizador de wordpress

por | wordpress | 0 Comentarios

El customizador de wordpress es un api de wordpress que nos permite la modificación de los temas por parte del usuario.

Cuando creamos temas para WP podemos añadir nuestros propios ajustes para el tema con la WP customizer API , aunque el core de wordpress ya trae unas por defecto y es posible que las queramos modificar ya sea eliminando alguna que no se ajuste a nuestro tema o simplemente ajustar algún valor como su prioridad, el titulo del control o la descripción.

Para tratarlas primero debemos saber cuales son , estas son las secciones y las propiedades que se incluyen en ellas:

  1. Título del sitio y descripcion ( 'title_tagline'),20
      1. 'blogname'
      2. 'blogdescription'
    1. 'display_header_text'
  2. Colores ( 'colors'),40
    1. 'header_textcolor'
    2. 'background_color'
  3. Header Image ( 'header_image'),60
    1. 'header_image'
    2. 'header_image_data'
  4. Imagen de fondo ( 'background_image'),80
    1. 'background_image_thumb'
    2. 'background_repeat'
    3. 'background_position_x'
    4. 'background_attachment'
  5. Navegación ( 'nav'),100
    1. "nav_menu_locations[{$location}]"

Estas son las que vienen por defecto dentro de cada sección con el numero de prioridad al final.

Una imagen de las secciones:

y un ejemplo de las propiedades dentro de Título del sitio y descripción ( 'title_tagline'):

Como se puede observar se compone de los ajustes:

  1. 'blogname'
  2. 'blogdescription'
  3. 'display_header_text'

 

Para hacer cambios,  la api nos ofrece funcionalidad que podemos utilizar cambiando el valor de sus propiedades ya sea de un ajuste ,un control  o un panel, por ejemplo si queremos cambiar el ‘label’ de ‘blogname’ control  utilizaremos get_setting para acceder al ajuste y cambiamos su valor:

$wp_customize->get_control( 'blogname' )->label = 'Este es el titulo del blog';

Este seria el resultado.

Podemos eliminar paneles , secciones o propiedades:

$wp_customize->remove_panel( 'my_panel_id' ); 
$wp_customize->remove_section( 'title_tagline' ); 
$wp_customize->remove_control( 'blogname' );

 

o podemos cambiar el orden en que se listan , tanto propiedades como secciones o paneles accediendo a la propiedad ‘priority’ ;

$wp_customize->get_panel( 'my_panel_id' )->priority = 100; 
$wp_customize->get_section( 'title_tagline' )->priority = 40; 
$wp_customize->get_control( 'blogname' )->priority = 30;

 

sabiendo esto y consultado la documentación de la API nos podemos reorganizar el personalizador para nuestro tema de la manera que queramos.

Si tienes algo que añadir sobre el tema deja un comentario , un saludo.