Comment installer les modules

Vue d'ensemble

Larapen utilise un système de modules modulaire qui vous permet d'étendre votre site web avec des fonctionnalités supplémentaires comme un Blog, une Boutique, un Centre d'aide, un Forum, des Événements, et plus encore. Chaque add-on est un package autonome qui peut être installé, activé et configuré indépendamment.

Où obtenir des modules

• Add-ons inclus — Certains add-ons sont inclus avec votre achat Larapen. Consultez la description de l'article sur CodeCanyon pour la liste des modules inclus.
• Add-ons achetés séparément — Des modules supplémentaires peuvent être achetés individuellement sur CodeCanyon.

Add-ons disponibles

Larapen propose une large gamme de modules :

• Blog — Système de blog complet avec articles, catégories, tags et commentaires.
• Shop — E-commerce avec produits, panier, paiement, commandes et coupons.
• Forum — Forum de discussion communautaire.
• HelpCenter — Base de connaissances et centre d'aide.
• Careers — Offres d'emploi et pages carrières.
• Events — Gestion d'événements et calendriers.
• FAQ — Foire aux questions.
• Partners — Vitrine de logos de partenaires et clients.
• Portfolio — Vitrine de portfolios et projets.
• Pricing — Tableaux de tarifs et forfaits.
• Team — Profils des membres de l'équipe.
• Newsletter — Inscriptions à la newsletter par email.
• Billing — Facturation.
• Classified — Petites annonces.
• Booking — Réservations et rendez-vous.
• Glossary — Glossaire et définitions.
• GDPR — Outils de conformité RGPD.
• Stats — Analyses et statistiques.
• Webmail — Intégration webmail.
• Stripe, PayPal, Paddle, MoMo — Intégrations de passerelles de paiement.
• Envato, Licenses — Gestion de licences.
• Ads Blocker Detector — Détection des bloqueurs de publicités.

Méthodes d'installation

Méthode 1 : Via le panneau d'administration (recommandé)

1. Connectez-vous à votre panneau d'administration sur https://votresite.com/admin.
2. Allez dans Add-ons dans la barre latérale.
3. Cliquez sur « Téléverser un add-on ».
4. Sélectionnez le fichier ZIP du module depuis votre ordinateur et cliquez sur Téléverser.
5. Le système va :
   • Valider le package du module
   • L'extraire dans le bon répertoire
   • Exécuter les migrations de base de données requises
   • Enregistrer le module dans le système
6. Une fois téléversé, cliquez sur « Activer » pour activer le module.

Méthode 2 : Via FTP/Gestionnaire de fichiers (manuel)

1. Téléchargez le package du module (fichier ZIP).
2. Extrayez le fichier ZIP sur votre ordinateur local.
3. Téléversez le dossier du module extrait dans extensions/addons/ sur votre serveur. Par exemple :
   • Add-on Blog → extensions/addons/blog/
   • Add-on Shop → extensions/addons/shop/
   • Add-on HelpCenter → extensions/addons/helpcenter/
4. Connectez-vous au panneau d'administration.
5. Allez dans Add-ons dans la barre latérale.
6. Cliquez sur « Synchroniser » pour rechercher les modules nouvellement téléversés.
7. Le nouvel add-on devrait apparaître dans la liste. Cliquez sur « Activer » pour l'activer.

Méthode 3 : Via SSH (ligne de commande)

# Extraire le module dans le répertoire des extensions
unzip blog-addon.zip -d extensions/addons/blog/

# Exécuter les migrations du module
php artisan migrate --path=extensions/addons/blog/database/migrations

# Activer le module (depuis le panneau admin ou via artisan)
php artisan addon:activate blog

Structure du répertoire d'un add-on

Chaque add-on suit une structure standardisée dans extensions/addons/{nom-addon}/ :

extensions/addons/blog/
├── addon.json              ← Manifeste (nom, version, dépendances)
├── config/                 ← Configuration du module
├── database/
│   └── migrations/         ← Tables de la base de données
├── resources/
│   ├── lang/               ← Traductions (en, fr)
│   └── views/              ← Vues par défaut (substituables par le thème)
└── src/
    ├── BlogServiceProvider.php
    ├── Http/Controllers/
    ├── Models/
    └── Services/

Après l'installation

Configurer le module

De nombreux add-ons ont leur propre page de paramètres. Après l'activation :

1. Allez dans Paramètres dans le panneau d'administration.
2. Cherchez le groupe de paramètres du module (par ex. « Paramètres du Blog », « Paramètres de la Boutique »).
3. Configurez les options selon vos besoins.

Barre latérale de l'administration

Les modules actifs ajoutent automatiquement leurs éléments de menu à la barre latérale de l'administration. Par exemple, le module Blog ajoute « Blog → Articles, Catégories, Tags, Commentaires ».

Vues du thème

Les modules incluent des vues front-end par défaut. Si votre thème actif fournit des substitutions pour le module (dans extensions/themes/{theme}/views/), celles-ci seront utilisées à la place.

Intégration des menus

Après avoir installé des modules qui fournissent des pages front-end (Blog, Boutique, etc.), vous pouvez ajouter des liens vers ceux-ci dans vos menus de navigation :

1. Allez dans Menus dans la barre latérale.
2. Cliquez sur un emplacement de menu, puis « Ajouter un élément ».
3. Sélectionnez le type de page du module (par ex. « Catégorie du Blog », « Catégorie de la Boutique »).

Gestion des modules

Désactiver un add-on

Pour désactiver temporairement un add-on sans le supprimer :

1. Allez dans Add-ons dans la barre latérale.
2. Cliquez sur « Désactiver » à côté du module.
3. Les routes, vues et éléments de menu admin du module seront masqués, mais ses tables de base de données et ses données restent intactes.

Désinstaller un add-on

1. Désactivez d'abord le module.
2. Cliquez sur « Détruire » pour supprimer ses tables de base de données.
3. Optionnellement, supprimez le dossier du module depuis extensions/addons/ via FTP/Gestionnaire de fichiers.

Dépannage

L'add-on n'apparaît pas après le téléversement

• Vérifiez que la structure des dossiers est correcte : extensions/addons/{nom}/addon.json doit exister.
• Cliquez sur « Synchroniser » sur la page des modules pour re-scanner.
• Vérifiez que le fichier addon.json est un JSON valide (pas d'erreurs de syntaxe).
• Vérifiez que la classe ServiceProvider existe dans l'espace de noms attendu.

Erreur « Nécessite la version X.X.X du cœur »

• L'add-on nécessite une version plus récente du cœur Larapen. Mettez d'abord à jour l'application principale, puis installez le module.

Erreurs de migration pendant l'installation

• Consultez storage/logs/laravel.log pour les messages d'erreur détaillés.
• Assurez-vous que votre utilisateur de base de données dispose des privilèges CREATE et ALTER.
• Si vous utilisez SSH, essayez d'exécuter la migration manuellement : php artisan migrate --path=extensions/addons/{nom}/database/migrations