Dominar WP_Query Propiedades y Métodos

Bienvenido a otra parte de nuestra serie "Mastering WP_Query". Cómo lo estamos haciendo hasta ahora? Espero que estés disfrutando de estos tutoriales tanto como nosotros disfrutamos escribiéndolos..

En este tutorial, aprenderá sobre las propiedades y los métodos de WP_Query clase. Pero primero, creo que es apropiado hablar sobre qué "propiedades" y "métodos" hay en una clase.

Debemos?

¿Qué son las propiedades y los métodos, exactamente?

En PHP, hay una manera de escribir código en una limpiador forma: programación orientada a objetos, o POO. Con la POO, usamos "clases" como planos: tomé el término de uno de los clásico publicaciones de Code Tuts +, "PHP orientado a objetos para principiantes" por Jason Lengstorf:

Una clase, por ejemplo, es como un plano para una casa. Define la forma de la casa en el papel, con relaciones entre las diferentes partes de la casa claramente definidas y planificadas, aunque la casa no exista..

(Y recuerda que WP_Query Es una clase esencial del núcleo de WordPress.)

Cuando entiendes la noción de las clases de PHP, "propiedades" y "métodos" se vuelven extremadamente fáciles de entender ya que las palabras son solo sinónimos de "variables" y "funciones". Sí, propiedades Son variables de una clase PHP y metodos son funciones de una clase de PHP.

Ahora que hemos cubierto lo que son, vamos a conocer cada una de esas propiedades y métodos..

Advertencia: No sería prudente cambiar las propiedades directamente. Como dice el Codex, deberías interactuar con ellos usando los métodos de WP_Query.

Propiedades de la clase WP_Query

Comencemos con las propiedades, o las variables, de la WP_Query clase.

La cadena de consulta: $ consulta

Esta propiedad almacena la consulta pasada a la $ wp_query objeto.

La matriz de variables de consulta: $ query_vars

Esta propiedad almacena una matriz asociativa de las variables (y sus valores) de $ consulta.

El objeto consultado: $ queried_object

Esta propiedad almacena el objeto consultado actualmente, como el $ post objeto si se trata de una consulta posterior o la $ autor objetar si es una consulta de autor.

El ID del objeto consultado: $ queried_object_id

Esta propiedad almacena el ID del objeto consultado..

Los mensajes devueltos de la consulta: $ mensajes

Esta propiedad almacena las publicaciones devueltas de la consulta..

El número de publicaciones que se muestran: $ post_count

Esta propiedad almacena el número de mensajes para la consulta actual.

El número de publicaciones devueltas de la consulta: $ found_posts

Esta propiedad almacena el número de publicaciones sin el LÍMITE cláusula de la consulta SQL.

El número de páginas: $ max_num_pages

Esta propiedad almacena el número de páginas, se calcula dividiendo $ found_posts por $ posts_per_page.

El índice del puesto actual: $ current_post

Esta propiedad almacena el número de índice del elemento actual en el bucle. Por ejemplo, es -1 Si el Loop acaba de comenzar y se incrementa por el siguiente_post () método.

El puesto actual: $ post

Esta propiedad almacena, bueno, el post actual.

Booleanos de etiquetas condicionales: $ es_ condicional

