README

ALPHA VERSION: This package is in early development. The API may change without notice. Not recommended for production use yet.

Content management package for Laravel with pages, posts, blocks and menus. Supports Blade templates with optional Livewire components for interactivity. Includes multilingual support via Spatie Translatable.

Features

• Pages: Flexible page system with customizable layouts and block zones
• Posts: Blog/news posts with author attribution and publishing workflow
• Menus: Hierarchical menu system with nested items
• Blocks: Modular content blocks (HTML, Recent Posts, Menu, Contact Form)
• Layouts: Pre-built page layouts (Single, Sidebar Left/Right, Two/Three Column)
• Multilingual: Full translation support via spatie/laravel-translatable
• Extensible: Register custom layouts and blocks via registries
• Secure: HTML sanitization with configurable allowed tags

Requirements

• PHP 8.3+
• Laravel 12+
• Livewire 3+ (optional, for interactive blocks)
• users.id UUID v7 char(36) — lara-content is UUID-first (see ADR-001). The consumer app's users table must use UUID v7 as primary key. Setup guide shared with the AichaDigital umbrella: aichadigital/larabill setup-uuid.md.

Installation

Install via composer:

composer require aichadigital/lara-content

Publish and run migrations:

php artisan vendor:publish --tag="lara-content-migrations"
php artisan migrate

Publish the config file:

php artisan vendor:publish --tag="lara-content-config"

Optionally publish views for customization:

php artisan vendor:publish --tag="lara-content-views"

Configuration

Key configuration options in config/content.php:

return [
    // Author model for posts (must have UUID v7 char(36) primary key)
    'author_model' => env('CONTENT_AUTHOR_MODEL', 'App\\Models\\User'),

    // Cache settings
    'cache' => [
        'enabled' => env('CONTENT_CACHE_ENABLED', true),
        'default_ttl' => env('CONTENT_CACHE_TTL', 3600),
    ],

    // Security: allowed HTML tags and attributes
    'security' => [
        'allowed_tags' => ['p', 'br', 'strong', 'em', 'a', 'img', ...],
        'allowed_attributes' => [...],
    ],
];

Usage

Pages

Pages support flexible layouts with multiple content zones:

use AichaDigital\LaraContent\Models\Page;

// Create a page
$page = Page::create([
    'title' => 'About Us',
    'slug' => 'about-us',
    'layout' => 'sidebar-right',
    'status' => 'published',
]);

// Add blocks to zones
$page->blocks()->create([
    'zone' => 'main',
    'block_type' => 'html',
    'content' => ['html' => '<p>Welcome to our company...</p>'],
    'order' => 1,
]);

Posts

Blog posts with author attribution:

use AichaDigital\LaraContent\Models\Post;

$post = Post::create([
    'title' => 'Getting Started',
    'slug' => 'getting-started',
    'content' => '# Introduction...',
    'author_id' => auth()->id(),
    'status' => 'published',
    'published_at' => now(),
]);

Menus

Hierarchical menus with nested items:

use AichaDigital\LaraContent\Models\Menu;

$menu = Menu::create([
    'name' => 'Main Navigation',
    'slug' => 'main-nav',
]);

$menu->items()->create([
    'title' => 'Home',
    'url' => '/',
    'order' => 1,
]);

Blocks

Render blocks in your views:

@foreach($page->blocks as $block)
    {!! app(BlockRenderer::class)->render($block) !!}
@endforeach

Available Layouts

Available Blocks

Extending

Custom Layouts

Register custom layouts in your service provider:

use AichaDigital\LaraContent\Registries\LayoutRegistry;
use App\Content\Layouts\CustomLayout;

public function boot(): void
{
    app(LayoutRegistry::class)->register(new CustomLayout());
}

Custom Blocks

Register custom blocks:

use AichaDigital\LaraContent\Registries\BlockRegistry;
use App\Content\Blocks\CustomBlock;

public function boot(): void
{
    app(BlockRegistry::class)->register(new CustomBlock());
}

Testing

composer test

Changelog

Please see CHANGELOG for recent changes.

License

AGPL-3.0-or-later. See License File for details.

Lara Content (Español)

VERSION ALPHA: Este paquete está en desarrollo inicial. La API puede cambiar sin previo aviso. No recomendado para producción todavía.

Paquete de gestión de contenido para Laravel con páginas, posts, bloques y menús. Soporta plantillas Blade con componentes Livewire opcionales para interactividad. Incluye soporte multilingüe via Spatie Translatable.

Características

• Páginas: Sistema flexible de páginas con layouts personalizables y zonas de bloques
• Posts: Posts de blog/noticias con atribución de autor y flujo de publicación
• Menús: Sistema jerárquico de menús con elementos anidados
• Bloques: Bloques de contenido modulares (HTML, Posts Recientes, Menú, Formulario de Contacto)
• Layouts: Layouts predefinidos (Una Columna, Sidebar Izquierda/Derecha, Dos/Tres Columnas)
• Multilingüe: Soporte completo de traducciones via spatie/laravel-translatable
• Extensible: Registra layouts y bloques personalizados via registries
• Seguro: Sanitización HTML con tags permitidos configurables

Requisitos

• PHP 8.3+
• Laravel 12+
• Livewire 3+ (opcional, para bloques interactivos)
• users.id UUID v7 char(36) — lara-content es UUID-first (ver ADR-001). La tabla users de la app consumidora debe usar UUID v7 como clave primaria. Guía de setup compartida con el paraguas AichaDigital: aichadigital/larabill setup-uuid.md.

Instalación

Instalar via composer:

composer require aichadigital/lara-content

Publicar y ejecutar migraciones:

php artisan vendor:publish --tag="lara-content-migrations"
php artisan migrate

Publicar archivo de configuración:

php artisan vendor:publish --tag="lara-content-config"

Opcionalmente publicar vistas para personalización:

php artisan vendor:publish --tag="lara-content-views"

Uso

Páginas

use AichaDigital\LaraContent\Models\Page;

// Crear una página
$page = Page::create([
    'title' => 'Sobre Nosotros',
    'slug' => 'sobre-nosotros',
    'layout' => 'sidebar-right',
    'status' => 'published',
]);

// Añadir bloques a zonas
$page->blocks()->create([
    'zone' => 'main',
    'block_type' => 'html',
    'content' => ['html' => '<p>Bienvenido a nuestra empresa...</p>'],
    'order' => 1,
]);

Posts

use AichaDigital\LaraContent\Models\Post;

$post = Post::create([
    'title' => 'Primeros Pasos',
    'slug' => 'primeros-pasos',
    'content' => '# Introducción...',
    'author_id' => auth()->id(),
    'status' => 'published',
    'published_at' => now(),
]);

Menús

use AichaDigital\LaraContent\Models\Menu;

$menu = Menu::create([
    'name' => 'Navegación Principal',
    'slug' => 'nav-principal',
]);

$menu->items()->create([
    'title' => 'Inicio',
    'url' => '/',
    'order' => 1,
]);

Layouts Disponibles

Bloques Disponibles

Extensión

Layouts Personalizados

use AichaDigital\LaraContent\Registries\LayoutRegistry;
use App\Content\Layouts\MiLayout;

public function boot(): void
{
    app(LayoutRegistry::class)->register(new MiLayout());
}

Bloques Personalizados

use AichaDigital\LaraContent\Registries\BlockRegistry;
use App\Content\Blocks\MiBloque;

public function boot(): void
{
    app(BlockRegistry::class)->register(new MiBloque());
}

Tests

composer test

Licencia

AGPL-3.0-or-later. Ver archivo de licencia para detalles.