JetBlog : pourquoi query_by casse le filtrage par catégorie

Écran affichant la configuration d'un widget JetBlog et le filtrage par catégorie sur WordPress

Vous configurez un widget JetBlog de Crocoblock, vous sélectionnez vos catégories, vous enregistrez — et la grille continue d’afficher n’importe quels articles du site. Ou pire : elle reste vide.

Le coupable est un réglage que l’interface ne met pas en avant : le paramètre query_by. Tant qu’il n’est pas sur la bonne valeur, JetBlog ignore purement et simplement les catégories que vous avez choisies.

Sommaire

Le symptôme

Sur une page d’accueil type magazine, vous avez une dizaine de blocs JetBlog, un par thématique : SEO, WordPress, Réseaux sociaux, Email marketing, etc. Chaque bloc doit afficher les derniers articles de sa catégorie.

Ce que vous obtenez :

  • tous les blocs affichent les mêmes articles, les plus récents du site, sans distinction de catégorie ;
  • ou bien certains blocs sont vides alors que la catégorie contient des articles ;
  • la sélection de catégories est pourtant bien enregistrée et visible quand vous rouvrez le widget.

La cause : query_by reste sur « all »

Le widget JetBlog possède un réglage de source de contenu qui détermine comment la requête est construite. Il accepte quatre valeurs :

ValeurComportement
allTous les articles du site. Les catégories sélectionnées sont ignorées.
categoryFiltre par catégories — c’est la valeur attendue.
post_tagFiltre par étiquettes.
idsListe d’identifiants d’articles précis.

Le piège est que l’interface vous laisse choisir des catégories même quand la source est sur all. Vous cochez, ça s’enregistre, et ça ne sert à rien. Aucun message d’erreur, aucun avertissement.

C’est particulièrement fréquent sur les sites partis d’un kit de démonstration : les widgets arrivent préconfigurés avec des identifiants de catégories de la démo, et une source laissée sur all.

La correction

  1. Ouvrir la page dans Elementor et sélectionner le widget JetBlog concerné.
  2. Dans l’onglet Content, repérer le réglage de source de requête et le passer explicitement sur Category.
  3. Resélectionner les catégories voulues — et vérifier que ce sont bien les identifiants de vos catégories, pas celles héritées de la démo.
  4. Mettre à jour la page.
  5. Purger les caches (le widget JetBlog est particulièrement sensible au cache de l’élément Elementor, voir notre article sur le sujet).

Si vous intervenez par script ou par import plutôt qu’à la main, le réglage attend la chaîne 'category' et la liste de catégories attend un tableau de chaînes, pas d’entiers — un tableau d’entiers est accepté silencieusement et ne filtre rien.

Le second piège : les catégories parentes comptent zéro article

Deuxième surprise, qui fait croire à tort que des catégories sont vides.

Dans WordPress, le compteur d’articles d’une catégorie ne compte que les articles directement rattachés à elle. Les articles de ses sous-catégories ne sont pas comptés.

Conséquence sur une architecture en silo : vos catégories piliers affichent 0 article alors que leurs sous-catégories en contiennent des dizaines. Si vous filtrez un widget JetBlog uniquement sur la catégorie parente, il ressort vide.

La solution : ne filtrez jamais sur la seule catégorie parente. Passez au widget la catégorie parente et l’ensemble de ses descendantes. Sur une arborescence profonde, cela veut dire parcourir récursivement l’arbre des catégories pour construire la liste complète des identifiants d’une « famille ».

Et avant de conclure qu’une catégorie est vide : vérifiez toujours le compte de ses enfants, pas seulement le sien. C’est une erreur de diagnostic classique qui conduit à supprimer des catégories parfaitement utilisées.

Vérifier que la correction est passée

Une fois le réglage corrigé, le widget peut continuer d’afficher l’ancien contenu. Ce n’est pas que la correction a échoué : c’est le rendu qui est en cache. Déroulez la séquence : Elementor → Outils → « Effacer les fichiers et les données », puis purge complète du plugin de cache, puis purge du cache objet, et enfin vérifiez le réglage « Cache de l’élément » dans les réglages de performance d’Elementor.

Ce n’est qu’après ces quatre étapes que vous pouvez affirmer que le filtrage ne fonctionne toujours pas.

À retenir

  • Sélectionner des catégories ne suffit pas : la source de requête doit être sur Category.
  • Les kits de démonstration laissent des identifiants de catégories qui n’existent plus chez vous.
  • Une catégorie parente affiche 0 article par construction : incluez ses descendantes.
  • Un widget qui n’a pas changé après correction est presque toujours un problème de cache, pas de réglage.

Pour aller plus loin : les 4 niveaux de cache Elementor, bien choisir ses plugins WordPress et le guide complet WordPress.

Sources et références