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?
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
.
Comencemos con las propiedades, o las variables, de la WP_Query
clase.
$ consulta
Esta propiedad almacena la consulta pasada a la $ wp_query
objeto.
$ query_vars
Esta propiedad almacena una matriz asociativa de las variables (y sus valores) de $ consulta
.
$ 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.
$ queried_object_id
Esta propiedad almacena el ID del objeto consultado..
$ mensajes
Esta propiedad almacena las publicaciones devueltas de la consulta..
$ post_count
Esta propiedad almacena el número de mensajes para la consulta actual.
$ found_posts
Esta propiedad almacena el número de publicaciones sin el LÍMITE
cláusula de la consulta SQL.
$ max_num_pages
Esta propiedad almacena el número de páginas, se calcula dividiendo $ found_posts
por $ posts_per_page
.
$ 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.
$ post
Esta propiedad almacena, bueno, el post actual.
$ 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.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.
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.!