Fonctionnalités

  • Implémente hook_commerce_product_update et hook_commerce_product_variation_update : chaque enregistrement part aussitôt sur Miravia
  • Lit des champs facultatifs que vous ajoutez : field_stock sur la variation, field_brand et field_category sur le produit
  • Formulaire de configuration dans Commerce › Configuration › Miravia, protégé par la permission restreinte Administer the Miravia sync
  • Le SKU de la variation est envoyé comme SKU vendeur Miravia ; les fiches existantes avec ce SKU sont mises à jour
  • ID de termes de taxonomie associés aux catégories Miravia, avec une majoration de prix par catégorie
  • Utilise les clés de votre propre app Miravia Open Platform, sans service intermédiaire

Drupal Commerce laisse le stock, la marque et la catégorie à votre propre modèle de contenu : un connecteur générique n’a donc rien de fixe à lire. Ce module s’appuie sur les champs dont vous disposez déjà, prépare une fiche Miravia pour chaque produit qui respecte vos règles et garde stock et prix alignés.

Comment il s’intègre à Drupal Commerce

Nécessite Drupal 11.3, Commerce 3.x (Commerce Product) et PHP 8.3+.
Les réglages, Tester la connexion, Synchroniser maintenant et le rapport de la dernière synchronisation (publiés, désactivés, écartés avec la raison, erreurs de Miravia) se trouvent dans Commerce › Configuration › Miravia. Seuls les rôles ayant Administer the Miravia sync y accèdent.
Enregistrer un produit ou une variation déclenche hook_commerce_product_update / hook_commerce_product_variation_update et la modification est transmise. hook_cron exécute la synchronisation complète une fois par jour et désactive sur Miravia ce qui ne respecte plus vos règles.
Le cœur de Commerce n’a ni stock, ni marque, ni catégorie : le module utilise field_stock (entier, sur la variation), field_brand et field_category (termes de taxonomie, sur le produit) s’ils existent. Sans field_stock, 10 unités sont envoyées. Les images viennent de field_images ou field_image du produit ou de la variation, et un produit ou une variation dépublié part comme inactif.
La version 1.0 publie les produits qui n’ont qu’une variation. L’import des commandes, les numéros de suivi et les étiquettes d’expédition sont prévus.

Installation

  1. Étape 1

    Téléchargez l’archive dans Mon compte › Téléchargements sur ecom-addons.com.

  2. Étape 2

    Décompressez-la dans modules/custom/ecom_addons_miravia_sync et activez-la sur Étendre, ou lancez drush en ecom_addons_miravia_sync.

  3. Étape 3

    Attribuez la permission aux bons rôles, créez une app dans la console Miravia Open Platform, autorisez-la avec votre compte vendeur et saisissez l’app key, l’app secret et l’access token dans le formulaire de réglages.

  4. Étape 4

    Testez la connexion, définissez les règles et cliquez sur Synchroniser maintenant. Vérifiez que le cron de Drupal tourne au moins une fois par jour.

Téléchargez le guide pas à pas (PDF)

Questions fréquentes

Mes produits ont plusieurs variations : sont-ils envoyés ?

Pas en 1.0. Seuls les produits à variation unique sont publiés ; le rapport liste les autres.

Je n’ai pas de champ de stock. Que reçoit Miravia ?

10 unités par produit. Ajoutez un field_stock entier au type de variation pour envoyer les vraies quantités.

Quels ID de catégorie faut-il associer ?

Ceux des termes de taxonomie référencés par field_category, une ligne par terme avec l’ID de catégorie Miravia à côté.

Historique des versions

  1. Chargement…

Avis

Chargement…