En algunos casos, es posible que deba modificar la consulta de publicaci\u00f3n global que WordPress est\u00e1 realizando en cualquier p\u00e1gina que est\u00e9 visitando, tanto en el administrador como en la interfaz. En esta gu\u00eda, veremos qu\u00e9 enlace usar y c\u00f3mo cambiar los argumentos de consulta a su gusto.<\/p>\n
Primero necesita saber a qu\u00e9 gancho agregar su c\u00f3digo. Necesitamos un gancho que suceda justo despu\u00e9s de que WordPress haya configurado todos los argumentos, pero antes de que se ejecute la consulta real. Para esto usamos la acci\u00f3n En este gancho obtienes un par\u00e1metro; que es un La modificaci\u00f3n de la consulta probablemente requiera que use algunas etiquetas condicionales para especificar los casos en los que desea cambiarla. Por ejemplo, es posible que desee orientar la consulta solo en los resultados de b\u00fasqueda o en las vistas de categor\u00eda.<\/p>\n WordPress tiene un mont\u00f3n de etiquetas condicionales<\/a> que puede usar para especificar en qu\u00e9 casos desea agregar su c\u00f3digo. Una etiqueta condicional es simplemente una funci\u00f3n que devuelve verdadero o falso seg\u00fan el estado en el que se encuentre WordPress. Los ejemplos de etiquetas condicionales comunes son Tenga en cuenta que el enlace Las etiquetas condicionales son geniales y todo eso, pero hay algunas cosas que se deben tener en cuenta cuando se usan dentro de En primer lugar, debe familiarizarse con la etiqueta En segundo lugar, debe tener en cuenta los casos en los que necesita verificar las etiquetas condicionales en el objeto proporcionado en lugar de llamar a la funci\u00f3n "independientemente". Por lo general, cuando usa etiquetas condicionales, lo escribir\u00eda as\u00ed:<\/p>\n Sin embargo, al usar Siempre debe comprobar Este es un ejemplo de c\u00f3mo verificar si no estamos en administraci\u00f3n y si estamos en la consulta de publicaci\u00f3n principal:<\/p>\n Como estamos trabajando con un Utiliza la En los casos en los que desee agregar o cambiar un argumento preexistente, normalmente lo har\u00eda guardando primero el argumento existente en una variable. Puedes usar el m\u00e9todo Aqu\u00ed hay un ejemplo r\u00e1pido de uso WordPress tiene subclases separadas para manejar la parte de taxonom\u00eda ( Los argumentos que agrega o cambia dependen completamente de lo que desea hacer, pero ahora deber\u00eda tener una idea de las estrategias para obtener la consulta global. Si necesita obtener informaci\u00f3n sobre el pre_get_posts<\/code>.<\/p>\nWP_Query<\/code>objeto con el que WordPress luego ejecutar\u00e1 la consulta. Realiza cambios en el objeto, pero no necesita devolverlo ya que WordPress ejecutar\u00e1 la consulta con el objeto modificado.<\/p>\nadd_action('pre_get_posts', function($query) {\n \/\/ Add your code here\n});<\/code><\/pre>\nEtiquetas condicionales<\/h2>\n
is_admin()<\/code>para verificar si actualmente estamos en administraci\u00f3n o interfaz, is_singular()<\/code>si estamos en una sola publicaci\u00f3n o p\u00e1gina en interfaz, y is_search()<\/code>si estamos en la p\u00e1gina de resultados de b\u00fasqueda.<\/p>\npre_get_posts<\/code>se ejecuta tanto para el administrador como para la interfaz. Si solo desea afectar la consulta global en la interfaz, debe envolver su c\u00f3digo dentro de una verificaci\u00f3n if en la etiqueta condicional is_admin()<\/code>.<\/p>\nNota sobre las etiquetas condicionales en
pre_get_posts<\/code><\/h3>\npre_get_posts<\/code>.<\/p>\nis_main_query()<\/code>. La acci\u00f3n pre_get_posts<\/code>en realidad se ejecuta varias veces para cada carga de p\u00e1gina. Por ejemplo pre_get_posts<\/code>, se ejecuta al generar cada men\u00fa (incluidos los de los widgets). Para modificar la consulta global real, por ejemplo, publicaciones para un archivo de categor\u00eda o resultados de b\u00fasqueda, debe orientar la "consulta principal" usando is_main_query()<\/code>.<\/p>\nif (is_main_query()) {\n \/\/ Do stuff\n}<\/code><\/pre>\npre_get_posts<\/code>, hay algunas etiquetas condicionales que debe aplicar al objeto. Por ejemplo:<\/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>el objeto proporcionado en pre_get_posts<\/code>. Lea la documentaci\u00f3n de pre_get_posts<\/a> para obtener m\u00e1s informaci\u00f3n.<\/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>\nCambiar o agregar argumentos<\/h2>\n
WP_Query<\/code>objeto, puede consultar la documentaci\u00f3n de WP_Query<\/a> para saber c\u00f3mo crear sus argumentos para personalizar la consulta de publicaciones. Tenga en cuenta que los argumentos ya est\u00e1n poblados. En ese caso, debe agregar o cambiar los valores existentes. O elimine los que desee eliminar.<\/p>\nset()<\/code>funci\u00f3n en el WP_Query<\/code>objeto para establecer argumentos. El m\u00e9todo acepta dos argumentos, el argumento clave y en segundo lugar el valor. Por ejemplo, establecer el posts_per_page<\/code>argumento se har\u00eda as\u00ed:<\/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 esto. Luego modifica la variable, agregando o fusionando matrices o lo que sea. Y finalmente, usa set()<\/code>para reemplazar la variable modificada nuevamente en el objeto de consulta. Recomiendo usar var_dump()<\/code>en el objeto para ver qu\u00e9 contiene, y esta tambi\u00e9n es una buena manera de verificar si sus etiquetas condicionales son correctas.<\/p>\nget()<\/code>(simplemente verificando si est\u00e1 vac\u00edo), y si es as\u00ed, agregue sus propios argumentos con 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>\nNota sobre tax_query<\/h3>\n
WP_Tax_Query<\/code>) dentro de WP_Query<\/code>. Si necesita realizar modificaciones de consulta de taxonom\u00eda m\u00e1s complejas, es posible que la pre_get_posts<\/code>acci\u00f3n sea demasiado temprana. Algunos valores pueden estar vac\u00edos porque se completan m\u00e1s tarde. En este caso, es mejor que uses la acci\u00f3n parse_tax_query<\/code>en lugar de pre_get_posts<\/code>. Lea la documentaci\u00f3n de este gancho<\/a> para ver si esto es para usted.<\/p>\nConclusi\u00f3n<\/h2>\n
WP_Query<\/code>objeto y c\u00f3mo usar sus argumentos, mi publicaci\u00f3n sobre c\u00f3mo consultar publicaciones<\/a> podr\u00eda ser de su inter\u00e9s.<\/p>\n