Gutenberg será en muy poco tiempo el nuevo editor de contenidos de WordPress, basado en "bloques", que hará que cambie nuestra manera de crear los contenidos en nuestros sitios. Pero, ¿está tu tema preparado para Gutenberg o vas a esperar que lo haga otro?
Con la implantación de Gutenberg en las próximas versiones de WordPress, se van a generar muchas oportunidades de empleo relacionadas con la adaptación de muchos sitios al nuevo editor.
Repasaremos las claves principales para adaptar cualquier tema al nuevo editor de contenidos.
3. BIO
@fpuenteonline - Informático de vocación y de
profesión,
formador ocasional y beginner de comer y beber.
Desde 1996 trabajando en TI, los últimos 12 en medios
de comunicación online y comercio electrónico
• Consultor Enterprise en SiteGround
• Consultor Desarrollo de Negocio en YITH
• CTO de Exprime Viajes y Dormir de Chollo
• Formador en Fundación COPE
• Consultor freelance especializado en performance
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
10. Hoja de ruta
0. Previo
1. Entorno de pruebas
2. Instalar plugin Gutenberg
3. Test de Gutenberg con nuestro tema
4. Test de bloques con nuestro tema
5. Toma de decisiones
6. Adaptar tema
7. Paso a producción
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
11. 0.- Previo
• Page-builders: consultar estado del desarrollo
• Github Gutenberg - “[Type] Plugin / Theme
interoperability”
https://tinyurl.com/wcsevillathemesproblem
• Gutenberg Plugin Compatibility
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
https://plugincompat.danielbachhuber.com/
12. 1.- Entorno de pruebas
Entorno de test, desarrollo, staging, local, clon, es decir,
un entorno seguro donde podamos realizar pruebas sin
“romper” el sitio en producción.
Lo más similar al entorno de producción en cuanto a
contenidos, versiones, tema y plugins activos.
Con tu tema actual.
Nota: verificar siempre que no tenemos opciones de
caché durante las pruebas que no modifiquen el
resultado
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
13. 2.- Instalar y activar Gutenberg
A día de hoy, Gutenberg es un plugin en el repositorio
oficial, hasta su incorporación en el core
Versión actual 3.2.0 (utilizada en la charla)
Requiere WordPress 4.9.6 (última es 4.9.7)
Desde este momento, es posible editar Entradas
y Páginas con el editor clásico y el nuevo editor
Gutenberg (defecto)
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
14. A día de hoy, Gutenberg es un plugin en el repositorio
oficial, hasta su incorporación en el core
Versión actual 3.2.0 (utilizada en la charla)
Requiere WordPress 4.9.6 (última es 4.9.7)
Desde este momento, es posible editar Entradas
y Páginas con el editor clásico y el nuevo editor
Gutenberg (defecto)
También seguirán disponibles tus
page builders
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
2.- Instalar y activar Gutenberg
15. 3.- Test de Gutenberg
Dispone de una página Demo
El plugin añade automáticamente
el siguiente código que incluye
un CSS con las clases que utiliza
el nuevo editor en el front-end:
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
<link rel='stylesheet' id='wp-core-blocks-css'
href='https://misitio.com/wp-content/plugins/
gutenberg/build/core-blocks/style.css?
ver=1530962659' type='text/css' media='all' />
17. 4.- Test de bloques (versión 1)
- Añadir una nueva entrada
- Insertar diferentes tipos de bloques
- Guardar y publicar
- ¿Funciona? ¿Diseño back igual o parecido al front?
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
18. 4.- Test de bloques (versión 2)
- Añadir una nueva entrada
- Cambiar el modeo del Editor a Editor de código
- Copiar y pegar el texto del siguiente enlace:
https://tinyurl.com/wcsevillagutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
20. 4.- Test de bloques (versión 2)
- Añadir una nueva entrada
- Cambiar al Editor de código
- Copiar y pegar el texto del siguiente enlace:
https://tinyurl.com/wcsevillagutenberg
- Volver al Editor visual (bloques generados)
- Guardar y publicar
- ¿Funciona? ¿Diseño back igual o parecido al front?
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
22. 5.- Toma de decisiones
Opción Adaptar tu tema
• Pequeños ajustes visuales front-end: reescribir
clases Gutenberg, o eliminar el CSS de Gutenberg
y aplicar uno propio
• Extender el tema para las nuevas funcionalidades
• Añadir a Gutenberg diseños de nuestro tema
• Mantener los contenidos anteriores con el editor
clásico o migrar aquellos contenidos de interés
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
23. 5.- Toma de decisiones
Opción Borrón y nuevo tema
• Elección de nuevo tema, compatible 100%
Gutenberg
• Migración de contenidos
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
24. 5.- Toma de decisiones
Opción Caerse de Gutenberg
• Desactivar plugin/funcionalidad Gutenberg
cuando sea necesario (¿conoces “No Gutenberg”
de Fernando Tellado?)
• Mantener tema actual
• Verificar las actualizaciones de los plugins
utilizados en nuestro sitio
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
25. 6.- Adaptar tema
Opción 1: adaptar Gutenberg a nuestro tema
• Mejor control visual y buenas prácticas
• Reescribir los estilos de Gutenberg a los bloques
para adaptarlos a nuestro tema (+ opción 2)
Opción 2: extender Gutenberg a nuestro tema
• Fácil y rápido
• Adaptar front y back
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
26. 6.1.- Rediseñar Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
//Sustituir CSS de front-end de Gutenberg
function remove_gutenberg_styles() {
wp_dequeue_style( 'wp-core-blocks' );
wp_enqueue_style( 'my-core-blocks',
get_template_directory_uri() . '/blocks-style.css');
}
add_action( 'wp_print_styles',
'remove_gutenberg_styles', 100 );
Paso 1:
- Eliminar el CSS que incluye Gutenberg en el front y
reemplazarlo por nuestros propios estilos de bloques
- Archivo CSS base de Gutenberg:
/plugins/gutenberg/build/core-blocks/style.css
28. 6.1.- Rediseñar Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
//Estilos para Gutenberg Editor and Front end.
function add_new_gutenberg_css() {
wp_enqueue_style( 'extra-gutenberg',
get_template_directory_uri() . '/xtra-style.css');
}
add_action( 'enqueue_block_assets',
'add_new_gutenberg_css' );
Paso 2:
- Incluir los estilos comunes en front y back, por
ejemplo, colores o fuentes o clases adicionales
30. 6.1.- Rediseñar Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
Paso 3:
- Eliminar el CSS que incluye Gutenberg en el back y
reemplazarlo por nuestros propios estilos de front y
back
- Archivo CSS base de Gutenberg:
/plugins/gutenberg/build/core-blocks/style.css
- Añadir nuestro CSS para adaptar Gutenberg en el
back, sobreescribiendo los estilos del editor
31. 6.1.- Rediseñar Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
//Eliminar CSS de bloques Gutenberg del editor
function add_new_gutenberg_backend_css() {
wp_dequeue_style( 'wp-core-blocks' );
wp_enqueue_style( 'my-core-blocks',
get_template_directory_uri() . '/blocks-style.css');
wp_enqueue_style( 'backend-gutenberg',
get_template_directory_uri() . '/backend-style.css');
wp_enqueue_style( 'open-sans-google-fonts', 'https://
fonts.googleapis.com/css?family=Open+Sans:300italic,
400italic,700italic,400,700,300');
}
add_action( 'enqueue_block_editor_assets',
‘add_new_gutenberg_backend_css’,);
Paso 3 (continuación):
33. 6.- Adaptar tema
Opción 1: adaptar Gutenberg a nuestro tema
• Mejor control del diseño y buenas prácticas
• Reescribir los estilos de Gutenberg para
adaptarlos a nuestro tema (+ opción 2)
Opción 2: extender Gutenberg a nuestro tema
• Fácil y rápido
• Adaptar front y back
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
34. 6.2.- Extender Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
Paso 1:
En nuestro functions.php, añadir dos opciones más de
alineación para ciertos bloques: ancho amplio y ancho
completo
function extend_gutenberg_for_me() {
// Theme supports wide images, galleries and videos.
add_theme_support( 'align-wide' );
}
add_action( 'after_setup_theme',
'extend_gutenberg_for_me' );
35. 6.2.- Extender Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
Paso 1 (continuación):
Añadir las nuevas clases (.alignwide y .alignfull) a
nuestro archivo CSS del tema
/* Gutenberg Ancho amplio */
.entry-content > .alignwide {
max-width: 1100px;
}
/* Gutenberg Ancho completo */
.entry-content > .alignfull {
max-width: 100%;
}
36. 6.2.- Extender Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
/*classes*/
.mayusculas {
text-transform: uppercase;
}
.mayusculas-open-sans {
font-family: "Open Sans";
text-transform: uppercase;
font-weight: bold;
}
Paso 2 (opcional):
Crear CSS adicionales para los
archivos front y del editor
37. 6.2.- Extender Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
Paso 3:
Eliminar la posibilidad de usar el “Selector de color
personalizado”
function extend_gutenberg_for_me() {
// Disables custom colors in block color palette.
add_theme_support( 'disable-custom-colors' );
}
add_action( 'after_setup_theme',
'extend_gutenberg_for_me' );
38. 6.2.- Extender Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
Paso 4 (continuación):
Crear colores personalizados de texto y fondo
(functions.php)
function extend_gutenberg_for_me() {
// Disables custom colors in block color palette.
add_theme_support( 'disable-custom-colors' );
// Make specific theme colors available in the editor.
add_theme_support( 'editor-color-palette',
array(
'name' => 'azulon',
'color' => '#1767ef',
),
array(
'name' => 'gris clarito',
'color' => '#eee',
),
array(
'name' => 'gris oscuro',
'color' => '#444',
));
}
add_action( 'after_setup_theme', 'extend_gutenberg_for_me' );
39. 6.2.- Extender Gutenberg
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline
Paso 4 (continuación):
Crear colores personalizados de texto y fondo
(styles.css)
/* Colores */
.has-azulon-background-color {
background-color: #1767ef;
}
.has-azulon-color {
color: #1767ef;
}
.has-gris-clarito-background-color {
background-color: #eee;
}
.has-gris-clarito-color {
color: #eee;
}
.has-gris-oscuro-background-color {
background-color: #444;
}
.has-gris-oscuro-color {
color: #444;
}
40. 7.- Paso a producción
- Activar el plugin Gutenberg o esperar al nuevo core
- Subir los cambios al entorno de producción
- Mantener el editor clásico para los contenidos
antiguos
- Editar los nuevos contenidos con Gutenberg
- Adaptar contenidos antiguos a los
nuevos bloques, manualmente o
con la función “Convertir en
bloques”
Adapta tu tema a Gutenberg – WordCamp Sevilla 2018 - @fpuenteonline