Como usar a maçonaria para adicionar uma grade de postagem no estilo Pinterest no WordPress

Esta é uma postagem de convidado de Josh Pollock

A exibição de posts em grade semelhante à do Pinterest tem sido um design popular para as páginas de índice de blogs do WordPress há algum tempo. Ele é popular não só porque imita a aparência do popular site de mídia social, mas também porque faz o melhor uso do espaço na tela. Em um índice de blog do WordPress, ele permite que a visualização de cada post tenha o tamanho que naturalmente precisa ter, sem deixar espaço extra.

Neste tutorial, mostrarei como usar a popular biblioteca JavaScript Masonry para criar layouts de grade em cascata para o índice do seu blog, bem como páginas de arquivo para o seu tema. Abordarei alguns problemas que você precisa considerar para a otimização para dispositivos móveis e como resolvê-los.

Observação: este é um tutorial de nível avançado para aqueles que se sentem à vontade para editar temas do WordPress e têm conhecimento suficiente de HTML/CSS.

Etapa 1: Adicione as bibliotecas necessárias ao seu tema

Atualização: O WordPress 3.9 agora inclui a versão mais recente do Masonry.

Primeiro, você precisa carregar o Masonry em seu 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

Esse código simplesmente carrega o Masonry e o torna disponível para os arquivos de modelo do seu tema (consulte nosso guia sobre como adicionar corretamente JavaScripts e estilos no WordPress). Observe também que não estamos adicionando o jQuery como uma dependência para nenhum dos dois. Uma das vantagens do Masonry 3 é que ele não exige o jQuery, mas pode ser usado com ele. Em minha experiência, a inicialização do Masonry sem o jQuery é mais confiável e abre a possibilidade de ignorar o carregamento do jQuery, o que pode ajudar no tempo de carregamento da página e em problemas de compatibilidade.

Etapa 2: inicializar o Javascript

Esta próxima função configura o Masonry, define os contêineres que serão usados com ele e também garante que tudo aconteça na ordem correta. O Masonry precisa calcular o tamanho de cada um dos itens na página para fazer o layout da grade dinamicamente. Um problema que encontrei com o Masonry em muitos navegadores é que ele calcula incorretamente a altura dos itens com imagens de carregamento lento, o que leva à sobreposição de itens. A solução é usar imagesLoaded para evitar que o Masonry calcule o layout até que todas as imagens sejam carregadas. Isso garante o dimensionamento adequado.

Essa é a função e a ação que produzirá o script de inicialização no rodapé da 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

A função é explicada passo a passo com comentários em linha. O que a função Javascript faz é dizer ao Masonry para procurar dentro de um contêiner com o id “masonry-loop” os itens com a classe “masonry-entry” e calcular a grade somente depois que as imagens forem carregadas. Definimos o contêiner externo com querySelector e o interno com itemSelector.

Etapa 2: criar loop de alvenaria

Em vez de adicionar a marcação HTML do Masonry diretamente a um modelo, vamos criar uma parte do modelo separada para ele. Crie um novo arquivo chamado “content-masonry.php” e adicione-o ao seu tema. Isso permitirá que você adicione o loop do Masonry a quantos modelos diferentes desejar.

Em seu novo arquivo, você adicionará o código mostrado abaixo. A marcação é semelhante à que você veria normalmente em qualquer visualização de conteúdo. Você pode modificá-lo como quiser, mas certifique-se de que o elemento mais externo tenha a classe “masonry-entry” que definimos como itemSelector na última etapa.

<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-->

Essa marcação tem classes para cada uma de suas partes, de modo que você pode adicionar marcações que combinem com seu tema. Gosto de adicionar uma borda agradável e ligeiramente arredondada a .masonry-entry. Outra boa opção é não colocar nenhuma borda no .masonry-entry, mas dar a ele uma leve sombra. Isso fica particularmente bom quando a miniatura da postagem se estende até a borda do contêiner, o que pode ser feito com as margens e os paddings de 0 em todas as direções do .masonry-thumbnail. Você deverá adicionar todos esses estilos em um arquivo chamado masonry.css no diretório css do seu tema.

Etapa 3: Adicionar o loop de alvenaria aos modelos

Agora que temos nossa parte de modelo, você pode usá-la em qualquer modelo do seu tema que desejar. Você pode adicioná-lo ao index.php, mas não ao category.php se não quiser que ele seja usado para arquivos de categoria. Se quiser que ele seja usado somente na página inicial do tema, quando estiver configurado para mostrar as postagens do blog, você o usará no home.php. Seja qual for a sua escolha, tudo o que você precisa fazer é envolver o loop em um contêiner com o ID “masonry-loop” e adicionar a parte do modelo ao loop usando get_template_part(). Certifique-se de iniciar o contêiner do loop de alvenaria antes de while (have_posts() ).

Por exemplo, aqui está o loop principal do index.php do 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; ?>

E aqui ele é modificado para usar nosso loop Masonry:

<?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; ?>

Etapa 4: Definir larguras responsivas dos itens de alvenaria

Há várias maneiras de definir a largura de cada item do Masonry. Você pode definir a largura usando um número de pixels ao inicializar o Masonry. Não gosto muito de fazer isso, pois uso temas responsivos e isso exige algumas consultas de mídia complexas para que as coisas fiquem corretas em telas pequenas. Para designs responsivos, descobri que a melhor coisa a fazer é definir um valor de largura para .masonry-entry com uma porcentagem, com base em quantos itens você deseja em uma linha e deixar que o Masonry faça o resto da matemática para você.

