Aller au contenu
themeforge
FR
Commencer gratuitement
Menu
  1. Accueil
  2. Référence des attributs
  3. tax-loop
Essentiels Catégories

Une liste de lignes propre à chaque catégorie

tax-loop="Nom du champ"

« Coffee » a trois faits courts, « Kitchen » en a cinq. tax-loop fait d’une telle liste un champ de catégorie : le client ajoute et supprime les lignes sur la catégorie elle-même, et l’apparence d’une ligne reste la vôtre.

Où le placer

Sur le bloc des lignes dans archive.html : tax-loop="Category highlights". La première ligne sert de modèle ; les champs qu’elle contient sont des fld-text, des fld-image et d’autres champs ordinaires, et ils deviennent les champs de la ligne.

Tout fonctionne comme fld-loop, sauf que la liste vit sur la catégorie.

Le champ n’apparaît dans l’administration que si la page a un nom de groupe : wp-fields-group sur son <body>.

Exemple : des faits courts sur une catégorie

Balisage archive.html
<header class="category">
  <h1 wp="term-title">Coffee</h1>
  <ul class="category__facts" tax-loop="Category highlights">
    <li fld-text="Highlight">Roasted on Mondays</li>
    <li fld-text="Highlight">Beans from three farms</li>
  </ul>
</header>
Dans l’administration Posts → Categories → Coffee
Name Coffee
Category highlights
1
Highlight Roasted on Mondays
2
Highlight Beans from three farms
3
Highlight Decaf on request
Add Row
Sur le site la page de la catégorie
Coffee

Roasted on Mondays

Beans from three farms

Decaf on request

Le client a ajouté la troisième ligne sur la catégorie ; elle n’était pas dans le balisage.

À retenir

  • La liste apparaît sur toutes les catégories et étiquettes, chacune avec ses propres lignes.
  • Les lignes du balisage ne sont qu’un modèle : « Charger les données » ne remplit pas les listes des catégories.
  • Si une catégorie n’a aucune ligne, le bloc de la liste ne s’affiche pas sur sa page.

Erreurs fréquentes

Le journal de génération est l’onglet « Journaux » de votre projet sur themeforge.pro ; la vérification gratuite du balisage affiche les mêmes remarques.

À éviter
<ul tax-loop="Category highlights">
  <li class="deco"></li>
  <li fld-text="Highlight">Roasted on Mondays</li>
</ul>

Un élément sans champs avant les lignes : le suivant devient le modèle, et cet élément n’arrive pas sur le site. La génération le signale dans le journal.

Correct
<ul tax-loop="Category highlights">
  <li fld-text="Highlight">Roasted on Mondays</li>
</ul>

La décoration se place hors de la liste.

À éviter
<ul fld-loop="Category highlights">
  <li fld-text="Highlight">Roasted on Mondays</li>
</ul>

fld-loop sur la page d’une catégorie est une liste de la page ou de l’article, pas de la catégorie : la catégorie n’aura pas de lignes propres. Le journal ne signale rien.

Correct
<ul tax-loop="Category highlights">
  <li fld-text="Highlight">Roasted on Mondays</li>
</ul>

tax-loop est la liste de la catégorie elle-même.

Format alternatif

t_loop fonctionne de la même façon : la génération donne un thème identique.

Prêt quand vous l’êtes

Découvrez l’administration WordPress de votre site avant de payer.