Comment installer les add-ons

6 min de lecture Mis à jour le mars 24, 2026 1 vues

Vue d'ensemble

Larapen utilise un système d'add-ons 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 add-ons

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

Add-ons disponibles

Larapen propose une large gamme d'add-ons :

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é)

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

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

Téléchargez le package de l'add-on (fichier ZIP).
Extrayez le fichier ZIP sur votre ordinateur local.
Téléversez le dossier de l'add-on 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/
Connectez-vous au panneau d'administration.
Allez dans Add-ons dans la barre latérale.
Cliquez sur « Synchroniser » pour rechercher les add-ons nouvellement téléversés.
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 l'add-on dans le répertoire des extensions
unzip blog-addon.zip -d extensions/addons/blog/

# Exécuter les migrations de l'add-on
php artisan migrate --path=extensions/addons/blog/database/migrations

# Activer l'add-on (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 de l'add-on
├── 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 l'add-on

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

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

Barre latérale de l'administration

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

Vues du thème

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

Intégration des menus

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

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

Gestion des add-ons

Désactiver un add-on

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

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

Désinstaller un add-on

Attention : La destruction d'un add-on supprime définitivement ses tables de base de données et toutes les données associées. Créez une sauvegarde avant de continuer.

Désactivez d'abord l'add-on.
Cliquez sur « Détruire » pour supprimer ses tables de base de données.
Optionnellement, supprimez le dossier de l'add-on 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 Add-ons 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 l'add-on.

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