Tudo o que isso requer é dividir 100 pelo número de itens que você deseja definir como porcentagem em uma entrada simples no style.css do seu tema. Por exemplo, se você quiser quatro itens em cada linha, poderá fazer isso em seu arquivo masonry.css:

.masonry-entry{width:25%}

Etapa 5: Otimização para dispositivos móveis

Poderíamos parar por aqui, mas não acho que o resultado final funcione muito bem em telas de telefones pequenos. Quando estiver satisfeito com a aparência do seu tema com a nova grade Masonry em seu desktop, verifique-o em seu celular. Se não estiver satisfeito com a aparência no telefone, será necessário fazer um pequeno trabalho.

Não creio que haja espaço suficiente na tela de um telefone para tudo o que adicionamos à nossa parte de modelo de conteúdo de alvenaria. Duas boas soluções disponíveis são encurtar o trecho para telefones ou ignorá-lo completamente. Aqui está uma função extra que você pode adicionar ao functions.php do seu tema para fazer isso. Como não acho que essas questões sejam um problema em tablets, estou usando um excelente plug-in Mobble em todos os exemplos desta seção para fazer as alterações apenas em telefones, não em tablets. Também estou verificando se o Mobble está ativo antes de usá-lo e, se necessário, recorrendo à função mais geral de detecção de dispositivos móveis, wp_is_mobile, que está integrada ao 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 você pode ver, começamos armazenando o comprimento do trecho longo e o comprimento do trecho curto em variáveis, uma vez que usaremos esses valores duas vezes e queremos poder alterá-los em um só lugar se precisarmos mais tarde. A partir daí, testamos se podemos usar o is_phone() do Mobble. Se for o caso, definimos o trecho curto para telefones e o trecho longo se não formos. Depois disso, fazemos a mesma coisa básica, mas usando wp_is_mobile, que afetará todos os dispositivos móveis, se is_phone() não puder ser usado. Esperamos que a parte else dessa função nunca seja usada, mas é bom ter um backup, por precaução. Depois que a lógica do comprimento do trecho estiver definida, basta conectar a função ao filtro excerpt_length.

Encurtar o trecho é uma opção, mas também podemos eliminá-lo completamente com um processo simples. Aqui está uma nova versão do content-masonry, com toda a parte do trecho omitida nos telefones:

<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-->

Desta vez, estamos testando para ver se não estamos em um telefone/dispositivo móvel e, em caso afirmativo, retornamos a parte do trecho do nosso loop. Se estivermos em um telefone/dispositivo móvel, não faremos nada.

Outra coisa que você pode querer fazer é aumentar a largura dos itens de alvenaria, o que reduz o número de itens em uma linha, em dispositivos móveis. Para fazer isso, adicionaremos um estilo em linha diferente ao cabeçalho com base na detecção do dispositivo. Como essa função usa wp_add_inline_styles, ela dependerá de uma folha de estilo específica. Nesse caso, estou usando masonry.css, o que talvez você queira, para manter os estilos de alvenaria separados. Se acabar não usando esse arquivo, poderá usar o identificador de outra folha de estilo já 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

Essa função busca a folha de estilo personalizada e, em seguida, define um valor para a largura usando o que agora deve ser uma lógica muito familiar. Depois disso, criamos a variável $custom_css passando o valor da largura para uma parte do CSS de aparência normal com {$width}. Depois disso, usamos wp_add_inline_style para dizer ao WordPress que imprima nossos estilos inline no cabeçalho sempre que a folha de estilo Masonry estiver sendo usada e, em seguida, conectamos toda a função a wp_enqueue_scripts e estamos prontos.

Se optar por combinar seus estilos Masonry em uma folha de estilo existente, certifique-se de usar o identificador dessa folha de estilo com wp_add_inline_style ou seus estilos inline não serão incluídos. Gosto de usar wp_add_inline_style porque geralmente envolvo o gancho de ação para enfileirar o Masonry em uma condicional para que ele seja adicionado somente quando necessário. Por exemplo, se eu estiver usando o Masonry somente no índice do meu blog e nas páginas de arquivo, eu faria o seguinte:

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

Esses últimos exemplos devem abrir algumas outras ideias em seu cérebro. Por exemplo, você poderia usar uma lógica semelhante para ignorar completamente o Masonry em um dispositivo móvel. Além disso, wp_add_inline_style() é uma função menos usada, mas muito útil, pois permite que você defina programaticamente estilos diferentes com base em qualquer tipo de condicional. Ela pode permitir que você altere radicalmente o estilo de qualquer elemento com base não apenas na detecção do dispositivo, mas as alterações também podem ser baseadas no modelo que está sendo usado ou até mesmo se o usuário está conectado ou não.

Espero que você veja essas diferentes alterações que estou fazendo como uma oportunidade de ser criativo. A alvenaria e os sistemas de grade em cascata semelhantes já são populares há algum tempo, portanto, chegou a hora de dar novas reviravoltas nessa ideia popular. Mostre-nos nos comentários quais são as maneiras legais que você encontrou para usar o Masonry em um tema do WordPress.

Josh Pollock, um profissional multifuncional do WordPress, escreve sobre o WordPress, desenvolve temas, atua como gerente de comunidade do Pods Framework e defende soluções de código aberto para design sustentável.