Woo Related Compatible Products

Version: 1.2.4
Auteur: Khadija Har
Licence: GPL v3 ou ultérieure

---

📋 Description

Woo Related Compatible Products est un plugin WordPress/WooCommerce qui permet d'améliorer l'expérience d'achat de vos clients en affichant des produits compatibles sur chaque page produit. Configurez facilement des recommandations personnalisées via un champ dédié dans l'administration WooCommerce et affichez-les dans un carrousel élégant et responsive grâce à Owl Carousel. Augmentez vos ventes croisées avec un shortcode simple et intuitif.

---

✨ Fonctionnalités

• ✅ Champ personnalisé dans l'administration : Ajoutez facilement des produits compatibles directement depuis la fiche produit WooCommerce
• ✅ Gestion simple : Entrez les IDs des produits compatibles séparés par des virgules
• ✅ Affichage en carrousel : Intégration d'Owl Carousel pour un affichage élégant et responsive
• ✅ Shortcode flexible : Utilisez le shortcode [compatible_products] où vous le souhaitez sur votre site
• ✅ Compatible tous thèmes : Fonctionne avec tous les thèmes WooCommerce standards
• ✅ Sécurisé : Validation et sanitization des données pour une sécurité optimale

---

📦 Prérequis

• WordPress : Version 6.2 ou supérieure
• PHP : Version 7.0 ou supérieure
• WooCommerce : Plugin actif et installé
• jQuery : Inclus par défaut dans WordPress
• Connexion Internet : Pour charger les librairies Owl Carousel via CDN

---

🚀 Installation

1. Téléchargement : Téléchargez le dossier du plugin
2. Upload : Téléversez le dossier dans le répertoire /wp-content/plugins/ de votre site WordPress
3. Activation : Activez le plugin depuis le menu Extensions de WordPress
4. Configuration : Le plugin est prêt à être utilisé ! Aucune configuration supplémentaire n'est nécessaire

---

📖 Utilisation

Ajouter des produits compatibles

1. Accédez à Produits > Tous les produits dans votre administration WordPress
2. Éditez le produit pour lequel vous souhaitez ajouter des produits compatibles
3. Faites défiler jusqu'à la section Produits liés, Up-sells et Cross-sells
4. Trouvez le champ Produits Compatibles
5. Entrez les IDs des produits compatibles, séparés par des virgules (ex: 123, 456, 789)
6. Cliquez sur Mettre à jour pour enregistrer

Astuce : Pour trouver l'ID d'un produit, passez votre souris sur le produit dans la liste ou consultez l'URL lors de l'édition (l'ID apparaît dans l'URL : post.php?post=123)

Afficher les produits compatibles sur le front-end

Méthode 1 : Utilisation du shortcode

Placez le shortcode [compatible_products] dans :

• La description du produit
• Un widget de texte
• Un éditeur de page (Gutenberg, Elementor, etc.)
• Tout autre emplacement supportant les shortcodes

Exemple d'utilisation

[compatible_products]

Le plugin affichera automatiquement les produits compatibles dans un carrousel élégant avec le titre "Produits compatibles".

---

🎨 Personnalisation

Styles CSS

Le plugin inclut un fichier CSS personnalisable situé dans :

assets/css/custom-owl-carousel.css

Vous pouvez surcharger les styles dans votre thème pour personnaliser l'apparence du carrousel.

JavaScript

Le fichier JavaScript personnalisé se trouve dans :

assets/js/custom-owl-carousel.js

Vous pouvez modifier ce fichier pour personnaliser le comportement du carrousel (vitesse, nombre d'éléments visibles, etc.).

---

🔧 Structure technique

Fichiers inclus

woocommerce-compatible-products/
├── woocommerce-compatible-products.php  (Fichier principal)
├── assets/
│   ├── css/
│   │   └── custom-owl-carousel.css     (Styles personnalisés)
│   └── js/
│       └── custom-owl-carousel.js      (Scripts personnalisés)
└── README.md                            (Ce fichier)

Dépendances externes

Le plugin charge automatiquement les ressources suivantes via CDN :

• Owl Carousel 2.3.4 (CSS et JavaScript)
• Owl Carousel Theme Default (CSS)

---

📝 Shortcodes

Shortcode	Description	Paramètres
[compatible_products]	Affiche les produits compatibles définis pour le produit courant	Aucun

---

🔒 Sécurité

Le plugin respecte les meilleures pratiques de sécurité WordPress :

• Vérification des permissions avec ABSPATH
• Sanitization des données avec sanitize_text_field()
• Validation des entrées utilisateur
• Utilisation des fonctions WordPress natives

---

🐛 Dépannage

Les produits compatibles ne s'affichent pas

1. Vérifiez que WooCommerce est bien activé
2. Assurez-vous que les IDs des produits sont corrects et séparés par des virgules
3. Vérifiez que le shortcode est bien placé sur une page produit
4. Vérifiez la console du navigateur pour d'éventuelles erreurs JavaScript

Le carrousel ne fonctionne pas

1. Vérifiez votre connexion Internet (le plugin charge Owl Carousel via CDN)
2. Assurez-vous que jQuery est bien chargé (inclus par défaut dans WordPress)
3. Vérifiez qu'il n'y a pas de conflits avec d'autres plugins ou thèmes

---

📞 Support

Pour toute question, suggestion ou problème, vous pouvez :

• Ouvrir une issue sur GitHub
• Contacter l'auteur : Khadija Har

---

📄 Licence

Ce plugin est sous licence GPL v3 ou ultérieure.

Pour plus d'informations, consultez : https://www.gnu.org/licenses/gpl-3.0.html

---

🙏 Remerciements

Ce plugin utilise la librairie Owl Carousel 2 pour l'affichage en carrousel.

---

📈 Changelog

Version 1.2.4

• Version actuelle
• Amélioration de la description du plugin
• Optimisation du code

Version 1.0

• Version initiale
• Ajout du champ produits compatibles
• Intégration d'Owl Carousel
• Création du shortcode