Roman Fink

Cómo añadir un enlace al Personalizador en un tema de bloques de WordPress

WordPress oculta el enlace Personalizar cuando hay un tema de bloques activo. En Apariencia ves Temas y Editor, y nada más. El Personalizador sigue funcionando: abre /wp-admin/customize.php y se carga. Una función en functions.php devuelve el enlace al menú. Lo he comprobado en WordPress 7.1.4.

Por qué falta el enlace

WordPress añade Apariencia → Personalizar en dos casos: el tema activo es un tema clásico, o el tema o algún plugin registra sus propios ajustes del Personalizador con el hook customize_register. Un tema de bloques sin un plugin así se queda sin enlace.

Añade el enlace

Pega este código en el functions.php de tu tema. Si el tema recibe actualizaciones, pon el código en un tema hijo: una actualización sobrescribe functions.php.

PHP
function add_customize_menu_link() {
    add_submenu_page(
        'themes.php', // Parent menu slug (Appearance)
        'Customize', // Page title
        'Customize', // Menu title
        'manage_options', // Capability required to access
        '/customize.php' // URL to link to
    );
}

add_action('admin_menu', 'add_customize_menu_link');

Solo los administradores ven el nuevo elemento. En el menú aparece como «Customize»; puedes cambiar ese texto en el código.

Enlace Personalizar en el menú Apariencia del escritorio de WordPress

El favicon ya no necesita el Personalizador

En abril de 2024, cuando escribí la primera versión de esta entrada, yo ponía el icono del sitio (favicon) en el Personalizador. Desde WordPress 6.5 el mismo ajuste está en Ajustes → Generales → Icono del sitio.

El sitio antiguo: Personalizador → Identidad del sitio → Icono del sitio.

Panel Identidad del sitio del Personalizador con la opción Icono del sitio

Si el logotipo y el icono son la misma imagen, selecciona el bloque Logotipo del sitio en el Editor del sitio y activa Usar como icono del sitio en la barra lateral de ajustes del bloque.

Cuándo sigue siendo útil el enlace

Usa el código si tú o tu cliente seguís abriendo el Personalizador, por ejemplo para editar allí el CSS adicional. El CSS del Personalizador se guarda por tema: al cambiar de tema, el CSS del anterior deja de cargarse. El Editor del sitio tiene su propio campo: Estilos → CSS adicional.

Si un plugin registra ajustes en el Personalizador, WordPress muestra el enlace por sí solo. En ese caso no uses el código, o el menú tendrá dos enlaces al Personalizador.

Configuro y adapto temas de bloques para clientes. Mira Contrátame.

Roman Fink