Preparación para WordPress 5.4: Cambios que los desarrolladores de temas y complementos deben conocer

Traducido del artículo: “Preparing for WordPress 5.4: Changes Theme and Plugin Developers Should Know About” de:

Justin Tadlock, marzo 4 de 2020

Con el lanzamiento de WordPress 5.4, es hora de que los desarrolladores de plugins y temas comiencen a probar sus extensiones y se aseguren de que no haya problemas. También hay nuevas API para las próximas funciones. Ayer, el equipo central lanzó el primer candidato de lanzamiento para 5.4. El lanzamiento oficial está previsto para el 31 de marzo.
Esta publicación servirá como una guía rápida con enlaces a varios cambios importantes que los desarrolladores deben tener en cuenta en las próximas semanas. Asegúrese de probar sus complementos y temas.

Desarrolladores de temas
Captura de pantalla del nuevo bloque de iconos sociales en uso a través del editor de bloques.
Nuevo bloque de iconos sociales.
Hay varios cambios que los autores de temas querrán probar. WordPress 5.4 tiene algunas características de tema adicionales. También tiene varios cambios relacionados con el marcado que podrían romper los diseños de temas en el front-end y en el editor de bloques. Desafortunadamente, para los autores de temas que desean admitir varias versiones de WordPress, algunos de estos cambios pueden significar un poco de hinchazón CSS adicional.

Iconos sociales y bloques de botones
WordPress 5.4 presenta dos nuevos bloques: íconos y botones sociales. El bloque de iconos sociales permite a los usuarios insertar iconos / enlaces para hasta 40 redes sociales diferentes. El bloque de botones permite a los usuarios agrupar múltiples bloques de botones. Los autores de temas que están implementando estilos de editor de bloques personalizados deben tener en cuenta estos nuevos bloques para asegurarse de que se impriman correctamente.

Crear preajustes de degradado personalizados
La nueva API de degradados permite a los autores de temas definir preajustes de degradado personalizados para que los usuarios los usen con el grupo o los bloques de botones. Los autores de temas necesitarán hacer un poco de trabajo preliminar para mejorar la monstruosidad que son los valores predeterminados de gradiente predeterminados. Con un poco de trabajo, los gradientes pueden ser una herramienta útil a disposición del usuario. Los autores de temas también pueden deshabilitar los gradientes por completo si prefieren no admitirlos.

Bloqueo de marcado del editor y cambios de estilo
Los autores de temas que se hayan dirigido directamente a clases de editor específicas deberán verificar sus estilos de editor de bloques. Muchas clases con el prefijo editor han sido cambiadas para usar el prefijo editor de bloque. El elemento contenedor con la clase .edit-post-layout__content se ha eliminado por completo. Se eliminaron varios elementos de contenedor de los bloques y del componente de texto enriquecido. El relleno incorporado de Core y los márgenes negativos en los bloques se han refactorizado, lo cual es una buena adición. Quizás los autores de temas ya no tendrán que luchar contra múltiples selectores anidados para proporcionar un diseño básico y funcional que coincida con el front-end.
Estos cambios ya han roto varios temas que he visto. Hay muchas posibilidades de que muchos autores de temas necesiten actualizar sus estilos de editor de bloques.
En un momento en que el Equipo de revisión de temas solicita más autores de temas para enviar temas con estilos de editor personalizados, este tipo de cambios en las clases y el marcado no son un impulso de confianza. Los desarrolladores de temas pueden sentir fácilmente que están peleando una batalla perdida. Sin embargo, el trabajo avanza para acercar el marcado del editor a una coincidencia uno a uno con el front-end. En algún momento, los autores de los temas sólo pueden esperar que ya no necesitarán lidiar con este tipo de cambios al tiempo que admiten usuarios en varias versiones de WordPress. Por ahora, se encuentran en una fase de transición algo desordenada.

Marcado de calendario y cambios de clase
El equipo central cambió el marcado de la función get_calendar (), que también afecta el widget Calendario. La salida del calendario ya no tiene un elemento <tfoot>. En cambio, los enlaces del mes anterior y siguiente se movieron a un elemento <nav> debajo del elemento <table>.

