Prerequisiti

Prima di iniziare, assicurati di avere quanto segue installato sul tuo sistema:

Avrai anche bisogno di un terminale (bash, zsh, PowerShell) e di un editor di codice a tua scelta.

Installazione Passo dopo Passo

1. Creare un progetto Laravel

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

Oppure usando l'installer Laravel:

laravel new my-blog
cd my-blog

2. Installare FilamentPHP

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

Poi crea il tuo primo utente amministratore:

php artisan make:filament-user

Tieni a portata di mano email e password — ti serviranno per accedere.

3. Installare Blogr

composer require happytodev/blogr
php artisan blogr:install

L'installer è interattivo. Ti guiderà attraverso:

• CMS — Attiva pagine statiche (Chi siamo, Contatti, ecc.)
• Tipo di homepage — Indice del blog o una pagina CMS personalizzata
• Alpine.js — Necessario per il cambio tema
• Tailwind CSS v4 — Configurazione della modalità scura
• Tutorial — Contenuti di esempio per iniziare
• Dipendenze NPM — Installazione automatica
• Compilazione asset — Build dei file frontend

Consiglio: Rispondi "Sì" a tutti i prompt per una configurazione completa.

Post-Installazione

Verificare il pannello di amministrazione

Apri http://my-blog.test/admin e accedi con le credenziali del passaggio 2. Dovresti vedere la dashboard di Blogr con statistiche e widget.

Creare il primo articolo del blog

1. Vai su Blog Posts → Nuovo Articolo nella barra laterale admin
2. Scrivi un titolo e un contenuto (Markdown supportato)
3. Aggiungi una categoria e tag
4. Imposta un'immagine in evidenza (trascina e rilascia)
5. Configura i campi SEO (opzionale)
6. Clicca su Pubblica

Visita il tuo blog su /blog (o / se il blog è impostato come homepage).

Configurare le impostazioni

Vai su Blogr Settings nel pannello di amministrazione per personalizzare:

• Generale — Nome blog, descrizione, articoli per pagina
• SEO — Nome sito, meta predefiniti, immagine Open Graph
• Navigazione — Link menu, navigazione fissa, logo
• Aspetto — Colori, stili delle card, modalità scura
• Piè di pagina — Link social, testo copyright
• Backup — Esporta/importa i tuoi dati

Funzionalità Opzionali

Attivare pagine CMS

Se hai saltato il CMS durante l'installazione, attivalo in config/blogr.php:

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

Poi crea pagine in CMS → Pages CMS nel pannello di amministrazione.

Attivare il multilingua

Modifica config/blogr.php:

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

Con le lingue attivate, i tuoi contenuti ottengono URL per lingua:

• /en/blog/my-post
• /it/blog/mio-articolo

Installare contenuti demo

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