Requisitos Previos

Antes de comenzar, asegúrese de tener lo siguiente instalado en su sistema:

También necesitará una terminal (bash, zsh, PowerShell) y un editor de código.

Instalación Paso a Paso

1. Crear un proyecto Laravel

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

O usando el instalador de Laravel:

laravel new mi-blog
cd mi-blog

2. Instalar FilamentPHP

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

Luego cree su primer usuario administrador:

php artisan make:filament-user

Guarde el correo y la contraseña — los necesitará para iniciar sesión.

3. Instalar Blogr

composer require happytodev/blogr
php artisan blogr:install

El instalador es interactivo. Le guiará a través de:

• CMS — Active páginas estáticas (Acerca de, Contacto, etc.)
• Tipo de página de inicio — Índice del blog o página CMS
• Alpine.js — Requerido para el selector de tema
• Tailwind CSS v4 — Configuración del modo oscuro
• Tutoriales — Contenido de ejemplo para empezar
• Dependencias NPM — Instalación automática
• Compilación de assets — Build de archivos frontend

Consejo: Responda «Sí» a todas las preguntas para una configuración completa.

Post-Instalación

Verificar el panel de administración

Abra http://mi-blog.test/admin e inicie sesión con las credenciales del paso 2. Debería ver el panel de Blogr con estadísticas y widgets.

Crear su primer artículo

1. Vaya a Blog Posts → Nuevo Artículo en la barra lateral
2. Escriba un título y contenido (Markdown compatible)
3. Añada una categoría y etiquetas
4. Establezca una imagen destacada (arrastrar y soltar)
5. Configure los campos SEO (opcional)
6. Haga clic en Publicar

Visite su blog en /blog (o / si el blog está configurado como página de inicio).

Configurar ajustes

Vaya a Blogr Settings en el panel de administración para personalizar:

• General — Nombre del blog, descripción, artículos por página
• SEO — Nombre del sitio, meta por defecto, imagen Open Graph
• Navegación — Enlaces del menú, navegación fija, logo
• Apariencia — Colores, estilos de tarjetas, modo oscuro
• Pie de página — Enlaces sociales, texto de copyright
• Respaldo — Exportar/importar sus datos

Funcionalidades Opcionales

Activar páginas CMS

Si omitió el CMS durante la instalación, actívelo en config/blogr.php:

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

Luego cree páginas en CMS → Pages CMS del panel de administración.

Activar multilingüe

Edite config/blogr.php:

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

Con los idiomas activados, su contenido tendrá URLs por idioma:

• /en/blog/my-post
• /es/blog/mi-articulo

Instalar contenido demo

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