¿Por qué debería poner if (have_posts ()), es while (have_posts ()) no suficiente?

22

Tengo una pregunta sobre "el bucle".

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<?php endwhile; else: ?>
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
<?php endif; ?>

Código tomado de la página de The Loop WordPress Codex .

¿Por qué debería poner ifparte? Parece que si hay un whilebucle, funciona bien.

¿En qué caso se produce un problema si no hay una ifdeclaración?

Editar

Acepté la respuesta de @ Chip. pero honestamente diciendo que solo necesito la última parte.

Ahora sé lo que quería saber de mi pregunta.

ifLa declaración es solo cuando es necesario, si desea poner un encabezado o pie de página que debe escribirse solo una vez. Si no utiliza el "contenedor", la ifdeclaración no es necesaria.

hierro y
fuente
2
He votado antes de leer el_contenido, ¡el_título es decisivo!
brasofilo
Excelente (final) editar. La mayoría de las personas usan el if y while directamente uno detrás del otro sin usar otro. Probablemente debido a copiar y pegar.
Herbert Van-Vliet

Respuestas:

29

El cargador de plantillas de WordPress incluirá el archivo de plantilla contextual apropiado en muchas circunstancias, incluso si la consulta para ese contexto no devuelve publicaciones. Por ejemplo:

  • El índice principal de publicaciones de blog
  • Índice de archivo de categoría (la categoría existe, pero no tiene publicaciones)
  • Índice de archivo de etiquetas (la etiqueta existe, pero no tiene publicaciones)
  • Índice de archivo de autor (El autor existe, pero no tiene publicaciones)
  • Índice de resultados de búsqueda

Por lo tanto, en estos casos, se cargará el archivo de plantilla apropiado, pero no se generarán publicaciones, ya que la consulta no devuelve publicaciones.

Ejemplos de prueba de concepto:

Entonces, en estos contextos, es útil que el archivo de plantilla incluya el if ( have_posts() )condicional.

En otros contextos, el archivo de plantilla nunca se cargará si la consulta no devuelve publicaciones. Por ejemplo:

  • Publicación de blog individual
  • Página estática

En estos contextos, if ( have_posts() )es probablemente innecesario.

Editar

Entiendo que the_post () invoca la consulta, ¿verdad? Y si mientras existe (have_posts ()), la consulta nunca se produce si no hay publicación.

Para entender lo que está sucediendo, debes mirar el orden de las acciones de WordPress . Comenzando con wp_loaded(y omitiendo algunos para mayor claridad):

  • wp_loaded
  • parse_request
  • send_headers
  • parse_query
  • pre_get_posts
  • wp
  • template_redirect
  • get_header
  • wp_head
  • the_post
  • wp_footer

Entonces, ¿qué está pasando y en qué orden?

  • Se invoca la consulta:
    • parse_query
    • pre_get_posts
    • wp
  • La plantilla está seleccionada:
    • template_redirect
  • La plantilla está cargada / salida. La plantilla realiza las siguientes acciones :
    • get_header
    • wp_head
    • the_post
    • dynamic_sidebar
    • get_footer
    • wp_footer

Entonces, the_postdisparado por the_post(), sucede mucho después de que se analiza la consulta, se obtienen las publicaciones y se carga la plantilla.

Estoy muy agradecido de que brindes mucha información que no conocía, pero esto no es lo que te pedí.

Oh, pero creo que es exactamente lo que preguntaste.

La verdadera pregunta es: ¿qué es una devolución de consulta válida ? Para contextos como el índice de archivo de categoría, la consulta es válida y la plantilla de categoría se carga, si existe la ID de categoría consultada, incluso si no hay publicaciones asignadas a esa categoría .

¿Por qué? Porque la consulta que se analiza es (IIRC) &cat={ID}, que es una consulta válida incluso si no hay publicaciones asignadas a esa categoría y, por lo tanto, no da como resultado un 404 al analizar.

En ese caso, obtienes una consulta válida y un archivo de plantilla cargado, pero no hay publicaciones . Por lo tanto, if ( have_posts() ), es, de hecho relevante. Nuevamente, aquí hay un ejemplo: la categoría existe, pero no tiene publicaciones asignadas. Se carga el archivo de plantilla de categoría, con if ( have_posts() )retornofalse .

Esto no será válido para las consultas que incluyen una variable de publicación ( &p={ID}) como publicaciones de blog individuales y páginas estáticas, porque la publicación no existirá realmente y, cuando se analice, la consulta no devolverá un objeto válido.

Editar 2

Si entiendo correctamente si no hay if (have_posts ()) en una plantilla de categoría y la categoría no tiene publicación, entonces devuelve 404.php, a pesar de que debería devolver category-sample.php sin publicación. ¿Está bien?

No. Recuerde: la plantilla se selecciona en template_redirect. Entonces, si la consulta es válida, se carga el archivo de plantilla apropiado. Si la consulta no es válida, se carga la plantilla 404.

Entonces, una vez que se carga una plantilla, por ejemplo, la plantilla de categoría, una vez que se emite el bucle, la plantilla no cambia .

Mire nuevamente el orden de las acciones:

  • parse_query
  • pre_get_posts
  • wp
  • template_redirect- la plantilla se elige y se carga aquí. Este es el punto de plantilla sin retorno . La plantilla no puede cambiar después de este punto.
  • ...
  • the_post- postdata se configura aquí, como parte de la llamada de bucle. Esto se llama dentro de la plantilla , y la plantilla no cambia según los datos disponibles en el objeto de consulta

Edición final

