O melhor guia para o loop do WordPress

Neste tutorial, analisarei O laço, e como o WordPress o usa para exibir suas postagens e páginas. Lembre-se, isso é um pouco mais avancado do que nossos tutoriais anteriores. Espero que você encontre este guia definitivo mais fácil de entender do que o que está disponível no Documentação do WordPress. Aqui está o que abordaremos:


  • Uma definição de O laço.
  • Fluxo básico do Loop.
  • Tags de modelo usadas em O laço
  • O que fazer depois O laço
  • Hierarquia do arquivo de modelo

Se você deseja entender melhor como um tema WordPress realmente funciona nos bastidores, continue lendo.

Nota: este tutorial pressupõe que você esteja usando um tema padrão do WordPress, como o tema padrão do Kubrick. Não há coisas avançadas de vários circuitos … ainda.

O que é o Loop?

Você provavelmente ainda está se perguntando o que é o The Loop. Basicamente, é o que exibe o conteúdo que você vê no seu pagina inicial, seu postagens únicas, Páginas, arquivos, resultados de pesquisa e muito mais.

Se um usuário acessar sua página inicial, arquivos ou resultados de pesquisa – por padrão, o Loop exibirá um certo número de postagens, conforme definido nas Opções de leitura.

Opções de leitura do WordPress

No momento, meu pagina inicial exibe 10 postagens por página, que foi o que eu defini Mostrar no máximo * postagens. Em postagens e páginas únicas – o mesmo código de loop básico exibirá apenas a página específica.

Fluxo básico do loop

Vamos dividir o loop em 3 partes.

<?php if (have_posts ()): ?>
<?php while (have_posts ()): the_post (); ?>

1. O que você deseja exibir no loop

<?php endtime;?>

2. O que é exibido quando o loop termina

<?php else: ?>

3. Se não houver nada para exibir

<?php endif; ?>

E se houver postagens disponíveis na consulta, ele começará a exibi-las em um enquanto loop, o que é definido em parte 1. Quando o tempo terminar, ele exibirá o que está parte 2. Se não houver postagens encontradas, ou houver algum outro tipo de erro 404, parte 3 é exibido.

Tags de modelo usadas no loop

A menos que você queira 1. O que você deseja exibir no Loop repetido 10 vezes na página inicial do seu blog WordPress, você provavelmente deve aprender algumas das tags de modelo básicas. Vamos dar uma olhada no código de index.php no modelo padrão do WordPress.

WordPress Loop Breakdown

Como você pode ver, existem alguns tags de modelo dentro do loop que exibirá itens como o título da postagem, o link permanente, o conteúdo etc. Eu detalharei cada uma das tags de modelo no tema padrão do WordPress.

  • <?php the_permalink () ?> – Isso fará eco ao link permanente da postagem, ou seja, http://www.themelab.com/?p=1
  • <?php the_title (); ?> – Isso faz eco ao título da postagem, ou seja, Olá Mundo!
  • <?php the_time (‘F jS, Y’) ?> – Isso fará eco à data, ou seja, 4 de abril de 2008. Uma lista completa de maneiras de formatar a data pode ser encontrada em php.net
  • <?php the_author () ?> – Isso exibirá o nome do autor, ou seja, Leland. Isso é comentado no tema padrão.
  • <?php the_tags (‘Tags:‘, ‘,‘, ‘
    ‘); ?>
    – Isso exibirá as tags atribuídas à postagem, separadas por vírgulas e seguidas por uma quebra de linha
  • <?php the_category (‘,‘) ?> – Isso exibirá as categorias de maneira semelhante às tags acima.
  • <?php edit_post_link (“Editar”, “,” | “); ?> – O link editar postagem ficará visível apenas para quem tiver permissão.
  • <?php comments_popup_link (“Sem comentários” “,” 1 comentário “”, “% Comentários” “); ?> – Irá exibir o link para os comentários. Isso não será exibido em postagens ou páginas únicas.

Há muito mais listado no Tags de modelo página em WordPress.org. Alguns deles podem funcionar no Loop, enquanto outros podem não.

Após o loop

Vamos dar uma olhada no código depois que o loop parar de girar no tema padrão.

Após a quebra do loop

<?php next_posts_link (‘«Entradas mais antigas’ ‘) ?>
<?php previous_posts_link (‘Entradas mais recentes »’) ?>

Como você deve ter adivinhado, isso exibirá a paginação que você vê na página inicial, nos arquivos e nos resultados da pesquisa. Eles não serão exibidos em postagens e páginas únicas. Claro que você pode substituir isso por algo como PageNavi, mas isso depende de você.

Se não houver postagens a serem exibidas (possivelmente devido a um erro 404), o seguinte será exibido depois do resto

Não encontrado

Desculpe, mas você está procurando por algo que não está aqui.

<?php include (TEMPLATEPATH . "/searchform.php"); ?>

Isso exibirá a mensagem Não encontrado junto com o formulário de pesquisa. Nesse caso, teria que haver um código de formulário de pesquisa localizado em um arquivo chamado searchform.php no diretório de modelos, que existe no tema padrão.

Hierarquia de modelos

Alguns arquivos de modelo terão prioridade sobre o index.php para certos tipos de páginas, se estiverem presentes no diretório do modelo. Listados abaixo estão alguns exemplos de hierarquia de modelos, listados em ordem de prioridade.

Pagina inicial

  1. home.php
  2. index.php

Postagem Única

  1. single.php
  2. index.php

Procurar Resultados

  1. search.php
  2. index.php

Página 404

  1. 404.php
  2. index.php

Existem algumas técnicas mais avançadas listadas no Hierarquia de modelos página em WordPress.org.

Então, qual é o objetivo da hierarquia de modelos? Basicamente, você pode usá-lo para criar novos layouts para diferentes tipos de páginas do WordPress sem hackear muito o arquivo index.php.

Conclusão

Então agora (espero) você tenha uma melhor visão sobre o que é o Loop do WordPress. Sinta-se à vontade para deixar um comentário, se você gostou, odiou, não conseguiu entender o que quer que seja – agradeço todos os comentários. Inscrever-se para a alimentação para todas as atualizações mais recentes sobre os lançamentos de temas do Theme Lab e novos tutoriais. Obrigado pela leitura.

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map