Documentation

Modèles de secteur et détection

Les modèles qui définissent les champs d'un passeport par secteur, comment un produit est rattaché à l'un d'eux, comment le changer à la main, et pourquoi chaque secteur est livré dans le plugin gratuit.

Les champs d'un passeport ne sont pas figés : ils viennent d'un modèle, un par secteur, et les actes délégués du règlement définiront un jeu de données différent pour chaque groupe de produits. DPTag garde les modèles en configuration, pour qu'un nouvel acte ou un nouveau secteur soit une mise à jour de modèle et non une réécriture, et chaque modèle est livré dans le plugin gratuit.

Les modèles aujourd'hui

ModèleLibellé dans l'administrationChamps
textileTextile et habillement12 champs en 5 groupes, listés ici
furnitureAmeublement14 champs en 5 groupes, listés ici

Le premier modèle enregistré est celui par défaut : un produit qui ne correspond à rien reçoit le modèle textile. Les secteurs ne sont jamais une fonction payante. Chaque nouveau modèle, batteries ou matelas par exemple, est livré dans le plugin gratuit sur wordpress.org dès qu'il est écrit, parce que réserver un secteur exclurait les boutiques de ce secteur au lieu de les servir.

Comment un produit est rattaché à un secteur

Chaque modèle déclare des signaux de détection de trois sortes, et un produit est noté contre chaque modèle de votre site, sans aucun appel réseau :

SignalComparé avecPoids
Mots de catégorieLes noms et les slugs des catégories du produit4 par correspondance
Noms d'attributLes noms des attributs WooCommerce du produit2 par correspondance
Mots-clésLe nom, la description courte et la description du produit1 par correspondance

La comparaison ignore la casse et les accents, et chaque signal ne compte qu'une fois quel que soit son nombre d'occurrences. Le modèle au score le plus haut l'emporte ; tous les scores à zéro, c'est le modèle par défaut. Les signaux sont en français et en anglais, « vêtement », « clothing », « chaise », « chair » et ainsi de suite, et une correspondance de catégorie pèse plus que deux mots-clés à dessein : les catégories d'une boutique disent ce qu'est un produit plus sûrement que les mots de sa description.

La détection tourne à la création d'un passeport. Elle décide aussi, sur un échantillon des cent produits les plus récents, quel secteur l'assistant de configuration montre en premier et vers quel secteur penche chaque catégorie.

Changer le secteur d'un passeport

Le secteur d'un passeport est affiché dans son éditeur et s'y change. Le changer redessine le formulaire avec les champs de l'autre modèle. Les valeurs dont la clé de champ existe dans les deux modèles, la composition, le pays d'origine ou les consignes de recyclage par exemple, sont reprises ; le reste reste stocké mais n'est pas affiché tant que le passeport ne revient pas sur un modèle qui a le champ.

Le secteur choisit aussi quelles valeurs par défaut s'appliquent, puisque les valeurs se fixent par modèle dans Passeports, puis Valeurs par défaut.

Ce que contient un modèle

Pour chaque champ, un modèle donne son libellé, son type, s'il est obligatoire, un texte d'aide facultatif, et s'il peut porter une valeur par défaut. Les types sont :

  • texte, une ligne ;
  • zone de texte, plusieurs lignes de prose, traduisibles ;
  • pays, un nom de pays ;
  • nombre, une valeur numérique, composée en chasse fixe sur la page publique ;
  • matières, la liste de matières avec pourcentages qui dessine la barre de composition.

Les champs obligatoires sont ceux que compte le score de complétude. Un champ marqué comme non défaultable, le numéro de lot, est par nature propre à un article et n'est jamais proposé sur les écrans de valeurs par défaut.

Les modèles peuvent être étendus par un autre plugin via un filtre, décrit sur la page des hooks.