Pré-requisitos

Antes de começar, certifique-se de ter o seguinte instalado no seu sistema:

Você também precisará de um terminal (bash, zsh, PowerShell) e um editor de código de sua preferência.

Instalação Passo a Passo

1. Criar um projeto Laravel

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

Ou usando o instalador Laravel:

laravel new my-blog
cd my-blog

2. Instalar FilamentPHP

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

Em seguida, crie seu primeiro usuário administrador:

php artisan make:filament-user

Guarde o e-mail e a senha — você precisará deles para fazer login.

3. Instalar Blogr

composer require happytodev/blogr
php artisan blogr:install

O instalador é interativo. Ele irá guiá-lo através de:

• CMS — Ativar páginas estáticas (Sobre, Contato, etc.)
• Tipo de página inicial — Índice do blog ou uma página CMS personalizada
• Alpine.js — Necessário para o alternador de tema
• Tailwind CSS v4 — Configuração do modo escuro
• Tutoriais — Conteúdo de exemplo para começar
• Dependências NPM — Instalação automática
• Compilação de assets — Compilar arquivos frontend

Dica: Responda "Sim" a todas as perguntas para uma configuração completa.

Pós-Instalação

Verificar o painel de administração

Abra http://my-blog.test/admin e faça login com as credenciais do passo 2. Você deve ver o painel do Blogr com estatísticas e widgets.

Criar seu primeiro artigo

1. Vá para Blog Posts → Novo Artigo na barra lateral admin
2. Escreva um título e conteúdo (Markdown é suportado)
3. Adicione uma categoria e tags
4. Defina uma imagem em destaque (arrastar e soltar)
5. Configure campos SEO (opcional)
6. Clique em Publicar

Visite seu blog em /blog (ou / se o blog estiver configurado como página inicial).

Configurar ajustes

Vá para Blogr Settings no painel de administração para personalizar:

• Geral — Nome do blog, descrição, artigos por página
• SEO — Nome do site, meta padrão, imagem Open Graph
• Navegação — Links do menu, navegação fixa, logotipo
• Aparência — Cores, estilos de cartão, modo escuro
• Rodapé — Links sociais, texto de direitos autorais
• Backup — Exportar/importar seus dados

Funcionalidades Opcionais

Ativar páginas CMS

Se você pulou o CMS durante a instalação, ative-o em config/blogr.php:

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

Em seguida, crie páginas em CMS → Pages CMS no painel de administração.

Ativar multilíngue

Edite config/blogr.php:

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

Com os idiomas ativados, seu conteúdo ganha URLs por idioma:

• /en/blog/my-post
• /pt/blog/meu-artigo

Instalar conteúdo demo

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