Modal de prévisualisation — aperçu du bloc dans la modal
PreviewModal — une modal commune à tous les écrans de configuration Wave-2, qui montre le résultat du bloc en temps réel. Elle s'ouvre avec le bouton « Ouvrir dans la modal » sur les écrans de configuration.
Pourquoi est-ce nécessaire
Lorsque vous configurez un bloc (stratégie, filtres, audience) — vous souhaitez immédiatement comprendre quels produits seront affichés avec ces paramètres. PreviewModal permet de vérifier cela sans publier le bloc sur le site et sans basculer entre l'admin et le front.
Onglet Basique — liste des produits
Le premier onglet — Basique. Il montre un tableau de produits que l'API renverra avec les paramètres actuels du bloc :
- Le chargement se fait par infinite scroll via le composant
NewBlockPreviewTable. - Dans le tableau — aperçu des cartes (nom, image, étiquette, métadonnées succinctes).
- La liste se met à jour automatiquement lors de la modification des paramètres du bloc sur l'écran parent.
Onglet Investiguer — diagnostic
Le deuxième onglet — Investiguer — est nécessaire pour le débogage. Ici, vous pouvez voir ce qui s'est passé « sous le capot » lors de la génération des résultats :
| Champ | Que signifie |
|---|---|
| appliedAudienceRule | Quelle règle d'audience a été appliquée pour la requête actuelle. Voir Filtre d'audience. |
| warnings | Diagnostic — par exemple, « l'ensemble des attributs est vide », « le fallback a sélectionné des produits en dehors de la catégorie choisie ». |
| fallbackUsed | Indicateur : le chemin de fallback a-t-il été activé (affichage de produits tendance par défaut). |
| contextEcho | Écho du contexte de la requête — ce que le système a réellement reçu (ID utilisateur, panier, catégories choisies, etc.). |
Si le backend n'a pas renvoyé un champ, la section correspondante d'Investiguer est simplement masquée, sans erreurs. Cela a été fait pour un développement sans douleur de l'API.
ID utilisateur simulé — aperçu « au nom » de l'utilisateur
Sous le champ Prévisualisation, il y a un champ ID utilisateur simulé. Entrez l'ID de n'importe quel utilisateur — la prévisualisation construira le résultat comme si la requête venait de lui. Pratique pour :
- Vérifier les recommandations personnalisées (Recommandations personnelles, Achat répété) pour un client spécifique ;
- Reproduire une plainte du type « je n'ai pas les bons produits dans le bloc » — entrez son ID et voyez ce qu'il verra.
Sans spécification de l'ID utilisateur simulé, la prévisualisation utilise votre propre contexte d'admin, et pour les blocs personnalisés, les résultats peuvent être vides ou non pertinents.
Droit d'accès blocks.preview
L'accès à l'endpoint admin de prévisualisation du bloc est contrôlé par un droit distinct blocks.preview dans l'arbre des droits.
Cela permet :
- D'attribuer un rôle qui édite des blocs, sans accès à la prévisualisation (par exemple, pour les gestionnaires de contenu « uniquement formulaire »).
- De cacher aux certains admins des données sensibles qui pourraient être révélées via Investiguer (contexte de la requête, écho des paramètres).
Pour les développeurs et QA — donnez toujours blocks.preview. Pour les gestionnaires de contenu — seulement s'ils doivent voir les résultats réels du bloc avant publication.