Y afirmo que, si bien verifica la existencia de publicaciones, ¿por qué debería ejecutar la misma prueba dos veces? Esa es mi pregunta desde el primer punto que he estado preguntando solo sobre eso.

Y con eso, finalmente entiendo: todo el tiempo, su pregunta no tuvo nada que ver con WordPress , o el bucle de WordPress . Estás preguntando si puedes envolver cualquier whilebucle PHP arbitrario dentro de un ifcondicional que verifique la misma condición.

Esa pregunta está fuera del alcance de WPSE, pero explicaré brevemente:

Un ifcondicional es una evaluación binaria: es uno trueo false, y lo que sucede dentro de ese condicional se ejecuta una vez .

Un whilecondicional es un ciclo : sigue siendo cierto durante un período discreto, basado en algún tipo de contador; y lo que sucede dentro de ese condicional se ejecuta varias veces , una vez por cada iteración del contador.

Entonces, supongamos que desea generar una lista de cosas sin ordenar, si la lista de cosas está llena. Si usa un whilebucle y omite el ifcontenedor, su marcado se vería así:

<ul>
<?php while ( list_of_things() ) : ?>
    <li><?php the_list_item(); ?></li>
<?php endwhile; ?>
</ul>

Y si list_of_things()estuviera vacío, la salida representada sería:

<ul>
</ul>

Lo que deja un marcado innecesario (e inválido).

Pero si agrega un ifcontenedor condicional, puede hacer esto:

<?php if ( list_of_things() ) : ?>
    <ul>
    <?php while ( list_of_things() ) : ?>
        <li><?php the_list_item(); ?></li>
    <?php endwhile; ?>
    </ul>
<?php endif; ?>

Y si list_of_things()estaba vacío, no se generaría ningún marcado.

Ese es solo un ejemplo. Hay muchos usos para ese ifcontenedor condicional, y el ifcontenedor condicional tiene un propósito completamente diferente al del whilebucle.

Chip Bennett
fuente
2
En mis singulares plantillas de publicación / página, desde hace mucho tiempo, lo uso solo the_post();porque también whilees innecesario. +1 para la integridad de las informaciones.
gmazzap
@GM Posiblemente eliminar la if( have_posts() )declaración tiene sentido (eso es lo que estoy tratando de descubrir), ¡pero no lo use solo the_post()en páginas singulares!
Sunyatasattva
@ChipBennett Teniendo en cuenta todo, ¿cree que es seguro retirar la if( have_post() )condición antes de la vuelta completa en el contexto de single-*.phpy page-*.phparchivos de plantilla?
Sunyatasattva
1
"Seguro" realmente no tiene un significado definitivo en este contexto.
Chip Bennett
10

Es realmente imposible mejorar la respuesta de Chip, pero solo para ir al grano:

Use la ifparte si desea que aparezca algo diferente cuando no hay publicaciones . Esto es particularmente útil, por ejemplo, en una página de archivo de fecha o categoría. Si alguien navega a una página que no tiene publicaciones, es bueno tener un mensaje que lo diga, en lugar de que no aparezca nada, porque el bucle nunca se ejecuta.

if ( have_posts() ):
  // Yep, we have posts, so let's loop through them.
  while ( have_posts() ) : the_post();
  // do your loop
  endwhile;
else :
  // No, we don't have any posts, so maybe we display a nice message
  echo "<p class='no-posts'>" . __( "Sorry, there are no posts at this time." ) . "</p>";
endif;
Tom Auger
fuente
Y esto es todo lo que uno necesita saber.
Herbert Van-Vliet
0

Puede haber algunas consideraciones que no están incluidas en las respuestas hasta ahora. No se recomienda omitir la instrucción if.

La declaración if se usa comúnmente para:

  • genera algo como no posts foundindicar que la categoría en cuestión no tiene artículos asignados.
  • para decidir si se debe mostrar html circundante (como un ul) antes y después de los artículos.

¿Qué pasa si se agrega un nuevo gancho?

Otro posible problema de no usar la instrucción if es que si el equipo de wordpress alguna vez decide agregar un nuevo enlace que $wp_query->have_posts()se active en la primera llamada, se activaría en el momento equivocado. Y si eso causa un comportamiento inesperado, sería su culpa por no seguir las especificaciones correctamente.

Otros desarrolladores esperan ver una estructura específica para el ciclo de WordPress

Supongo que otros desarrolladores esperan ver el ciclo completo de WordPress. Entonces, tal vez sea una mala idea hacer que busquen una declaración if que no esté allí.

RMo
fuente
-1

Veo esto como una cuestión fundamental de la teoría de la estructura de control. El bloque encerrado dentro del ciclo while no se ejecuta ni una sola vez si la condición (have_posts ()) se evalúa como falsa la primera vez.

Por lo tanto, el propósito de if ( have_posts() )en el bucle de WordPress es solo ejecutar la función have_posts () una vez antes de evaluar la condición while. Si have_posts()no tiene efectos secundarios, entonces if ( have_posts() )es totalmente inútil. Si have_posts()tiene efectos secundarios, puede simplificarlo de la siguiente manera:

<?php have_posts(); ?>
<?php while ( have_posts() ) : the_post(); ?>
<?php endwhile; else: ?>
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
<?php endif; ?>
Schparky
fuente
3
Esa simplificación es PHP inválido, tiene una declaración else que no tiene una declaración if adjunta. En el mejor de los casos, es difícil de leer
Tom J Nowell
1
El ifestá allí por el elsedespués. No hay otro motivo. Si no hay publicaciones, es mejor mostrar un buen mensaje "sin publicaciones" que no mostrar nada.
Otto