Las siguientes propiedades se almacenan como valores booleanos, que proporcionan información sobre el estado de la publicación actual:

  • $ is_single: Comprueba si se trata de una publicación única de cualquier tipo de publicación (excepto los tipos de publicación "adjuntos" y "página") o no.
  • $ is_page: Comprueba si es una pagina o no.
  • $ is_archive: Comprueba si es una página de archivo o no.
  • $ is_preview: Comprueba si es una vista previa de la publicación o no.
  • $ is_date: Comprueba si es una página de archivo basada en la fecha o no.
  • $ is_year: Comprueba si es una página de archivo basada en el año o no.
  • $ is_month: Comprueba si es una página de archivo basada en un mes o no.
  • $ is_time: Comprueba si es una página de archivo basada en el tiempo (por hora, minuciosamente o en segundo lugar) o no.
  • $ es_autor: Comprueba si es la página de archivo de un autor o no.
  • $ is_category: Comprueba si es una página de archivo de categoría o no.
  • $ is_tag: Comprueba si es una página de archivo de etiquetas o no.
  • $ is_tax: Comprueba si es una página de archivo de taxonomía o no.
  • $ is_search: Comprueba si es una página de "resultados de búsqueda" o no.
  • $ is_feed: Comprueba si es un feed o no.
  • $ is_comment_feed: Comprueba si es un feed de comentarios o no.
  • $ is_trackback: Comprueba si es un trackback o no.
  • $ is_home: Comprueba si es la página principal del blog o no..
  • $ is_404: Comprueba si es una página de error 404 o no.
  • $ is_comments_popup: Comprueba si es una ventana emergente de comentarios o no.
  • $ is_admin: Comprueba si es el panel de administración o no.
  • $ is_attachment: Comprueba si es un archivo adjunto o no.
  • $ is_singular: Comprueba si se trata de una publicación única de cualquier tipo de publicación (incluidos los tipos de publicación "adjuntos" y "página") o no.
  • $ is_robots: Comprueba si es una consulta para el robots.txt archivo o no.
  • $ is_posts_page: Comprueba si es la "Página de publicaciones" (establecida en la página "Configuración de lectura" en el panel de administración) o no.
  • $ is_paged: Comprueba si es una consulta paginada y no es la primera página.

Métodos de la clase WP_Query

Ahora que hemos terminado con las propiedades, pasemos a los métodos (funciones) de la WP_Query clase.

en eso()

Este método simplemente inicializa el objeto, estableciendo todas las propiedades en NULO, 0 o FALSO.

parse_query ($ consulta)

Este método utiliza el $ consulta propiedad para analizar la consulta y rellenar todas las demás propiedades (excepto $ mensajes, $ post_count, $ post y $ current_post).

parse_query_vars ()

Este método vuelve a analizar las variables de consulta.

obtener ($ query_var)

Este método obtiene una variable de consulta dada..

conjunto ($ query_var, $ valor)

Este método establece la variable de consulta dada a un valor específico.

& get_posts ()

Este método devuelve los mensajes solicitados por la consulta y llena el $ mensajes y $ post_count propiedades.

siguiente_post ()

Este método incrementa la $ current_post Índice y avanza al siguiente post en. $ mensajes, devolviendo el objeto post actual. (Este método debe usarse dentro de un Loop para que funcione correctamente).

el cargo()

Este método establece el global $ post Variable con los datos del próximo post. (Este método debe usarse dentro de un Loop para que funcione correctamente).

have_posts ()

Este método verifica si quedan publicaciones por trabajar, y devuelve FALSO si no hay (Este método debe ser utilizado antes de un bucle para trabajar correctamente.)

rewind_posts ()

Este método simplemente restablece el $ current_post y $ post propiedades.

& consulta ($ consulta)

Este método llama a dos de sus métodos hermanos., parse_query () y get_posts (), y devuelve el resultado de get_posts ().

get_queried_object ()

Este método devuelve el objeto consultado. (Se pone $ queried_object si no está ya establecido.)

get_queried_object_id ()

Este método, similar al anterior, devuelve el ID del objeto consultado ($ queried_object_id).

Consejo rapido: Si hay un signo antes de un método, significa que el método devuelve por referencia.

Envolviendo para hoy

Espero haber logrado dejar en claro para usted lo que significa "propiedades" y "métodos" para las clases. Y si entendieras el propósito de las propiedades y métodos de la WP_Query Clase, puedo decir que he hecho un trabajo decente.!

¿Tienes algo que añadir a este artículo? Comparte tus pensamientos con nosotros en la sección de Comentarios a continuación. Y si te gustó el artículo, no olvides compartirlo con tus amigos..

Nos vemos en la siguiente parte de la serie.!