Aller au contenu principal

FAQ & dépannage

Réponses rapides aux questions qui reviennent le plus souvent.


Installation & configuration

Vertex nécessite-t-il un plan Shopify Plus ou Advanced ?

Non. Vertex s'installe sur tous les plans Shopify. Cependant, les fonctionnalités B2B natives (entreprises, catalogues B2B, conditions NET, exonération de taxes, multi-sites) nécessitent Shopify Plus ou Advanced avec le module B2B. Sans cela, Vertex fonctionne toujours comme un thème B2C de fourniture industrielle soigné — chaque fonctionnalité B2B se dégrade harmonieusement.

Ai-je besoin d'applications complémentaires ?

Non. Vertex utilise les fonctionnalités B2B natives de Shopify de bout en bout. Pas d'application de gestion de devis, pas d'application de tarification grossiste, pas d'application multi-devise, pas d'application de comparaison.

Combien de temps prend l'installation complète ?

  • Installation basique (thème uniquement) : 5 minutes
  • Installation B2B complète (thème + B2B natif + entreprises + catalogues + métachamps) : 45 à 60 minutes la première fois. Les entreprises suivantes prennent 5 minutes chacune.

Puis-je utiliser Vertex sur une boutique de développement d'abord ?

Oui. Installez Vertex sur n'importe quelle dev store et personnalisez sans affecter votre vitrine en direct. Publiez seulement quand vous êtes prêt.


Visibilité du chrome B2B

Pourquoi la barre d'accueil B2B ambrée n'apparaît-elle pas ?

Par ordre de probabilité :

  1. Vous n'êtes pas connecté en tant que client B2B. La barre ne s'affiche que lorsque customer.b2b? est vrai ET que customer.current_company est défini.
  2. Le mode Storefront est défini sur B2C uniquement. Ouvrez Theme settings ▸ B2B ▸ Storefront mode et changez vers Hybride (auto) ou B2B uniquement.
  3. Le B2B natif n'est pas activé dans l'admin Shopify. Allez dans Settings ▸ Customer accounts ▸ B2B ▸ Manage ▸ Enable B2B.
  4. L'entreprise de l'acheteur a été supprimée ou révoquée. Vertex passe défensivement la barre quand customer.current_company est nul en cours de session.

Pourquoi la pilule commercial n'apparaît-elle pas dans l'en-tête ?

La pilule commercial ne s'affiche que lorsque les trois conditions sont vraies :

  1. L'acheteur est connecté en B2B (customer.b2b? == true)
  2. L'entreprise de l'acheteur a un métachamp vertex.rep_name défini
  3. Le mode Storefront n'est pas B2C uniquement

Vérifiez sous Customers ▸ Companies ▸ [Company name] ▸ Metafields que vertex.rep_name est populé.

Pourquoi les paliers de tarification par volume ne s'affichent-ils pas sur la PDP ?

Vertex lit les paliers de volume depuis le quantity_price_breaks natif de Shopify. Le tableau de volume sur la PDP s'affiche seulement quand :

  1. L'acheteur est connecté à une entreprise
  2. L'entreprise est attribuée à un catalogue B2B
  3. La liste de prix du catalogue inclut le produit avec des paliers de tarification basés sur la quantité

Si le tableau est vide, revérifiez la liste de prix dans B2B ▸ Catalogs ▸ [Catalog name] ▸ Price list.

Pourquoi mon acheteur B2B voit-il « Connectez-vous pour voir la tarification » même s'il est connecté ?

La bascule Theme settings ▸ B2B ▸ Hide prices until customer logs in est activée. Cette fonctionnalité masque les prix pour les invités uniquement. Les clients connectés (B2C OU B2B) doivent toujours voir les prix. S'ils ne les voient pas, désactivez le paramètre et enregistrez.

Pourquoi la vitrine se sent-elle « B2C » même si je suis connecté en tant que B2B ?

Soit :

  1. Le mode Storefront est défini sur B2C uniquement. Changez-le vers Hybride ou B2B uniquement.
  2. L'enregistrement client n'est pas lié à une entreprise. Ouvrez Customers ▸ [Customer name] et confirmez qu'il est rattaché à une entreprise sous l'onglet Companies.

Personnalisation

Comment changer la couleur de marque ?

  1. Ouvrez Theme settings ▸ Colors
  2. Choisissez une Starter color palette pour une recoloration en un clic, OU sélectionnez Custom et redéfinissez chaque couleur individuellement

Comment ajouter une police personnalisée ?

Les sélecteurs de police sous Theme settings ▸ Typography utilisent la bibliothèque de polices Shopify. Pour utiliser une police en dehors de celle-ci, ajoutez un <link> dans theme.liquid et mettez à jour les propriétés CSS custom --font-body / --font-heading.

Comment ajouter mon logo ?

  1. Ouvrez l'éditeur de thème et cliquez sur Header dans le panneau des sections
  2. Cliquez sur Logo image et téléversez votre fichier
  3. Hauteur recommandée : ~40 px ; SVG préféré

Comment personnaliser le texte de la barre d'annonce ?

  1. Ouvrez Header group ▸ Announcement bar dans l'éditeur de thème
  2. Modifiez le champ Text
  3. La barre a un × dismissible intégré qui respecte localStorage

