Content Sections

Package docs status

This page is generated from public package documentation in capell-4/packages and the package manifest checked into the source repository.

Field	Value
Composer package	`capell-app/content-sections`
Package slug	`content-sections`
Product group	Capell Foundation
Tier	free
Bundle	`foundation`
Runtime contexts	`admin`, `frontend`
Capell version	`^4.0`
Source repository	`capell-app/packages`
Source path	`packages/content-sections`
Docs source	`packages/content-sections/docs`
Manifest	`capell.json`

Reusable content sections for Capell.

Package: capell-app/content-sections
Namespace: Capell\ContentSections\
Surfaces: Filament admin, Livewire, database
Service providers: packages/content-sections/src/Providers/ContentSectionsServiceProvider.php
Capell dependencies: capell-app/admin, capell-app/content-blocks, capell-app/core, capell-app/frontend, capell-app/layout-builder

Lets teams reuse managed content sections across pages instead of hard-coding every repeatable marketing or content block.
Keeps section records, mutation behavior, and frontend rendering in one package so themes can render sections predictably.
Helps editors update shared content once while developers keep presentation in Blade and package-owned render surfaces.

Reusable content sections for Capell.
Content block definitions for each registered section, exposed through capell-app/content-blocks.
Admin resources: SectionResource.
Livewire components: AbstractAssets, ModalTableSelect, SectionAssets.

Install after Content Blocks and Layout Builder so section definitions can be registered as layout-selectable blocks.

Area	Path	Purpose
Actions	`packages/content-sections/src/Actions`	Domain operations. Test these directly where possible.
Data	`packages/content-sections/src/Data`	Structured payloads, form state, view models, and integration data.
Enums	`packages/content-sections/src/Enums`	Persisted states and Filament option values.
Models	`packages/content-sections/src/Models`	Eloquent records owned by the package.
Filament	`packages/content-sections/src/Filament`	Admin resources, pages, blocks, and settings UI.
Livewire	`packages/content-sections/src/Livewire`	Interactive frontend or admin components.
Providers	`packages/content-sections/src/Providers`	Registration, extension hooks, routes, migrations, and resources.
Resources	`packages/content-sections/resources`	Views, translations, assets, and package resources.
Config	`packages/content-sections/config`	Package configuration and publishable config.
Database	`packages/content-sections/database`	Migrations, seeders, and settings migrations.
Tests	`packages/content-sections/tests`	Package-level Pest coverage.

Models: ComposhipsJsonRelationshipsTrait, Section.
Migrations: 2026_05_10_190844_01_create_sections_table.php.
Config: packages/content-sections/config/capell-content-sections.php.
Data objects live in src/Data/; use them for payloads, form state, and view models.

Contracts: SectionDefinitionProvider.
Content block bridge: registered sections are exposed as section.{key} block definitions through BlockDefinitionProvider::TAG.
Register Capell extension points, routes, migrations, settings, render hooks, and resources from service providers.

Install with composer require capell-app/content-sections in the host Capell application.
Run migrations through the host application package install flow.
In this repository, verify package changes with vendor/bin/pest; do not use php artisan.

Run package tests from the repository root:

vendor/bin/pest packages/content-sections/tests --configuration=phpunit.xml

Put behaviour changes in src/Actions/; UI classes, commands, and controllers should call actions instead of owning domain logic.
Use package Data classes at boundaries instead of passing anonymous arrays between layers.
Use backed enums for persisted values and enum labels for Filament options.