Dans certains cas, vous devrez peut-\u00eatre modifier la requ\u00eate de publication globale que WordPress ex\u00e9cute sur n’importe quelle page que vous visitez – \u00e0 la fois admin et frontend. Dans ce guide, nous verrons quel crochet utiliser et comment modifier les arguments de la requ\u00eate \u00e0 votre guise.<\/p>\n
Vous devez d’abord savoir \u00e0 quel crochet ajouter votre code. Nous avons besoin d’un crochet qui se produit juste apr\u00e8s que WordPress a configur\u00e9 tous les arguments, mais avant que la requ\u00eate r\u00e9elle ne soit ex\u00e9cut\u00e9e. Pour cela, nous utilisons l’action Dans ce crochet, vous obtenez un param\u00e8tre\u00a0; qui est un La modification de la requ\u00eate n\u00e9cessite tr\u00e8s probablement que vous utilisiez des balises conditionnelles pour sp\u00e9cifier les cas que vous souhaitez modifier. Par exemple, vous pouvez cibler la requ\u00eate uniquement dans les r\u00e9sultats de recherche ou les vues de cat\u00e9gorie.<\/p>\n WordPress a un tas de balises conditionnelles<\/a> que vous pouvez utiliser pour sp\u00e9cifier les cas dans lesquels vous souhaitez ajouter votre code. Une balise conditionnelle est simplement une fonction qui renvoie vrai ou faux en fonction de l’\u00e9tat dans lequel se trouve WordPress. Des exemples de balises conditionnelles courantes permettent Gardez \u00e0 l’esprit que le hook Les balises conditionnelles sont excellentes et tout, mais il y a certaines choses \u00e0 garder \u00e0 l’esprit lorsque vous les utilisez \u00e0 l’int\u00e9rieur de Tout d’abord, vous devez vous familiariser avec la balise Deuxi\u00e8mement, vous devez \u00eatre conscient des cas o\u00f9 vous devez v\u00e9rifier les balises conditionnelles sur l’objet fourni au lieu d’appeler la fonction "ind\u00e9pendamment". Habituellement, lorsque vous utilisez des balises conditionnelles, vous l’\u00e9crivez comme ceci\u00a0:<\/p>\n Cependant, lors de l’utilisation Vous devez toujours v\u00e9rifier Ceci est un exemple de v\u00e9rification si nous ne sommes pas en admin, et si nous sommes \u00e0 la requ\u00eate de publication principale\u00a0:<\/p>\n Puisque nous travaillons avec un Vous utilisez la Dans les cas o\u00f9 vous souhaitez ajouter ou modifier un argument pr\u00e9existant, vous le ferez g\u00e9n\u00e9ralement en enregistrant d’abord l’argument existant dans une variable. Vous pouvez utiliser la m\u00e9thode Voici un exemple rapide d’utilisation WordPress a des sous-classes distinctes pour g\u00e9rer la Les arguments que vous ajoutez ou modifiez d\u00e9pendent enti\u00e8rement de ce que vous voulez faire, mais vous devriez maintenant avoir un aper\u00e7u des strat\u00e9gies pour obtenir la requ\u00eate globale. Si vous avez besoin d’avoir un aper\u00e7u de l’ pre_get_posts<\/code>.<\/p>\nWP_Query<\/code>objet avec lequel WordPress ex\u00e9cutera plus tard la requ\u00eate. Vous apportez des modifications \u00e0 l’objet – mais vous n’avez pas besoin de le renvoyer car WordPress ex\u00e9cutera la requ\u00eate avec l’objet modifi\u00e9.<\/p>\nadd_action('pre_get_posts', function($query) {\n \/\/ Add your code here\n});<\/code><\/pre>\nBalises conditionnelles<\/h2>\n
is_admin()<\/code>de v\u00e9rifier si nous sommes actuellement en mode administrateur ou frontend, is_singular()<\/code>si nous sommes sur une seule publication ou page en frontend, et is_search()<\/code>si nous sommes \u00e0 la page des r\u00e9sultats de recherche.<\/p>\npre_get_posts<\/code>est ex\u00e9cut\u00e9 \u00e0 la fois pour l’administrateur et le frontend. Si vous souhaitez uniquement affecter la requ\u00eate globale en frontend, vous devez envelopper votre code dans un if-check sur la balise conditionnelle is_admin()<\/code>.<\/p>\nRemarque sur les balises conditionnelles dans
pre_get_posts<\/code><\/h3>\npre_get_posts<\/code>.<\/p>\nis_main_query()<\/code>. L’action pre_get_posts<\/code>est en fait ex\u00e9cut\u00e9e plusieurs fois pour chaque chargement de page. Par exemple pre_get_posts<\/code>est ex\u00e9cut\u00e9 lors de la g\u00e9n\u00e9ration de chaque menu (y compris ceux des widgets). Afin de modifier la requ\u00eate globale r\u00e9elle, par exemple les publications pour une archive de cat\u00e9gorie ou les r\u00e9sultats de recherche, vous devez cibler la "requ\u00eate principale" \u00e0 l’aide de is_main_query()<\/code>.<\/p>\nif (is_main_query()) {\n \/\/ Do stuff\n}<\/code><\/pre>\npre_get_posts<\/code>de, vous devez appliquer certaines balises conditionnelles \u00e0 l’objet. Par exemple:<\/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>l’objet fourni dans pre_get_posts<\/code>. Lisez la documentation de pre_get_posts<\/a> pour plus d’informations.<\/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>\nModification ou ajout d’arguments<\/h2>\n
WP_Query<\/code>objet, vous pouvez vous r\u00e9f\u00e9rer \u00e0 la documentation de WP_Query<\/a> pour savoir comment construire vos arguments pour personnaliser la requ\u00eate des publications. Gardez \u00e0 l’esprit que les arguments sont d\u00e9j\u00e0 renseign\u00e9s. Dans ce cas, vous devez ajouter ou modifier les valeurs existantes. Ou supprimez ceux que vous souhaitez supprimer.<\/p>\nset()<\/code>fonction sur l’ WP_Query<\/code>objet pour d\u00e9finir des arguments. La m\u00e9thode accepte deux arguments, la cl\u00e9 d’argument et deuxi\u00e8mement la valeur. Par exemple, la d\u00e9finition de l’ posts_per_page<\/code>argument se ferait comme ceci\u00a0:<\/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>pour cela. Ensuite, vous modifiez la variable, en ajoutant ou en fusionnant des tableaux ou autres. Et enfin, vous utilisez set()<\/code>pour remplacer la variable modifi\u00e9e sur l’objet de requ\u00eate. Je recommande d’utiliser var_dump()<\/code>sur l’objet pour voir ce qu’il contient, et c’est aussi un bon moyen de v\u00e9rifier si vos balises conditionnelles sont correctes.<\/p>\nget()<\/code>(en v\u00e9rifiant simplement s’il est vide), et si c’est le cas, ajoutez vos propres arguments avec 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>\nRemarque sur tax_query<\/h3>\n
WP_Tax_Query<\/code>partie taxonomie () dans WP_Query<\/code>. Si vous devez effectuer des modifications de requ\u00eate de taxonomie plus complexes, l’ pre_get_posts<\/code>action peut \u00eatre trop t\u00f4t. Certaines valeurs peuvent \u00eatre vides car elles sont renseign\u00e9es ult\u00e9rieurement. Dans ce cas, vous feriez peut-\u00eatre mieux d’utiliser l’action parse_tax_query<\/code>au lieu de pre_get_posts<\/code>. Lisez la documentation de ce crochet<\/a> pour voir si c’est pour vous.<\/p>\nConclusion<\/h2>\n
WP_Query<\/code>objet et de la fa\u00e7on d’utiliser ses arguments, mon article sur la fa\u00e7on d’interroger les publications<\/a> pourrait vous int\u00e9resser.<\/p>\n