wsmallnews/cms is a Filament CMS package for navigation management, post management, tags, frontend CMS routes, authentication pages, and user profile pages. Navigation trees are powered by wsmallnews/filament-nestedset, and posts integrate with the Wsmallnews support, comment, preference, and category packages.
- Navigation tree management with
wsmallnews/filament-nestedset - Navigation type management for separating different navigation trees
- Post resource with media, tags, categories, comments, preferences, counters, and publishing states
- Configurable frontend CMS routes and theme layout
- Livewire frontend components for navigation, post lists, post detail, footer, and breadcrumbs
- User auth/profile/settings pages for CMS-facing users
- Scopeable data via
scope_typeandscope_id - Optional Filament tenancy support
This package ships Laravel Boost AI Guidelines in resources/boost/guidelines/core.blade.php.
Install or enable Laravel Boost in your application, then refresh Boost resources so this package's guidelines are discovered and added to the project overview:
php artisan boost:update --discoverBoost updates the root boost.json and CLAUDE.md automatically. Check those files after running the command to confirm wsmallnews/cms is included.
You can install the package via composer:
composer require wsmallnews/cms:^1.0The package provides an install command. By default it also installs its support, comment, and preference dependencies:
php artisan sn-cms:installTo skip dependency installation and interactive prompts:
php artisan sn-cms:install --no-deps --no-interactionYou can publish only the config file individually:
php artisan vendor:publish --tag="cms-config"Publish and run only the migrations individually:
php artisan vendor:publish --tag="cms-migrations"
php artisan migrateMulti language support, you can publish the language files using:
php artisan vendor:publish --tag="sn-support-translations"Optionally, you can publish the views using:
php artisan vendor:publish --tag="cms-views"The package configuration lives in config/sn-cms.php:
return [
'scopeable' => [
'scope_type' => 'sn-cms',
'scope_id' => 0,
],
'models' => [
'navigation' => Wsmallnews\Cms\Models\Navigation::class,
'navigation_type' => Wsmallnews\Cms\Models\NavigationType::class,
'post' => Wsmallnews\Cms\Models\Post::class,
],
'routes' => [
'enabled' => true,
'prefix' => 'cms',
'name' => 'sn-cms.',
],
];Use sn-cms.panel_register to control which Filament pages/resources are registered, sn-cms.routes to control frontend route generation, and sn-cms.themes to control frontend layout and dark mode behavior.
Register the plugin on your Filament panel:
use Wsmallnews\Cms\CmsPlugin;
$panel
->plugin(CmsPlugin::make());CmsPlugin registers the pages and resources configured in sn-cms.panel_register, including:
Wsmallnews\Cms\Filament\Pages\Navigation\NavigationPageWsmallnews\Cms\Filament\Pages\CategoryWsmallnews\Cms\Filament\Pages\GeneralSettingWsmallnews\Cms\Filament\Resources\NavigationTypes\NavigationTypeResourceWsmallnews\Cms\Filament\Resources\Posts\PostResourceWsmallnews\Cms\Filament\Resources\Tags\TagResource
NavigationPage extends Wsmallnews\Cms\Filament\Pages\Navigation\Base, which extends Wsmallnews\FilamentNestedset\Filament\Pages\NestedsetPage.
The base page automatically resolves or creates a NavigationType for the configured scope, applies the type's level to the nestedset tree, and scopes navigation records by:
scope_typescope_idtype_idteam_idwhen tenancy is enabled
Create your own navigation page by extending the base page:
<?php
namespace App\Filament\Pages;
use Wsmallnews\Cms\Filament\Pages\Navigation\Base;
class FooterNavigation extends Base
{
protected static ?string $slug = 'footer-navigation';
protected static ?string $scopeType = 'footer';
protected static int $scopeId = 0;
protected static ?int $level = 2;
}Wsmallnews\Cms\Models\Post supports:
PostStatusenum states- media via Spatie Media Library
- tags via Spatie Tags
- categories through
sn_category_post - comments through the Wsmallnews comment package
- preferences/views through the Wsmallnews preference package
HasSnSubjectmethods for preference display components
The service provider registers frontend Livewire components such as:
<livewire:sn-cms-components-navigation />
<livewire:sn-cms-components-navigation-breadcrumb />
<livewire:sn-cms-components-posts />
<livewire:sn-cms-components-post />
<livewire:sn-cms-components-footer />Routes are enabled by default under the cms prefix. Configure sn-cms.routes.enabled, sn-cms.routes.prefix, and sn-cms.routes.name for your application.
| Category | Namespace |
|---|---|
| Plugin | Wsmallnews\Cms\CmsPlugin |
| ServiceProvider | Wsmallnews\Cms\CmsServiceProvider |
| Navigation Page Base | Wsmallnews\Cms\Filament\Pages\Navigation\Base |
| Navigation Page | Wsmallnews\Cms\Filament\Pages\Navigation\NavigationPage |
| Navigation Widget | Wsmallnews\Cms\Filament\Pages\Navigation\Widgets\Navigation |
| Post Resource | Wsmallnews\Cms\Filament\Resources\Posts\PostResource |
| Navigation Type Resource | Wsmallnews\Cms\Filament\Resources\NavigationTypes\NavigationTypeResource |
| Tag Resource | Wsmallnews\Cms\Filament\Resources\Tags\TagResource |
| Navigation Model | Wsmallnews\Cms\Models\Navigation |
| Navigation Type Model | Wsmallnews\Cms\Models\NavigationType |
| Post Model | Wsmallnews\Cms\Models\Post |
| Install Command | Wsmallnews\Cms\Commands\CmsInstallCommand |
| Utils | Wsmallnews\Cms\Support\Utils |
composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.