Comment ajouter/modifier la navigation secondaire (Offres spéciales / Guides / Services / FAQ) ?

  1. Allez dans Online Store ▸ Navigation
  2. Créez un nouveau menu avec le handle secondary-menu (auto-détecté par Vertex)
  3. Ajoutez des liens — ils apparaissent alignés à droite dans l'en-tête desktop

Comment basculer entre les 4 vitrines de démonstration (Vertex / Throttle / OfficeIT / Inkline) ?

Deux façons :

  1. Recoloration permanenteTheme settings ▸ Colors ▸ Starter color palette — choisissez l'un des 4 presets
  2. Aperçu temporaire — ajoutez ?view=throttle (ou officeit / printsupply) à n'importe quelle URL sur votre vitrine

→ Voir Guide des presets de démonstration pour les détails.


Performance

Quel est le score Lighthouse d'une vitrine Vertex ?

Enregistré sur la démo showcase :

  • Performance mobile : 65–100 (selon le type de page)
  • Performance desktop : 90+ sur chaque page
  • Accessibilité : 92–95
  • Best Practices : 95+
  • SEO : 100

Comment améliorer encore la Performance Lighthouse ?

  1. Optimisez les images hero. Utilisez WebP à plusieurs largeurs ; visez moins de 300 Ko par diapositive.
  2. Limitez le hero à 1 diapositive. Les rotateurs hero multi-diapositives coûtent en LCP. Le défaut livre 1 diapositive.
  3. Limitez les app embeds Shopify. Chaque app tierce injecte du JS — chacun s'ajoute au TBT.

Pourquoi ma Performance mobile est-elle plus basse que ma Performance desktop ?

Standard pour les thèmes Shopify — le mobile est bridé dans Lighthouse (CPU plus lent + réseau plus lent). Les vrais utilisateurs iPhone 14 / Galaxy S22 obtiennent des scores bien meilleurs que le chiffre Lighthouse.


Accessibilité & internationalisation

Vertex est-il conforme WCAG 2.1 AA ?

Oui. Navigation au clavier, focus visible, contraste minimum 4,5:1, cibles tactiles 24 px sur mobile, rôles ARIA appropriés, lien skip-to-content, inputs de formulaire étiquetés.

Avec quelles langues Vertex est-il livré ?

5 : Anglais (par défaut), Français, Italien, Allemand, Espagnol. Les chaînes UI + étiquettes de schéma sont toutes deux traduites.

Vertex prend-il en charge les langues RTL ?

Oui — pleinement. <html dir> bascule automatiquement pour l'arabe, l'hébreu, le farsi, l'ourdou, le yiddish, le kurde, le divehi et le pachto. Le CSS utilise des propriétés logiques pour que la mise en page se reflète proprement.

Puis-je ajouter une autre langue ?

Oui. Traduisez locales/en.default.json vers votre langue cible, enregistrez en tant que locales/{code}.json. Les étiquettes de schéma vivent dans locales/en.default.schema.json — traduisez vers locales/{code}.schema.json pour localiser également l'UI de l'éditeur.


Métachamps & données produit

Quels métachamps utilise Vertex ?

Dans l'espace de noms vertex :

  • vertex.mpn (produit) — Manufacturer Part Number, indexé dans la recherche prédictive
  • vertex.ships_from (produit) — Ville d'expédition par produit
  • vertex.price_history (produit) — Liste JSON d'entrées {date, price}
  • vertex.datasheet, vertex.msds, vertex.brochure, vertex.tech_sheet, vertex.install_guide, vertex.warranty (produit) — sélecteurs de fichier pour PDFs
  • vertex.rep_name, vertex.rep_email, vertex.rep_phone (entreprise) — Commercial par entreprise
  • vertex.payment_terms (entreprise) — Surcharge de l'étiquette du badge conditions NET

Plus un metaobject tech_spec_row (liste, attaché au produit) pour le tableau de spécifications techniques.

→ Référence complète : Guide de configuration des métachamps.

Que se passe-t-il si un métachamp est absent ?

Le bloc PDP correspondant se masque automatiquement. Vertex est défensif face aux métachamps absents — les valeurs vides ne rendent jamais une UI cassée.


Tarification & licences

Combien coûte Vertex ?

399 USD licence boutique unique. Inclut les mises à jour gratuites pour toutes les versions v1.x.

Puis-je utiliser une licence Vertex sur plusieurs boutiques ?

Non — la licence standard du Theme Store est boutique unique. Pour les licences multi-boutiques, ouvrez un ticket via le portail de support du Theme Store.

Vertex recevra-t-il des mises à jour ?

Oui. Les versions v1.x incluent des corrections de bugs, des améliorations de performance et de nouvelles sections. Voir le Changelog.


Erreurs courantes & corrections

« Theme Check affiche 18 avertissements sur ma version personnalisée »

Vous avez probablement modifié des modèles Liquid et introduit des variables inutilisées ou des routes en dur. Exécutez shopify theme check localement pour voir les détails. Vertex lui-même est livré à 0 offense Theme Check.

« Mon CSS personnalisé est écrasé »

Les fichiers CSS par section de Vertex ont une spécificité plus élevée qu'une feuille de style générique. Ajoutez des surcharges via :

  1. Theme settings ▸ Colors ▸ Custom (préféré — la plupart des choses sont pilotées par variables CSS)
  2. CSS personnalisé dans assets/vertex.css après les règles existantes
  3. Un nouveau assets/custom-overrides.css avec !important (dernier recours)

Toujours bloqué ?