Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants installés sur votre système :

Vous aurez également besoin d'un terminal (bash, zsh, PowerShell) et d'un éditeur de code.

Installation Pas à Pas

1. Créer un projet Laravel

composer create-project laravel/laravel mon-blog
cd mon-blog

Ou avec l'installateur Laravel :

laravel new mon-blog
cd mon-blog

2. Installer FilamentPHP

composer require filament/filament
php artisan filament:install --panels

Créez ensuite votre premier utilisateur admin :

php artisan make:filament-user

Gardez l'email et le mot de passe — vous en aurez besoin pour vous connecter.

3. Installer Blogr

composer require happytodev/blogr
php artisan blogr:install

L'installateur est interactif. Il va vous guider à travers :

• CMS — Activez les pages statiques (À propos, Contact, etc.)
• Type de page d'accueil — Index du blog ou page CMS
• Alpine.js — Requis pour le changement de thème
• Tailwind CSS v4 — Configuration du mode sombre
• Tutoriels — Contenu d'exemple pour démarrer
• Dépendances NPM — Installation automatique
• Compilation des assets — Build des fichiers frontend

Astuce : Répondez « Oui » à toutes les questions pour une configuration complète.

Post-Installation

Vérifier le panneau d'administration

Ouvrez http://mon-blog.test/admin et connectez-vous avec les identifiants de l'étape 2. Vous devriez voir le tableau de bord Blogr avec les statistiques et widgets.

Créer votre premier article

1. Allez dans Blog Posts → Nouvel Article dans la barre latérale
2. Écrivez un titre et du contenu (Markdown supporté)
3. Ajoutez une catégorie et des tags
4. Définissez une image à la une (glisser-déposer)
5. Configurez les champs SEO (optionnel)
6. Cliquez sur Publier

Visitez votre blog à /blog (ou / si le blog est défini comme page d'accueil).

Configurer les paramètres

Allez dans Blogr Settings dans le panneau d'administration pour personnaliser :

• Général — Nom du blog, description, articles par page
• SEO — Nom du site, meta par défaut, image Open Graph
• Navigation — Liens du menu, navigation collante, logo
• Apparence — Couleurs, styles des cartes, mode sombre
• Pied de page — Liens sociaux, texte de copyright
• Sauvegarde — Export/import de vos données

Fonctionnalités Optionnelles

Activer les pages CMS

Si vous avez ignoré le CMS lors de l'installation, activez-le dans config/blogr.php :

'cms' => [
    'enabled' => true,
    'prefix' => '',
],

Créez ensuite des pages dans CMS → Pages CMS du panneau d'administration.

Activer le multilingue

Modifiez config/blogr.php :

'locales' => [
    'enabled' => true,
    'default' => 'en',
    'available' => ['en', 'fr', 'es', 'de', 'pl'],
],

Avec les locales activées, votre contenu aura des URLs par langue :

• /en/blog/my-post
• /fr/blog/mon-article

Installer le contenu démo

php artisan blogr:publish-demo-pages
php artisan blogr:install-tutorials