Attributs produit globaux : installation et aide

Importez le ZIP dans Modules > "Module Manager" et installez-le. Ouvrez "Improve" > Global Attributes > Modèles.

Préparez les groupes d'attributs et les valeurs natifs dans la section "Attributes & Features" de PrestaShop. Utilisez une petite famille de produits de test pour la première synchronisation. Sauvegardez la base de données avant de remplacer des déclinaisons existantes.

Ce module génère de véritables déclinaisons PrestaShop. Il conserve un instantané des déclinaisons existantes du marchand avant de les remplacer et peut les restaurer lorsque le produit n'est plus géré par le module. Vérifiez les stocks, les références et les prix obtenus sur le premier produit avant d'appliquer un modèle à grande échelle.

Ouvrez Global Attributes > Paramètres > Configuration.

Ces exclusions s'appliquent en plus du sélecteur de produits propre au modèle. Un produit peut correspondre à un modèle tout en étant exclu ici de la synchronisation.

L'ancien commutateur "Dynamic storefront options" n'est pas proposé dans ce formulaire de configuration. Utilisez le processus de déclinaisons natives décrit ci-dessous.

Créez un modèle et ouvrez Configuration.

Faites glisser les pastilles des groupes sélectionnés pour définir leur ordre. L'éditeur utilise cet ordre pour la structure des options générées et leur présentation sur la page produit. Le sélecteur de groupes lit les groupes d'attributs natifs existants ; il ne remplace pas la gestion des attributs du catalogue de PrestaShop.

Ouvrez Valeurs. Les valeurs de chaque groupe sélectionné apparaissent dans un tableau. L'ordre initial normal suit celui des valeurs natives ; utilisez les commandes de classement de l'éditeur si vous avez besoin d'un ordre différent.

Définissez Suffixe de référence du groupe pour un groupe et Suffixe de référence pour ses valeurs. Des suffixes automatiques sont générés à partir des noms lorsqu'aucun suffixe personnalisé n'est fourni. Définissez une valeur Par défaut par groupe. La première valeur est la valeur par défaut initiale.

Dans Changement de prix, choisissez un pourcentage ou un montant fixe dans la devise sélectionnée. Les nouvelles règles de valeur utilisent un pourcentage nul par défaut. Les montants fixes utilisent la devise de la boutique par défaut, sauf si vous en sélectionnez une autre. La conversion de devise est appliquée lors de la synchronisation.

Un pourcentage est un impact sur le prix calculé à partir du prix de base. Par exemple, une règle de 15 pour cent ajoute 15 pour cent de la base concernée, tandis qu'une règle fixe de 20 ajoute le montant converti. Les impacts des valeurs sélectionnées sont additionnés, sauf si un remplacement pour une déclinaison exacte remplace cette somme.

Vous pouvez sélectionner plusieurs valeurs et utiliser Définir le prix pour appliquer un changement de prix commun. Vérifiez ensuite les lignes individuellement.

Ouvrez Déclinaisons avant la synchronisation.

Les ensembles exacts sont identifiés par les identifiants d'attributs natifs triés. Une clé enregistrée peut ressembler à 12-31-44 ; elle identifie cet ensemble exact de choix et non un identifiant de produit.

Les suffixes de référence sont nettoyés. Les formes de suffixes prises en charge comprennent par exemple BLK, -XL, .MAT et OAK_120. Avec la référence de base du produit CHAIR-A et la chaîne de suffixes applicable BLK, XL, la forme obtenue est CHAIR-A-BLK-XL. Les suffixes de groupe et tout remplacement de déclinaison influencent également la référence finale ; confirmez-la donc dans l'aperçu.

Les abréviations automatiques comprennent BLACK en BLK, WHITE en WHT, SILVER en SLV, NATURAL en NAT et OAK en OAK.

La limite de synchronisation est de 500 déclinaisons générées par produit. Si la matrice prévue dépasse cette limite, le module enregistre une erreur et ignore la génération pour ce produit. Réduisez les groupes ou les valeurs choisis avant de réessayer.

Ouvrez Produits. Utilisez les sélecteurs de produits et les exclusions pour cibler les articles souhaités du catalogue. Les méthodes de sélection disponibles peuvent comprendre les produits sélectionnés, les catégories, les fabricants, les caractéristiques, les attributs, le stock et le prix.

Un sélecteur enregistré vide s'applique largement aux produits éligibles. Pour un premier test, sélectionnez explicitement un produit. Les exclusions globales des produits virtuels et des identifiants restent applicables.

Pour une configuration développeur basée sur les catégories, les données du sélecteur peuvent prendre cette forme :

{
  "products":{
    "groups":[{"include":{"method":"by_category","values":[3,8]}}],
    "excludes":[{"method":"specific","values":[42]}]
  }
}

