ENTENDA A QUERY E O LOOP DO WORDPRESS DE UMA VEZ POR TODAS

Quem?

Marlon lacerda amâncio

marlon@universowp.com.br

O ciclo DE REQUISIÇÃO E RESPOSTA

requisição

Iniciar e carregar o WP

Analisa a URL e define quais posts deverão ser buscados no banco de dados

Buscar no banco de dados os posts requisitados para serem exibidos

https://universowp.com.br/categoria/noticias

Escolher e carregar o template a ser usado para exibir os posts através do Loop

RESPOSTA

A cada resquisição o wordpres executa pelo menos uma consulta padrão ao banco de dados

Como a url é analisada e intepretada

links permanentes legíveis habilitado
(pretty permalinks)

https://universowp.com.br/categoria/noticias

ANÁLISE DA URL

A URL requisitada será analisada para extrair as variáveis (query_vars) que serão usadas como parâmetros para fazer a busca dos posts

https://universowp.com.br/categoria/noticias

https://universowp.com.br/index.php?category_name=noticias

query_vars -> Array (
    category_name => 'noticias',
  )

REESCRITA (WP_REWRITE)

categoria/(.+?)/?$
index.php?category_name=$matches[1]

https://universowp.com.br/categoria/noticias

index.php?category_name=noticias

QUERY VARS

Query Vars são variáveis extraídas da URL ou usadas numa query customizada que determinam (ou afetam) os resultados de uma consulta ao banco de dados.

https://codex.wordpress.org/WordPress_Query_Vars

query_vars -> Array (
    category_name => 'noticias',
  )

Como é feita as buscas dos posts no banco de dados

* Não é a função query_posts()

wp_query

global $wp_query

WP_Query Object
(
    [query] => Array
        (
            [category_name] => noticias
        )
    [query_vars] => Array
        (
            [category_name] => noticias
            [cat] => 33
            [posts_per_page] => 10
            [order] => DESC
        )
    [queried_object] => WP_Term Object
    [queried_object_id] => 33
    [posts] => Array
    [found_posts] => 3
    [is_archive] => 1
    [is_category] => 1  
)

Como customizar a consulta ao banco de dados

alterar a consulta principal

pre_get_posts

Criar uma consulta secundária

New WP_Query

get_posts()

pre_get_posts

super gancho para alterar a query

  • Evita consultas desnecessárias ao banco de dados
  • Disponibiliza acesso as tags condicionais (is_category(), is_home() etc.)
add_action( 'pre_get_posts', 'uwp_altera_posts_per_page' );

function uwp_altera_posts_per_page( $query ) {

    if ( is_admin() || ! $query->is_main_query() ) {
          return;
    }
	
    if ( $query->is_category( 'noticias' ) ) {
        $query->set( 'posts_per_page', '20' );
    }

}

query_posts()

query_posts( 'posts_per_page=20' );
function query_posts($query) {
    $GLOBALS['wp_query'] = new WP_Query();
    return $GLOBALS['wp_query']->query($query);
}
  • Descarta a query principal e gera uma nova query.
  • Substitui as variáveis globais
  • Ignora outros parâmetros recebidos pela URL como por exemplo de paginação.

Como o wordpress escolhe qual template irá exibir os posts

Hierarquia de templates

is_home()

front-page.php > home.php > page.php > index.php

is_page()

{custom-template}.php > page-{slug}.php > page-{id}.php > page.php > index.php

is_single()

single-{post-type}.php > single.php > index.php

is_category()

category-{slug}.php > category-{id}.php > category.php > archive.php > index.php

Como o WP define qual arquivo de template irá usar?

$wp_query (
   is_home => false,
   is_page => false,
   is_single => false,
   is_category => true,
   ... )

Através das Query Vars

Como o wordpress exibe os posts

loop

if ( have_posts() ) :
    while ( have_posts() ) : the_post();
        the_title();
        the_content();
    endwhile;
endif;

Loop é uma estrutura de repetição responsável por exibir o conjunto de posts wp_query->posts resultante da busca no banco de dados.

post, post_count, current_post, in_the_loop

exibindo conteúdo principal - loop

Início do loop

Tudo entre este ponto e o fim do loop será repetido até encerrar a lista de posts consultados no BD.

the_title()

Imprime o título do post que está sendo iterado.

the_excerpt()

Imprime o resumo do post que está sendo iterado.

the_content()

Imprime o conteúdo do post que está sendo iterado.

the_category()

Imprime a categoria do post que está sendo iterado.

the_author()

Imprime o autor do post que está sendo iterado.

Fim do loop

Retorna para o início do loop se houver mais posts ou encerra e continua execução do template.

Outras templates tags

Quaisquer outras templates tags deverão entrar no loop.

Continua execução do template

https://yoast.com/wordpress-theme-anatomy/

Sair

global $post

Como debugar tudo isso?

Debug bar

https://wordpress.org/plugins/search/debug+bar/

Debug This

https://br.wordpress.org/plugins/debug-this/

Query Monitor

https://br.wordpress.org/plugins/query-monitor/

Kint Debugger

https://wordpress.org/plugins/kint-debugger/

missão cumprida!

Obrigado!

referências

  • http://codex.wordpress.org/Query_Overview
  • http://premium.wpmudev.org/blog/wordpress-query-overview-how-a-page-request-is-translated-to-a-mysql-query/
  • http://wordpress.stackexchange.com/questions/71406/is-there-a-flowchart-for-wordpress-loading-sequence
  • http://humanshell.net/2011/08/wordpress-initialization/
  • https://carlalexander.ca/wordpress-adventurous-loading/
  • https://roots.io/routing-wp-requests/
  • https://carlalexander.ca/wordpress-adventurous-wp-query-class/
  • http://code.tutsplus.com/tutorials/using-wordpress-for-web-application-development-rethinking-architecture--wp-33880
  • http://code.tutsplus.com/articles/using-wordpress-for-web-application-development-the-conceptual-model--wp-34095
  • http://code.tutsplus.com/tutorials/using-wordpress-for-web-application-development-understanding-events-actions-and-filters--wp-34113
  • http://www.wrox.com/WileyCDA/WroxTitle/Professional-WordPress-Plugin-Development.productCd-0470916222.html
  • http://www.amazon.com/Professional-WordPress-Development-Brad-Williams/dp/111844227X
Made with Slides.com