Woo Total Menu

Plugin WordPress/WooCommerce de création de méga menus, headers et footers avancés via un builder visuel glisser-déposer.

📖 Présentation

Woo Total Menu est pensé pour combler un vide : les solutions de méga menu actuelles sont soit trop complexes (courbe d'apprentissage énorme), soit trop limitées (pas de headers/footers), soit mal intégrées à WooCommerce. Ce plugin propose le couteau suisse de la navigation, capable de créer en quelques clics :

• Méga menus horizontaux mettant en valeur les catégories de produits, articles et pages.
• Menus verticaux (sidebar navigation, filtres, menu catalogue).
• Headers complets (logo, barre de recherche, icônes panier/compte, menu secondaire).
• Footers complets (multi-colonnes, widgets, liens légaux, réseaux sociaux).

Le tout avec une approche glisser-déposer visuelle côté admin, et un rendu 100% responsive, moderne et personnalisable côté frontend, sans toucher une ligne de code.

📦 Installation

Méthode 1 : Téléchargement direct

1. Téléchargez la dernière version : woo-total-menu-1.0.1.zip
2. Dans WordPress : Extensions → Ajouter → Téléverser une extension
3. Téléversez le fichier ZIP, cliquez sur Installer, puis Activer
4. WooCommerce doit être actif (notification sinon)

Méthode 2 : Manuellement via FTP

1. Décompressez le ZIP
2. Uploadez le dossier woo-total-menu dans /wp-content/plugins/
3. Activez le plugin via le menu Extensions de WordPress

Méthode 3 : Git (pour développeurs)

cd /wp-content/plugins/
git clone https://github.com/VOTRE-USER/woo-total-menu.git
# Puis activation dans wp-admin

🚀 État d'avancement

👉 Voir le CHANGELOG.md pour le détail de chaque version.

🏗️ Architecture technique

woo-total-menu/
├── woo-total-menu.php          # Point d'entrée + constantes + autoloader PSR-4
├── readme.txt                  # Doc WordPress.org
├── CHANGELOG.md
├── src/
│   ├── Bootstrap.php           # Classe centrale (boot, deps check, services)
│   ├── Admin/
│   │   ├── Pages/
│   │   │   └── About.php       # Page "À propos" admin
│   │   └── Meta_Boxes.php      # 6 méta-boxes (v1.0.1)
│   ├── Core/
│   │   ├── Cache_Manager.php   # Cache objet + transients
│   │   ├── Permissions.php     # 4 capacités personnalisées
│   │   └── CPT_Manager.php     # CPT wtm_menu + 4 locations (v1.0.1)
│   ├── Frontend/
│   │   └── Assets_Loader.php   # Stub (no-op pour l'instant)
│   ├── Api/                    # (vide, v1.0.3)
│   └── Entities/               # (vide, versions futures)
├── assets/  build/  languages/  templates/   # Dossiers vides

Stack cible :

• PHP 7.4+ / WordPress 6.3+ / WooCommerce 8.0+
• Autoloader PSR-4 (namespace WooTotalMenu\)
• API REST WordPress comme colonne vertébrale (/wp-json/wtm/v1/)
• React + @wordpress/scripts pour le builder (v1.1.x)
• MariaDB/MySQL via CPT + postmeta (pas de tables custom pour les menus)

🔧 Développement local

Prérequis

• PHP 7.4+ avec extensions : mysqli, pdo_mysql, mbstring, xml, gd, intl, curl, zip, bcmath
• MySQL 5.7+ ou MariaDB 10.4+
• Un serveur web (Apache/Nginx) ou le serveur intégré PHP

Installation rapide (avec WP-CLI)

# 1. Cloner le plugin dans wp-content/plugins/
cd wp-content/plugins/
git clone https://github.com/VOTRE-USER/woo-total-menu.git

# 2. Activer le plugin
wp plugin activate woo-total-menu

# 3. Vérifier l'installation
wp eval 'echo WTM_VERSION;'   # doit afficher 1.0.1

Tests smoke

# Vérifier que le CPT est enregistré
wp eval 'var_dump(get_post_type_object("wtm_menu") !== null);'

# Vérifier que les 4 locations sont présentes
wp eval 'foreach(get_registered_nav_menus() as $k=>$v) if(strpos($k,"wtm_")===0) echo "$k\n";'

🎯 Fonctionnalités planifiées (non encore implémentées)

❌ Hors périmètre (exclu du projet)

Les fonctionnalités suivantes ont été jugées non réalisables dans le cadre de ce projet :

• ❌ Assistant IA conversationnel "Chat Menu Designer"
• ❌ Génération d'images via DALL·E / Stable Diffusion
• ❌ Auto-adaptation ML temps réel des menus
• ❌ Heatmaps intégrées
• ❌ WebLLM embarqué côté navigateur
• ❌ Support vocal pour dicter les commandes
• ❌ Promesse "zéro impact performance" (visé : < 25 Ko gzippé)
• ❌ Compatibilité universelle avec tous les thèmes

📚 Documentation

• CHANGELOG.md — Journal détaillé des versions
• readme.txt — Documentation WordPress.org
• Specs fonctionnelles et techniques : voir le document de cadrage interne

🤝 Contribution

Les contributions sont les bienvenues ! Pour contribuer :

1. Forkez le projet
2. Créez une branche : git checkout -b feature/ma-feature
3. Commitez : git commit -m 'feat: ajout de ma feature'
4. Pushez : git push origin feature/ma-feature
5. Ouvrez une Pull Request

Conventions de commit (Angular)

• feat: Nouvelle fonctionnalité
• fix: Correction de bug
• docs: Documentation
• style: Formatage (sans impact code)
• refactor: Refactorisation
• test: Ajout de tests
• chore: Tâches diverses

📜 Licence

GPL-2.0-or-later — Voir LICENSE ou https://www.gnu.org/licenses/gpl-2.0.html

👥 Auteurs

• Woo Total Menu Team — GitHub

Fait avec ❤️ pour la communauté WordPress/WooCommerce