Instructions d’installation [WooCommerce]

Avant de commencer

Vérifiez que votre boutique répond aux exigences minimales :

  • WordPress : 6.4+
  • WooCommerce : 6.0+ (installé et activé)
  • PHP : 8.0+
  • Un serveur avec HTTPS / SSL activé est requis pour des raisons de sécurité
  • Un compte Alter Product est requis (vous utiliserez une clé d’accès et un jeton d’accès)

Important : l’extension exécute Customizer, Configurator ou Viewer dans un iframe isolé et ne modifie donc pas le fonctionnement natif du paiement WooCommerce.

Étapes d’installation et de configuration

  1. Connectez-vous à l’administration WordPress.
  2. Dans l’administration WordPress, accédez à Extensions → Ajouter une extension, recherchez Alter Product – 3D Configurator for WooCommerce, installez l’extension, puis activez-la.* Facultatif : téléversez le fichier ZIP manuellement et activez l’extension.
  3. Dans l’administration WordPress, ouvrez Alter Product et cliquez sur Connecter dans Connexion automatique.* Configuration manuelle facultative : créez des clés API sur la page des paramètres API d’Alter Product, copiez la clé d’accès et le jeton d’accès, puis ajoutez le domaine de votre boutique dans les paramètres d’intégration.
  4. Suivez les étapes d’installation affichées pour terminer la configuration.
  5. Créez votre premier design : accédez à la page de modification d’un produit WooCommerce. Dans l’onglet Alter Product, créez un design (ou sélectionnez-en un existant). Le design sera associé au produit. Définissez des variantes correspondant au produit WooCommerce, activez éventuellement Customizer, puis enregistrez le projet.

Après la configuration

Une fois la configuration terminée, vous pouvez :

  • Gérer les ressources : produits, variantes, maquettes, bibliothèque graphique, logos, modèles de design, arrière-plans, environnements et polices
  • Importer des projets depuis le stockage Alter Product
  • Créer et gérer des designs de produits
  • Afficher un bouton pour l’outil e-commerce choisi sur les pages publiques de la boutique ou les pages produits WooCommerce
  • Intégrer Viewer / Configurator / Customizer aux pages produits WooCommerce ou aux pages WordPress
  • Associer les produits WooCommerce aux designs Alter Product
  • Permettre aux clients de personnaliser les produits (texte, images, mises en page, codes QR, etc.)
  • Synchroniser la configuration choisie avec le panier WooCommerce

Dépannage

  • Échec du test API : vérifiez la clé d’accès, le jeton d’accès et la connexion de votre serveur à https://alterproduct.com/public-api dans Alter Product → État.
  • Problèmes de téléchargement des ressources : accédez à Alter Product → État et vérifiez que votre serveur satisfait aux exigences du tableau Ressources du serveur.
  • Iframe vide / aucune communication : vérifiez que le domaine de votre boutique est ajouté dans Paramètres e-commerce → Intégration d’Alter Product, ou que votre serveur utilise HTTPS avec un certificat SSL valide.
  • Problème de permaliens : si les pages Customizer, Configurator ou Viewer affichent Introuvable, accédez à Réglages → Permaliens et cliquez sur Enregistrer les modifications pour actualiser les règles de réécriture.
  • L’ajout au panier ne fonctionne pas : vérifiez que l’association du produit est complète et que les actions e-commerce de l’outil intégré sont activées.