Em alguns casos, pode ser necess\u00e1rio modificar a consulta global de postagem que o WordPress est\u00e1 realizando em qualquer p\u00e1gina que voc\u00ea estiver visitando \u2013 tanto admin quanto frontend. Neste guia, veremos qual gancho usar e como alterar os argumentos da consulta ao seu gosto.<\/p>\n
Primeiro voc\u00ea precisa saber em qual gancho adicionar seu c\u00f3digo. Precisamos de um gancho que aconte\u00e7a logo ap\u00f3s o WordPress configurar todos os argumentos, mas antes que a consulta real seja executada. Para isso usamos a a\u00e7\u00e3o Neste gancho voc\u00ea obt\u00e9m um par\u00e2metro; que \u00e9 um Modificar a consulta provavelmente requer que voc\u00ea use algumas tags condicionais para especificar os casos em que deseja alter\u00e1-la. Por exemplo, voc\u00ea pode querer segmentar a consulta apenas em resultados de pesquisa ou exibi\u00e7\u00f5es de categoria.<\/p>\n O WordPress tem v\u00e1rias tags condicionais<\/a> que voc\u00ea pode usar para especificar em quais casos deseja adicionar seu c\u00f3digo. Uma tag condicional \u00e9 simplesmente uma fun\u00e7\u00e3o que retorna true ou false dependendo do estado em que o WordPress est\u00e1. Exemplos de tags condicionais comuns s\u00e3o Tenha em mente que o hook As tags condicionais s\u00e3o \u00f3timas e tudo, mas h\u00e1 algumas coisas a serem lembradas ao us\u00e1-las dentro Em primeiro lugar, voc\u00ea precisa se familiarizar com a tag Em segundo lugar, voc\u00ea precisa estar ciente dos casos em que precisa verificar as tags condicionais no objeto fornecido em vez de chamar a fun\u00e7\u00e3o “independentemente". Normalmente, quando voc\u00ea usa tags condicionais, voc\u00ea escreveria assim:<\/p>\n No entanto, ao usar Voc\u00ea deve sempre verificar Este \u00e9 um exemplo de verifica\u00e7\u00e3o se n\u00e3o estamos no admin e se estamos na consulta do post principal:<\/p>\n Como estamos trabalhando com um Voc\u00ea usa a Nos casos em que voc\u00ea deseja anexar ou alterar um argumento preexistente, normalmente faria isso salvando primeiro o argumento existente em uma vari\u00e1vel. Voc\u00ea pode usar o m\u00e9todo Aqui est\u00e1 um exemplo r\u00e1pido de uso O WordPress tem subclasses separadas para lidar com a Os argumentos que voc\u00ea adiciona ou altera dependem inteiramente do que voc\u00ea deseja fazer, mas agora voc\u00ea deve ter algumas ideias sobre estrat\u00e9gias para obter a consulta global. Se voc\u00ea precisar obter algumas informa\u00e7\u00f5es sobre o pre_get_posts<\/code>.<\/p>\nWP_Query<\/code>objeto com o qual o WordPress executar\u00e1 a consulta posteriormente. Voc\u00ea faz altera\u00e7\u00f5es no objeto \u2013 mas n\u00e3o precisa devolv\u00ea-lo, pois o WordPress executar\u00e1 a consulta com o objeto modificado.<\/p>\nadd_action('pre_get_posts', function($query) {\n \/\/ Add your code here\n});<\/code><\/pre>\nTags condicionais<\/h2>\n
is_admin()<\/code>para verificar se estamos atualmente em admin ou frontend, is_singular()<\/code>se estamos em um \u00fanico post ou p\u00e1gina no frontend e is_search()<\/code>se estivermos na p\u00e1gina de resultados da pesquisa.<\/p>\npre_get_posts<\/code>\u00e9 executado tanto para admin quanto para frontend. Se voc\u00ea deseja apenas afetar a consulta global no frontend, voc\u00ea precisa envolver seu c\u00f3digo dentro de um if-check na tag condicional is_admin()<\/code>.<\/p>\nObserva\u00e7\u00e3o sobre tags condicionais em
pre_get_posts<\/code><\/h3>\npre_get_posts<\/code>de .<\/p>\nis_main_query()<\/code>. Na verdade, a a\u00e7\u00e3o pre_get_posts<\/code>\u00e9 executada v\u00e1rias vezes para cada carregamento de p\u00e1gina. Por exemplo pre_get_posts<\/code>, \u00e9 executado ao gerar cada menu (incluindo aqueles em widgets). Para modificar a consulta global real, por exemplo, postagens para um arquivo de categoria ou resultados de pesquisa, voc\u00ea precisa segmentar a "consulta principal" usando is_main_query()<\/code>.<\/p>\nif (is_main_query()) {\n \/\/ Do stuff\n}<\/code><\/pre>\npre_get_posts<\/code>, existem algumas tags condicionais que voc\u00ea precisa aplicar no objeto. Por exemplo:<\/p>\nadd_action('pre_get_posts', function($query) {\n if ($query->is_main_query()) {\n \/\/ Add your code here\n }\n});<\/code><\/pre>\nis_main_query()<\/code>o objeto fornecido em pre_get_posts<\/code>. Leia a documenta\u00e7\u00e3o de pre_get_posts<\/a> para obter mais informa\u00e7\u00f5es.<\/p>\nadd_action('pre_get_posts', function($query) {\n if (!is_admin() && $query->is_main_query()) {\n \/\/ Add your code here\n }\n});<\/code><\/pre>\nAlterar ou adicionar argumentos<\/h2>\n
WP_Query<\/code>objeto, voc\u00ea pode consultar a documenta\u00e7\u00e3o do WP_Query<\/a> para saber como construir seus argumentos para personalizar a consulta de posts. Lembre-se de que os argumentos j\u00e1 est\u00e3o preenchidos. Nesse caso, voc\u00ea precisa anexar ou alterar os valores existentes. Ou remova os que voc\u00ea deseja remover.<\/p>\nset()<\/code>fun\u00e7\u00e3o no WP_Query<\/code>objeto para definir argumentos. O m\u00e9todo aceita dois argumentos, a chave do argumento e, em segundo lugar, o valor. Por exemplo, definir o posts_per_page<\/code>argumento seria feito assim:<\/p>\nadd_action('pre_get_posts', function($query) {\n if (!is_admin() && $query->is_main_query()) {\n $query->set('posts_per_page', 20);\n }\n});<\/code><\/pre>\nget()<\/code>para isso. Em seguida, voc\u00ea modifica a vari\u00e1vel, anexando ou mesclando matrizes ou outros enfeites. E, finalmente, voc\u00ea usa set()<\/code>para substituir a vari\u00e1vel modificada de volta no objeto de consulta. Eu recomendo usar var_dump()<\/code>no objeto para ver o que ele cont\u00e9m, e essa tamb\u00e9m \u00e9 uma boa maneira de verificar se suas tags condicionais est\u00e3o corretas.<\/p>\nget()<\/code>(simplesmente verificando se est\u00e1 vazio) e, se estiver, adicione seus pr\u00f3prios argumentos com set()<\/code>.<\/p>\nadd_action('pre_get_posts', function($query) {\n if (!is_admin() && $query->is_main_query()) {\n if (!$query->get('meta_query')) {\n $query->set('meta_query', [\/ your arguments here \/]);\n }\n }\n});<\/code><\/pre>\nObserva\u00e7\u00e3o sobre tax_query<\/h3>\n
WP_Tax_Query<\/code>parte taxonomia () dentro do WP_Query<\/code>. Se voc\u00ea precisar fazer modifica\u00e7\u00f5es de consulta de taxonomia mais complexas, a pre_get_posts<\/code>a\u00e7\u00e3o pode ser muito precoce. Alguns valores podem estar vazios porque s\u00e3o preenchidos posteriormente. Nesse caso, talvez seja melhor usar a a\u00e7\u00e3o parse_tax_query<\/code>em vez de pre_get_posts<\/code>. Leia a documenta\u00e7\u00e3o para este gancho<\/a> para ver se isso \u00e9 para voc\u00ea.<\/p>\nConclus\u00e3o<\/h2>\n
WP_Query<\/code>objeto e como usar seus argumentos, meu post sobre como consultar postagens<\/a> pode ser interessante.<\/p>\n