Cómo Agregar Descripción al Customizer en WordPress: Guía para Novatos

El Customizer de WordPress es una herramienta poderosa que te permite personalizar tu sitio web en tiempo real. Sin embargo, para los novatos, puede ser un poco confuso entender todas las opciones disponibles. En este tutorial, aprenderemos cómo agregar una descripción a los paneles y secciones del Customizer en WordPress para que puedas comprender mejor cada ajuste y personalizar tu sitio web de manera efectiva.

Este guia supone que sabes programar en PHP para WordPress modificando tus plantillas web o creando plugins. De no ser asi, chequea este articulo sobre como crear paneles y secciones personalizadas en WordPress Customizer.

¿Qué es el Customizer de WordPress?

La API Personalizada (Customizer) es un marco que te permite una vista previa en vivo de cualquier cambio que ejecutes a tu sitio de WordPress. Proporciona una interfaz unificada para que los usuarios personalicen varios aspectos de su tema y su sitio, desde colores y diseños hasta widgets, menús y más. Tanto los temas como los complementos pueden agregar opciones al Personalizador. El WordPress Customizer es la forma canónica de agregar opciones a tu tema.

Paso 1: Accede al Customizer

El Customizer es fácilmente accesible desde tu panel de administración de WordPress. Sigue estos pasos:

  • Inicia sesión en tu panel de administración de WordPress.
  • Una vez dentro, dirígete a «Apariencia» en el menú de la izquierda y selecciona «Personalizar.»
WordPress Customizer apariencia

Cuando hagas clic en «Personalizar,» te llevará al Customizer, donde podrás realizar cambios en tu sitio web en tiempo real.

customizer wordpress

Paso 2: Abre una Sección o Panel

El Customizer está dividido en secciones y paneles, cada uno relacionado con diferentes aspectos de tu sitio web, como el tema, los widgets, los colores, y más. Para comenzar a agregar una descripcion en el customizer de wordpress para personalizar tu sitio web, debes abrir la sección o el panel que deseas modificar. Veamos cómo hacerlo:

  • Una vez en el Customizer, verás una lista de secciones y paneles en el menú de la izquierda. Haz clic en la sección o el panel que desees personalizar.

Por ejemplo, si deseas personalizar la apariencia de tu sitio web, puedes hacer clic en la sección «Identidad del Sitio» o «Colores y Tipografía,» según las opciones disponibles en tu tema.

Paso 3: Modifica tu Tema o Plugin

Para agregar descripciones a los paneles y secciones del Customizer, necesitas realizar algunas modificaciones en el código de tu tema o plugin. Asegúrate de seguir estos pasos con cuidado para garantizar que todo funcione correctamente.

  • Abre tu archivo functions.php, que se encuentra en la carpeta de tu tema activo o en la carpeta de tu plugin personalizado.

Paso 4: Como agregar una Descripción a un panel o seccion.

Ahora que estás en el archivo functions.php, es hora de agregar las descripciones a los paneles y secciones del Customizer utilizando las funciones add_panel o add_section. Veamos cómo hacerlo con ejemplos y códigos.

Ejemplo de Agregar una Descripción a un Panel:

function mi_tema_customizer($wp_customize) {
    // Agrega un panel personalizado
    $wp_customize->add_panel('mi_panel_personalizado', array(
        'title' => __('Panel Personalizado', 'mi-tema'),
        'description' => __('Este es un panel personalizado para configurar la apariencia de tu sitio web.', 'mi-tema'), // Agrega tu descripción aquí
    ));
}
add_action('customize_register', 'mi_tema_customizer');

En el ejemplo anterior, hemos agregado un panel personalizado con el título «Panel Personalizado» y una descripción que explica su propósito.

Ejemplo de Agregar una Descripción a una Sección:

function mi_tema_customizer($wp_customize) {
    // Agrega una sección personalizada
    $wp_customize->add_section('mi_seccion_personalizada', array(
        'title' => __('Sección Personalizada', 'mi-tema'),
        'description' => __('Esta es una sección personalizada para ajustar la apariencia de tu sitio web.', 'mi-tema'), // Agrega tu descripción aquí
    ));
}
add_action('customize_register', 'mi_tema_customizer');

En este ejemplo, hemos agregado una sección personalizada con el título «Sección Personalizada» y una descripción que ayuda a los usuarios a comprender su función.

Paso 5: Guarda los Cambios y Actualiza

Después de agregar las descripciones a los paneles y secciones del Customizer, es importante guardar tus cambios en el archivo functions.php. Luego, regresa al Customizer y actualiza la página para ver las descripciones en acción.

  • Guarda tus cambios en el archivo functions.php.
  • Regresa al Customizer haciendo clic en la pestaña «Personalizar» en la parte superior de tu panel de administración de WordPress.
  • Refresca la página del Customizer para aplicar los cambios.

Paso 6: Visualiza la Descripción

Una vez que hayas actualizado el Customizer, podrás ver las descripciones cuando abras un panel o una sección. Las descripciones aparecerán debajo del título correspondiente y ayudarán a los usuarios a comprender mejor las opciones de personalización disponibles.