Cómo usar mosaico para añadir cuadrícula de entradas estilo Pinterest en WordPress

Esta es una entrada invitada de Josh Pollock

La visualización de entradas en cuadrícula tipo Pinterest ha sido un diseño popular para las páginas de índice de los blogs de WordPress durante un tiempo. Es popular no solo porque imita el aspecto del popular sitio de medios sociales, sino también porque hace el mejor uso del espacio en la pantalla. En el índice de un blog de WordPress, permite que la vista previa de cada entrada tenga el tamaño que necesita de forma natural, sin dejar espacio extra.

En esta guía práctica, le mostraré cómo usar la popular biblioteca Masonry JavaScript para crear disposiciones de cuadrícula en cascada para el índice de su blog, así como páginas de archivo para su tema. Voy a abordar algunos problemas que hay que tener en cuenta para la optimización para móviles y cómo resolverlos.

Nota: Este es un tutorial de nivel avanzado para aquellos que se sientan cómodos editando temas de WordPress y tengan suficientes conocimientos de HTML/CSS.

Paso 1: Añadir las bibliotecas necesarias a su tema

Actualización: WordPress 3.9 ahora incluye la última versión de Mosaico.

Primero necesitas cargar Mosaico en tu tema, usando este código:

if (! function_exists('slug_scripts_masonry') ) :
if ( ! is_admin() ) :
function slug_scripts_masonry() {
    wp_enqueue_script('masonry');
    wp_enqueue_style('masonry’, get_template_directory_uri().'/css/’);
}
add_action( 'wp_enqueue_scripts', 'slug_scripts_masonry' );
endif; //! is_admin()
endif; //! slug_scripts_masonry exists

Este código simplemente carga mosaico y lo hace disponible para los archivos de plantilla de su tema (vea nuestra guía sobre cómo añadir correctamente JavaScripts y Estilos en WordPress). También tenga en cuenta que no estamos añadiendo jQuery como una dependencia para cualquiera de los dos. Una de las ventajas de Masonry 3 es que no requiere jQuery, pero puede usarse con él. En mi experiencia, inicializar Mosaico sin jQuery es más fiable, y abre la posibilidad de omitir la carga de jQuery, lo que puede ayudar tanto con los tiempos de carga de la página como con las incidencias de compatibilidad.

Paso 2: Inicializar el Javascript

Esta siguiente función establece Masonry, define los contenedores que se utilizarán con él y también se asegura de que todo sucede en el orden correcto. Masonry necesita calcular el tamaño de cada uno de los elementos de la página para poder disponer su cuadrícula dinámicamente. Un problema que he encontrado con Masonry en muchos navegadores es que Masonry calculará mal la altura de los elementos con imágenes de carga lenta, lo que lleva a la superposición de elementos. La solución es utilizar imagesLoaded para evitar que Masonry calcule la estructura / disposición / diseño / plantilla hasta que todas las imágenes estén cargadas. Esto asegura un tamaño adecuado.

Esta es la función y acción que mostrará el script de inicialización en el pie de página:

if ( ! function_exists( 'slug_masonry_init' )) :
function slug_masonry_init() { ?>
<script>
    //set the container that Masonry will be inside of in a var
    var container = document.querySelector('#masonry-loop');
    //create empty var msnry
    var msnry;
    // initialize Masonry after all images have loaded
    imagesLoaded( container, function() {
        msnry = new Masonry( container, {
            itemSelector: '.masonry-entry'
        });
    });
</script>
<?php }
//add to wp_footer
add_action( 'wp_footer', 'slug_masonry_init' );
endif; // ! slug_masonry_init exists

La función se explica paso a paso con comentarios integrados. Lo que hace la función de JavaScript es decirle a Masonry que busque dentro de un contenedor con el id “masonry-loop” elementos con la clase “masonry-entry” y que calcule la cuadrícula solo después de que se carguen las imágenes. Establecemos el contenedor exterior con querySelector y el interior con itemSelector.

Paso 2: Crear bucle de mosaico

