✅ Notícias, temas e plug-ins da WEB e do WordPress. Aqui compartilhamos dicas e as melhores soluções para sites.

Tutorial de Tema WordPress para Iniciantes – Parte 4: O Post Loop

16

Nesta lição do tutorial do tema WordPress para iniciantes, entraremos em detalhes sobre o “post loop" no WordPress; o que é, como se parece, por que o usamos e como acessar os posts. loop em nosso tema.

O ciclo de postagem

Se você estiver familiarizado com PHP, deve reconhecer que um “loop” é uma técnica de passar por cada elemento em uma matriz ou objeto com for, foreachou while. O loop no WordPress funciona exatamente assim. Mas usaremos as próprias funções do WordPress para fazer um loop para obter alguns benefícios e simplificações adicionais.

Em todos os momentos, o WordPress já consultou as postagens para você – dependendo da página em que você está. Se você estiver em uma página de categoria, o WordPress já consultou todas as postagens associadas a essa categoria, e se você estiver em uma única página de postagem, o WordPress já buscou essa postagem para você.

Quando queremos acessar as postagens que o WordPress consultou em nossos modelos, adicionamos o loop. Dentro do loop temos acesso a cada post. E para cada post decidimos o que mostrar ou fazer.

Nota: Mesmo em modelos de postagem única ou página única, você adicionará um loop, mesmo sabendo que contém apenas uma postagem! O loop simplesmente é executado apenas uma vez.

Aqui está o loop do WordPress em toda a sua glória:

while (have_posts()): the_post(); // Access to each post here endwhile;

Este pedaço de código faz duas coisas. A whileparte (incluindo o endwhile) é a parte do loop que fará o loop independentemente do tempo em que houver postagens restantes. A segunda parte é a the_post()que configura o acesso simplificado e intuitivo ao objeto post dentro do loop. Aprenderemos mais sobre isso mais adiante.

É uma boa prática envolver o loop dentro de uma ifverificação que verifica se realmente existem postagens para percorrer. Então, opcionalmente, também podemos mostrar uma mensagem se não houver. A consulta de postagem pode estar vazia se você for para um arquivo de categoria vazio ou tentar pesquisar algo que não tenha resultados. Esta é uma versão melhor do loop:

Familiarize-se com este pedaço de código, pois você o repetirá sempre que quiser acessar as postagens! Vamos implementar o loop em nosso tema.

Implementando o loop em nosso tema

Vamos adicionar o loop em nosso index.php, substituindo o texto fictício.

Eu adicionei uma função chamada the_title()dentro do loop que ecoa o título do post. Isso é só para que possamos ver o loop na prática. Não se preocupe, na próxima etapa aprenderemos tudo sobre como acessar todas as informações reais da postagem.

Vamos ver o que acontece no WordPress agora. Atualize a página inicial. Dependendo de suas configurações e conteúdo, você deverá ver alguns títulos aparecendo. No meu WordPress eu tenho o post padrão “Hello world!” e outro post que criei intitulado “Este é outro post”. Isto é o que eu recebo na primeira página:

Tutorial de Tema WordPress para Iniciantes – Parte 4: O Post Loop

Se você tentar visitar uma única página de postagem, deverá ver apenas um título, o título da postagem que está visualizando. Agradável!

Para os curiosos…

Se você está curioso sobre como o loop está circulando e quais parâmetros o WordPress usou para esta consulta, você pode conferir. A variável global à qual o loop está se referindo é chamada $wp_query. Você precisa defini-lo globalmente para acessá-lo. Tente usar var_dump()para imprimir seu conteúdo completo. O loop está percorrendo a $wp_query->postspropriedade.

global $wp_query; var_dump($wp_query);

Vamos adicionar um detalhe importante ao nosso loop em index.php; uma maneira de o usuário navegar para a página seguinte e anterior de postagens.

Adicionando navegação de loop de postagem

Lembre-se de que o loop buscará o número de posts definido em suas Configurações do WordPress > Leitura, sempre que você estiver em uma página que mostre vários posts. Se houver mais postagens disponíveis no loop do que o número definido aqui, precisamos de uma maneira de navegar entre as páginas. Para isso podemos usar a função the_posts_pagination().

Esta função aceita alguns parâmetros para personalizar sua saída. Você pode definir o número de páginas entre as elipses (quando houver muitas páginas). Você também pode definir quais devem ser os textos para os links das páginas “Anterior” e “Próxima”. Vou adicioná-lo sem nenhum parâmetro para fazer os padrões, mas você pode ajustá-lo se quiser.

... while (have_posts()): the_post(); the_title(); endwhile; the_posts_pagination(); } else { ...

Esta função não produz absolutamente nada se houver postagens menores ou iguais ao número de postagens por configuração de página. Portanto, não se preocupe se você acha que errou porque não vê nenhuma saída. Quando houver mais postagens do que postagens por página, essa função gera um div, um cabeçalho para leitores de tela (que você normalmente oculta com CSS) e vários links de paginação.

Agora que sabemos como ter acesso a qualquer post que o WordPress encontrou para nós, o próximo passo é aprender a mostrar o que queremos de cada post; dentro do laço.

Documentação sobre os métodos usados

Fonte de gravação: awhitepixel.com

Este site usa cookies para melhorar sua experiência. Presumiremos que você está ok com isso, mas você pode cancelar, se desejar. Aceitar Consulte Mais informação