La salida del calendario también agrega o cambia múltiples ID y clases:
.wp-calendar-table agregado al elemento contenedor.
.wp-calendar-nav agregado al elemento contenedor de navegación.
.wp-calendar-nav-next reemplaza la #next ID en el enlace del próximo mes.
.wp-calendar-nav-prev reemplaza el #prev ID en el enlace del mes anterior.
Estos son cambios importantes. Será necesario actualizar cualquier CSS personalizado que se haya dirigido al HTML o ID anteriores.

Desarrolladores de bloques
Captura de pantalla de un editor de código que muestra el código inicial para crear un complemento de bloque.
Archivo JavaScript inicial creado por la secuencia de comandos de andamios de bloque.
Para los desarrolladores de complementos que crean bloques personalizados, WordPress 5.4 presenta varias API y herramientas nuevas para trabajar con el sistema de bloques.

Andamios de bloque
Los desarrolladores tienen un nuevo paquete NPM para crear rápidamente un complemento de bloque. Con un solo comando de npm init @ wordpress / block <plugin-name>, el script creará un nuevo directorio y creará los archivos PHP, CSS y JavaScript apropiados necesarios para construir un complemento de bloque. Los desarrolladores pueden usar herramientas modernas de JavaScript de forma predeterminada u opcionalmente elegir usar una versión ES5.
La intención del paquete de andamios de bloques es que los autores de complementos puedan crear complementos de bloque único que eventualmente lleguen al directorio oficial de bloques.

API de colecciones de bloques
La API de Block Collections funciona de manera similar.

API de colecciones de bloques
La API de Block Collections funciona de manera similar a las categorías. Sin embargo, se basan en el espacio de nombres. Cuando un desarrollador de complementos registra una colección personalizada, cualquier bloque que comparta el espacio de nombres de la colección aparecerá en una sección personalizada en el insertador de bloques. Esta parece ser una forma más inteligente de organizar bloques. Sin duda, será útil para los complementos que crean bibliotecas de bloques, proporcionando una forma automática de agruparlos.

API de variaciones de bloque
La nueva API de variaciones de bloques permite a los desarrolladores de bloques crear esencialmente copias de bloques con una variación. Cada variación registrada aparecerá como un bloque separado en el insertador de bloque para que los usuarios elijan.
Un buen ejemplo de esta característica es el nuevo bloque de iconos sociales. Es un bloque único con 40 variaciones para las distintas redes sociales.

Otros cambios relacionados con el desarrollador
Hay un par de otros cambios notables que se cruzan en el territorio de desarrollo de plugins y temas.

Nuevos ganchos de menú de navegación
Después de esperar y esperar y esperar, los desarrolladores finalmente obtienen algunos enlaces solicitados a menudo para agregar campos personalizados a la pantalla de administración y al personalizador del menú de navegación. Al menos un boleto se remonta a 9 años, pero es mejor tarde que nunca. En el pasado, los desarrolladores necesitarían usar una clase de caminante personalizada para realizar algunas de las personalizaciones necesarias. Sin embargo, sólo se podía usar una sola clase de caminante a la vez, lo que significaba que múltiples complementos que realizaban cambios no funcionarían juntos.

El equipo central agregó el nuevo gancho wp_nav_menu_item_custom_fields en la pantalla de administración de los menús de navegación, que aparece antes de los botones “mover” para elementos de menú individuales. Para mantener la paridad con el administrador, los elementos del menú de navegación tienen un nuevo wp_nav_menu_item_custom_fields_customize_template en el personalizador. Estos enlaces permitirán a los desarrolladores agregar campos de formulario personalizados necesarios para agregar datos personalizados a los elementos del menú de navegación.

Función de alias apply_shortcodes ()
WordPress 5.4 presenta una nueva función apply_shortcodes (). Es un alias para la función do_shortcode (). La nueva función proporciona un nombre de función más semánticamente correcto. En general, las funciones con un prefijo de salida do_ expect o algún tipo de acción. Las funciones con un prefijo de apply_ esperan que se devuelvan datos.
Si está creando un tema o complemento con áreas compatibles con shortcodes, querrá cambiar a la nueva función. Si bien la función do_shortcode () no está actualmente marcada por desaprobación, ese debería ser el objetivo final.

Quién es Justin Tadlock

Justin Tadlock es desarrollador, diseñador y escritor. Es un ganador del Mes Nacional de Escritura de Novelas. Ha trabajado con WordPress de alguna forma desde 2005. También tiene muchos gatos, pollos y patos.