En lugar de añadir el marcado HTML para mosaico directamente a una plantilla vamos a crear una parte de plantilla separada para ello. Cree un nuevo archivo llamado “content-masonry.php” y añádalo a su tema. Esto le permitirá añadir el bucle de mosaico a tantas plantillas como desee.

En tu nuevo archivo añadirás el código que se muestra a continuación. El código es similar al que verías normalmente en cualquier vista previa de contenido. Puedes modificarlo como necesites, sólo asegúrate de que el elemento más externo tiene la clase “masonry-entry” que establecimos como itemSelector en el último paso.

<article class="masonry-entry" id="post-<?php the_ID(); ?>" <?php post_class(); ?> >
<?php if ( has_post_thumbnail() ) : ?>
    <div class="masonry-thumbnail">
        <a href="<?php the_permalink(' ') ?>" title="<?php the_title(); ?>"><?php the_post_thumbnail('masonry-thumb'); ?></a>
    </div><!--.masonry-thumbnail-->
<?php endif; ?>
    <div class="masonry-details">
        <h5><a href="<?php the_permalink(' ') ?>" title="<?php the_title(); ?>"><span class="masonry-post-title"> <?php the_title(); ?></span></a></h5>
        <div class="masonry-post-excerpt">
            <?php the_excerpt(); ?>
        </div><!--.masonry-post-excerpt-->
    </div><!--/.masonry-entry-details -->  
</article><!--/.masonry-entry-->

Este marcado tiene clases para cada una de sus partes, por lo que puedes añadir marcas que se adapten a tu tema. Me gusta añadir un bonito borde ligeramente redondeado a .masonry-entry. Otra buena opción es no poner borde a .masonry-entry, pero darle una ligera sombra. Eso se ve particularmente bien cuando la miniatura de la entrada se extiende todo el camino hasta el borde del contenedor, que se puede lograr dando .masonry-thumbnail márgenes y rellenos de 0 en todas las direcciones. Usted querrá añadir todos estos estilos en un archivo llamado masonry.css en el directorio css de su tema.

Paso 3: Añadir lazo mosaico a las plantillas

Ahora que tenemos nuestra parte de plantilla puedes usarla en cualquier plantilla de tu tema que quieras. Puedes añadirlo a index.php, pero no a category.php si no quieres que se use para los archivos de categorías. Si solo quieres que se use en la página de inicio de tu tema, cuando está establecida para mostrar entradas de blog, lo usarías en home.php. Dondequiera que usted elija todo lo que necesita hacer es envolver su bucle en un contenedor con el id “masonry-loop” y añadir la parte de la plantilla en el bucle utilizando get_template_part(). Asegúrese de iniciar el contenedor del bucle de mosaico antes de while (have_posts() ).

Por ejemplo, aquí está el bucle principal del index.php de twentythirteen:

<?php if ( have_posts() ) : ?>

    <?php /* The loop */ ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <?php get_template_part( 'content', get_post_format() ); ?>
    <?php endwhile; ?>

    <?php twentythirteen_paging_nav(); ?>

<?php else : ?>
    <?php get_template_part( 'content', 'none' ); ?>
<?php endif; ?>

Y aquí está modificado para conseguir utilizar nuestro bucle mosaico:

<?php if ( have_posts() ) : ?>
<div id="masonry-loop">
    <?php /* The loop */ ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <?php get_template_part( 'content', 'masonry' ?>
    <?php endwhile; ?>
</div><!--/#masonry-loop-->
    <?php twentythirteen_paging_nav(); ?>

<?php else : ?>
    <?php get_template_part( 'content', 'none' ); ?>
<?php endif; ?>

Paso 4: Establecer anchuras adaptables de los elementos de mosaico

Hay varias formas de establecer la anchura de cada elemento / artículo de Masonry. Puedes establecer el ancho usando un número de píxeles cuando inicializas el mosaico. No soy un fan de hacer eso ya que uso temas adaptables y requiere algunas consultas de medios complejos para hacer las cosas bien en pantallas pequeñas. Para diseños adaptables, he encontrado que lo mejor es establecer un valor de anchura para .masonry-entry con un porcentaje, basado en el número de elementos que desea en una fila y dejar que Masonry haga el resto de los cálculos por usted.

Todo lo que esto requiere es dividir el 100 por el número de elementos que desea establecer el porcentaje en una simple entrada en style.css de su tema. Por ejemplo, si quieres cuatro elementos en cada fila puedes hacer esto en tu archivo masonry.css:

.masonry-entry{ancho:25%}

Paso 5: Optimización para móviles

Podríamos parar aquí, pero no creo que el resultado final funcione increíblemente bien en las pantallas pequeñas de los teléfonos. Una vez que esté satisfecho con el aspecto de su tema con la nueva cuadrícula de mosaico en su escritorio, compruébelo en su teléfono. Si no estás contento con cómo se ve en tu teléfono, entonces tendrás que hacer un poco de trabajo.

No creo que haya suficiente espacio en la pantalla de un teléfono para todo lo que hemos añadido a nuestra parte de contenido-plantilla de mosaico. Dos buenas soluciones disponibles para usted son acortar el extracto para los teléfonos u omitirlo por completo. Aquí hay una función extra que puedes añadir al functions.php de tu tema para hacer eso. Porque no creo que estos problemas son un problema en las tabletas, estoy usando un gran plugin Mobble en todos los ejemplos en esta sección para hacer los cambios solo en los teléfonos, no tabletas. También estoy marcando / comprobando para ver si Mobble está activo antes de usarlo y si es necesario volver a la función de detección móvil más general wp_is_mobile que se construye en WordPress.

if (! function_exists('slug_custom_excerpt_length') ) :
function slug_custom_excerpt_length( $length ) {
    //set the shorter length once
    $short = 10;
    //set long length once
    $long = 55;
    //if we can only set short excerpt for phones, else short for all mobile devices
    if (function_exists( 'is_phone') {
        if ( is_phone() ) {
            return $short;
        }
        else {
            return $long;
        }        
    }
    else {
        if ( wp_is_mobile() ) {
            return $short;
        }
        else {
            return $long;
        }
    }
}
add_filter( 'excerpt_length', 'slug_custom_excerpt_length', 999 );
endif; // ! slug_custom_excerpt_length exists

Como puedes ver, empezamos almacenando la longitud del extracto largo y la longitud del extracto corto en variables, ya que usaremos esos valores dos veces y queremos poder cambiarlos desde un lugar si lo necesitamos más adelante. A partir de ahí comprobamos si podemos usar is_phone() de Mobble. Si es así establecemos el extracto corto para teléfonos y el extracto largo si no lo somos. Después de eso hacemos lo mismo, pero utilizando wp_is_mobile, que afectará a todos los dispositivos móviles, si is_phone() no se puede utilizar. Esperemos que la parte else de esta función nunca se utilice, pero es bueno tener una copia de seguridad por si acaso. Una vez que se establece la lógica de la longitud del extracto, sólo queda enganchar la función al filtro excerpt_length.

Acortar el extracto es una opción, pero también podemos eliminarlo por completo con un sencillo proceso. Aquí hay una nueva versión de contenido mosaico, con toda la parte del extracto omitido en los teléfonos:

<article class="masonry-entry" id="post-<?php the_ID(); ?>" <?php post_class(); ?> >
<?php if ( has_post_thumbnail() ) : ?>
    <div class="masonry-thumbnail">
        <a href="<?php the_permalink(' ') ?>" title="<?php the_title(); ?>"><?php the_post_thumbnail('masonry-thumb'); ?></a>
    </div><!--.masonry-thumbnail-->
<?php endif; ?>
    <div class="masonry-details">
        <h5><a href="<?php the_permalink(' ') ?>" title="<?php the_title(); ?>"><span class="masonry-post-title"> <?php the_title(); ?></span></a></h5>
        <?php 
            //put the excerpt markup in variable so we don't have to repeat it multiple times.
            $excerpt = '<div class="masonry-post-excerpt">';
            $excerpt .= the_excerpt();
            $excerpt .= '</div><!--.masonry-post-excerpt-->';
//if we can only skip for phones, else skip for all mobile devices
            if (function_exists( 'is_phone') {
                if ( ! is_phone() ) {
                    echo $excerpt;
                }
            }
            else {
                if ( ! wp_is_mobile() ) {
                    echo $excerpt;
                }
            }
        ?>
    </div><!--/.masonry-entry-details -->  
</article><!--/.masonry-entry-->

Esta vez estamos probando si no estamos en un teléfono / dispositivo móvil y si es así devolvemos la parte del extracto de nuestro bucle. Si estamos en un teléfono / dispositivo móvil no hacemos nada.

Otra cosa que podríamos hacer es aumentar el ancho de los elementos / artículos de mosaico, lo que reduce el número en una fila, en los dispositivos móviles. Para ello, vamos a añadir un estilo integrado diferente a la cabecera basado en la detección de dispositivos. Dado que esta función utiliza wp_add_inline_styles dependerá de una hoja de estilo específica. En este caso estoy usando masonry.css, que es posible que desee, para mantener sus estilos de mosaico por separado. Si no terminas usando eso puedes usar el manejador de otra hoja de estilos ya registrada.

if ( ! function_exists ( 'slug_masonry_styles' ) ) :
function slug_masonry_styles() {
    //set the wide width
    $wide = '25%';
    //set narrow width
    $narrow = '50%';
    /**Determine value for $width**/
    //if we can only set narrow for phones, else narrow for all mobile devices
    if (function_exists( 'is_phone') {
        if ( is_phone() ) {
            $width = $narrow;
        }
        else {
            $width = $wide;
        }        
    }
    else {
        if ( wp_is_mobile() ) {
            $width = $narrow;
        }
        else {
            $width = $wide;
        }
    }
    /**Output CSS for .masonry-entry with proper width**/
    $custom_css = ".masonry-entry{width: {$width};}";
    //You must use the handle of an already enqueued stylesheet here.
    wp_add_inline_style( 'masonry', $custom_css );
}
add_action( 'wp_enqueue_scripts', 'slug_masonry_styles' );
endif; // ! slug_masonry_styles exists

Esta función busca la hoja de estilos personalizada, y luego establece un valor para el ancho usando lo que ahora debería ser una lógica muy familiar. Después creamos la variable $custom_css pasando el valor de anchura a una parte de CSS de aspecto normal con {$width}. Después usamos wp_add_inline_style para decirle a WordPress que imprima nuestros estilos integrados en la cabecera siempre que se esté usando la hoja de estilos de mosaico y luego ganchamos toda la función a wp_enqueue_scripts y ya está.

Si elige combinar sus estilos Masonry en una hoja de estilos existente, asegúrese de usar el handle de esa hoja de estilos con wp_add_inline_style o sus estilos integrados no serán incluidos. Me gusta usar wp_add_inline_style porque generalmente envuelvo el gancho de acción para poner en cola Mosaico en una condicional para que solo se añada cuando sea necesario. Por ejemplo, si solo utilizo mosaico en el índice de mi blog y en las páginas de archivo, haría lo siguiente:

if ( is_home() || is_archive() ) {
    add_action( 'wp_enqueue_scripts', 'slug_scripts_masonry' );
}

Estos últimos ejemplos deberían abrir otras ideas en tu cerebro. Por ejemplo, se podría utilizar una lógica similar para omitir Mosaico por completo en un dispositivo móvil. También wp_add_inline_style() es una función menos utilizada, pero muy útil, ya que le permite establecer mediante programación diferentes estilos basados en cualquier tipo de condicional. Puede permitirle cambiar radicalmente el estilo de cualquier elemento basándose no solo en la detección del dispositivo, sino que los cambios también podrían basarse en qué plantilla se está utilizando, o incluso si el usuario está conectado o no.

Espero que veas estos diferentes cambios que estoy haciendo como una oportunidad para ser creativo. Los sistemas de mosaicos y cuadrículas en cascada similares han sido populares desde hace un tiempo, así que es hora de darle un nuevo giro a esta popular idea. Muéstranos en los comentarios qué formas geniales se te han ocurrido para el uso de mosaico en un tema de WordPress.

Josh Pollock escribe acerca de WordPress, desarrolla temas, gestiona la comunidad de Pods Framework y aboga por soluciones de código abierto para el diseño sostenible.