Cela cible les catégories 3 et 8 tout en excluant le produit 42. Remplacez les identifiants d'exemple et confirmez l'aperçu des produits correspondants au lieu de modifier directement le JSON enregistré.

Si des modèles se chevauchent, examinez les informations de ciblage et d'attribution. Un seul modèle effectivement responsable contrôle la structure des déclinaisons générées d'un produit ; ne supposez pas que les modèles qui se chevauchent seront fusionnés.

Le remplacement des déclinaisons existantes est activé pour les modèles groupés. Il s'agit d'un comportement interne du modèle, pas d'un commutateur ordinaire dans l'éditeur groupé. Le module conserve un instantané afin de pouvoir restaurer le produit lorsqu'il n'est plus géré.

Enregistrez le modèle. Le module met la synchronisation en file d'attente. La page d'administration peut traiter la tâche par AJAX tant qu'elle reste ouverte. Suivez dans le panneau de synchronisation la progression et les nombres d'éléments créés, actualisés, supprimés, ignorés et en erreur.

Un enregistrement plus récent peut remplacer une tâche plus ancienne en attente. Si le panneau indique qu'une tâche a été remplacée, suivez la plus récente au lieu de relancer celle devenue obsolète.

Pour le traitement en arrière-plan après la fermeture de la page, copiez l'URL cron depuis Paramètres > Configuration > Synchronisation en arrière-plan dans le planificateur de votre hébergement. Utilisez l'URL générée, car sa route et son jeton dépendent de la boutique.

Un équivalent sans réécriture prend cette forme :

https://yourshop.example/index.php?fc=module&module=mprglobalattributes&controller=cron&token=YOUR_TOKEN&jobs=3&batch=5

Le point d'accès renvoie du JSON. Une réponse valide comprend success, processed_jobs et results. Un jeton incorrect renvoie HTTP 403. Le panneau d'arrière-plan affiche Dernier appel, Dernier succès, Total des appels, Jobs traités au dernier appel, Jobs en attente et toute Dernière erreur. Un appel cron fonctionnel ne signifie pas que tous les produits en attente ont été traités ; vérifiez également les tâches en attente.

Après la synchronisation, ouvrez le produit cible dans le back-office. L'avertissement concernant les déclinaisons gérées indique que Global Attributes contrôle ses déclinaisons. Des protections sur les routes d'administration empêchent les modifications manuelles des déclinaisons tant que le produit est géré.

Dans la boutique, vérifiez l'ordre des groupes, les valeurs par défaut sélectionnées, les déclinaisons disponibles, le prix affiché, la référence, le comportement du stock et l'ajout au panier. Il s'agit de déclinaisons natives PrestaShop et non d'un processus distinct de personnalisation du panier.

Si des lignes de variantes du module sont présentes, le CSS du thème peut les cibler :

.mpr-ga-front-option { margin-bottom: 1rem; }
.mpr-ga-front-choice-list { display: flex; flex-wrap: wrap; gap: .5rem; }
.mpr-ga-front-choice.is-disabled { cursor: not-allowed; opacity: .45; }

Pour revenir à la gestion manuelle des déclinaisons, retirez le produit des cibles effectives du modèle et laissez la synchronisation terminer la restauration de son état. Vérifiez la restauration avant de modifier manuellement les déclinaisons.

Si aucun produit n'est traité, vérifiez Actif du modèle, le sélecteur de produits enregistré, les exclusions globales et l'attribution du modèle. Les produits virtuels sont exclus par défaut.

Si la tâche reste en attente, gardez l'éditeur ouvert pour la traiter ou vérifiez l'URL cron et le statut de son dernier appel. En cas d'échec, lisez l'erreur signalée avant d'enregistrer à nouveau. Une matrice dépassant 500 nécessite un ensemble d'options plus réduit.

Si les prix diffèrent du montant prévu, vérifiez si la règle est un pourcentage ou un montant fixe, sa devise et tout remplacement de déclinaison exacte. L'aperçu permet de confirmer le choix final de la règle avant une synchronisation à grande échelle.

Si les modifications manuelles sont bloquées, vérifiez si le produit est toujours attribué à un modèle. Ne contournez pas la protection : la prochaine synchronisation peut écraser les modifications directes.

Ouvrez Paramètres > "Integrity" pour vérifier les tables du module et l'installation. Les grandes matrices natives créent toujours de véritables déclinaisons et nécessitent une planification du catalogue ; le module ne supprime pas cette charge de travail sous-jacente.

Sauvegardez la base de données et attendez la fin des traitements actifs. La désinstallation appelle d'abord le service qui restaure l'état des produits gérés, puis supprime les entrées de menu du module, les préférences, la configuration et le schéma du module. Vérifiez des produits représentatifs après la désinstallation pour confirmer que leurs déclinaisons d'origine et leur état de stock ont été restaurés.

Nécessite PrestaShop 1.6.1 ou une version ultérieure et PHP 7.1 ou une version ultérieure.