tallcms/cms

TallCMS - A modern CMS for Filament admin panels. Works standalone or as a plugin in existing Filament apps.

2.11.0 2026-02-01 16:05 UTC

Requires

• php: ^8.2
• bezhansalleh/filament-shield: ^4.0
• ezyang/htmlpurifier: ^4.19
• filament/filament: ^4.0
• intervention/image: ^3.0
• lara-zeus/spatie-translatable: ^1.0
• laravel/sanctum: ^4.0
• laravel/scout: ^10.0
• paragonie/sodium_compat: ^2.0
• spatie/laravel-package-tools: ^1.16
• spatie/laravel-permission: ^6.0
• wsmallnews/filament-nestedset: ^2.0

Requires (Dev)

• knuckleswtf/scribe: ^4.0 || ^5.0
• orchestra/testbench: ^9.0 || ^10.0
• phpunit/phpunit: ^10.5 || ^11.0
• spatie/laravel-translatable: ^6.0

MIT

• TallCMS

• blog
• cms
• laravel
• pages
• content-management
• livewire
• filament
• filament-plugin
• tallstack

README

A modern Content Management System package for Laravel Filament. Add rich content editing, pages, posts, media library, and menus to your existing Filament application.

For a full standalone CMS with themes, plugins, and auto-updates, see tallcms/tallcms.

Features

• Rich Content Editor - Block-based editor with 16 built-in content blocks
• Pages & Posts - Static pages and blog posts with categories
• Publishing Workflow - Draft, Pending Review, Scheduled, and Published states
• Revision History - Track changes with diff comparison and rollback
• Preview System - Preview unpublished content with shareable tokens
• Media Library - Organize uploads with collections and metadata
• Menu Builder - Drag-and-drop navigation menus for multiple locations
• Site Settings - Centralized configuration for site name, contact info, social links
• Contact Form - Built-in contact form block with email notifications
• SEO Ready - Meta descriptions, canonical URLs, and structured data support
• Role-Based Permissions - Super Admin, Administrator, Editor, Author
• Multi-Panel Support - Works with any Filament panel configuration

Screenshots

Page Editor

Build rich pages with the block-based content editor.

Content Blocks

Choose from many built-in blocks: Hero, CTA, Pricing, FAQ, Testimonials, and more.

Posts Management

Manage blog posts with filters, bulk actions, and status indicators.

Media Library

Organize uploads with collections, metadata, and drag-and-drop.

Menu Builder

Create navigation menus with drag-and-drop ordering.

Revision History

Track changes with diff comparison and one-click rollback.

Site Settings

Configure site name, contact info, social links, and more.

Requirements

• PHP: 8.2+ with OpenSSL, PDO, Mbstring, GD extensions
• Laravel: 11.0 or 12.0
• Filament: 4.0
• Database: MySQL 8.0+, MariaDB 10.3+, or SQLite

Installation

1. Install via Composer:

composer require tallcms/cms

This will also install Filament 4.x as a dependency.

2. Configure Filament (if not already done):

php artisan filament:install --panels

3. Add HasRoles Trait to User Model:

Your User model must use the HasRoles trait from Spatie Permission:

use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use HasFactory, HasRoles, Notifiable;
    // ...
}

4. Register the plugin in your Panel Provider:

use TallCms\Cms\TallCmsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... your existing configuration
        ->plugin(TallCmsPlugin::make());
}

Important: You must register TallCmsPlugin in your panel provider. The CMS resources will not appear in your admin panel without this step.

5. Run the installer:

php artisan tallcms:install

This single command handles everything:

• Checks prerequisites (HasRoles trait, panel provider, etc.)
• Publishes Spatie Permission migrations
• Runs all database migrations
• Sets up roles and permissions via Filament Shield
• Creates your admin user

6. (Optional) Publish configuration:

php artisan vendor:publish --tag=tallcms-config

What Gets Registered

The plugin automatically registers these Filament components:

Type	Components
Resources	Pages, Posts, Categories, Media, Menus, Contact Submissions
Pages	Site Settings, Menu Items Manager
Widgets	Menu Overview Widget

Selective Registration

Disable specific components you don't need:

->plugin(
    TallCmsPlugin::make()
        ->withoutCategories()
        ->withoutPosts()
        ->withoutPages()
        ->withoutMedia()
        ->withoutMenus()
        ->withoutContactSubmissions()
        ->withoutSiteSettings()
)

Configuration

After publishing the config file, customize these options:

// config/tallcms.php
return [
    // Force mode (auto-detected if not set)
    'mode' => 'plugin', // or 'standalone'

    'plugin_mode' => [
        // Custom user model (defaults to App\Models\User)
        'user_model' => App\Models\User::class,

        // Enable frontend routes for /{slug} paths
        'routes_enabled' => false,

        // Optional URL prefix (e.g., 'cms' for /cms/about)
        'routes_prefix' => '',

        // Enable theme system in plugin mode
        'themes_enabled' => false,

        // Enable plugin system in plugin mode
        'plugins_enabled' => false,
    ],
];

Frontend Routes (Optional)

Frontend routes are disabled by default in plugin mode to avoid conflicts with your app's routes.

1. Enable CMS Routes

Add to your .env file:

TALLCMS_ROUTES_ENABLED=true

This registers both / (homepage) and /{slug} routes for CMS pages. Routes automatically exclude common paths like /admin, /api, /livewire, /storage, etc.

⚠️ Warning: When TALLCMS_ROUTES_ENABLED=true without a prefix, TallCMS registers the / route. However, Laravel loads your app's routes/web.php after package routes, so you must remove the default / route from routes/web.php for TallCMS to handle your homepage. Alternatively, set TALLCMS_ROUTES_PREFIX=cms to avoid the conflict.

2. Configure the Homepage

Mark a CMS page as "Homepage" in the admin panel. TallCMS will serve it at / (or /{prefix} if using a prefix).

3. Route Prefix (Optional)

To prefix all CMS routes (e.g., /cms/about instead of /about):

TALLCMS_ROUTES_PREFIX=cms

With a prefix, the routes become /cms (homepage) and /cms/{slug} (pages).

4. Publish Assets (Optional)

For frontend styling:

php artisan vendor:publish --tag=tallcms-assets

5. Publish Views (Optional)

To customize templates:

php artisan vendor:publish --tag=tallcms-views

Prerequisites for Frontend Routes

TallCMS frontend pages require Alpine.js.

Most Laravel apps include Alpine via Livewire. If your app loads Alpine separately, ensure it's loaded BEFORE tallcms.js, as TallCMS registers components on alpine:init.

Built-in Blocks

Block	Description
Hero	Landing page headers with CTAs and background images
Call-to-Action	Conversion-optimized promotional sections
Content	Article content with headings and rich text
Features	Feature grids with icons and descriptions
Pricing	Pricing tables with feature comparison
FAQ	Accordion-style frequently asked questions
Testimonials	Customer testimonials with ratings
Team	Team member profiles with social links
Stats	Statistics and metrics display
Image Gallery	Lightbox galleries with grid layouts
Logos	Logo showcases for partners/clients
Timeline	Chronological event displays
Contact Form	Dynamic forms with email notifications
Posts	Display recent blog posts
Parallax	Parallax scrolling sections
Divider	Visual section separators

Creating Custom Blocks

Generate a new block with the artisan command:

php artisan make:tallcms-block MyCustomBlock

This creates:

• Block class at app/Filament/Blocks/MyCustomBlockBlock.php
• Blade template at resources/views/cms/blocks/my-custom-block.blade.php

TallCMS Pro

Upgrade to TallCMS Pro for advanced features:

• 9 Premium Blocks - Accordion, Tabs, Counter, Table, Comparison, Video, Before/After, Code Snippet, Map
• Analytics Dashboard - Google Analytics 4 integration with visitor stats
• Priority Support - Direct email support

Learn more at tallcms.com/pro

User Roles

Role	Description
Super Admin	Complete system control
Administrator	Content and user management
Editor	Full content management
Author	Create and edit own content

Publishing Workflow

TallCMS supports a full publishing workflow:

Status	Description
Draft	Work in progress, not visible
Pending Review	Submitted for approval
Scheduled	Will publish at specified date/time
Published	Live and visible to visitors

Preview Tokens

Share unpublished content with stakeholders using preview tokens:

• Generate shareable links from the editor
• Set expiration dates and view limits
• Track remaining views

Revision History

All content changes are tracked:

• View complete revision history
• Compare any two revisions with diff highlighting
• Restore previous versions with one click
• Pin important revisions as snapshots

Multi-Panel Support

TallCMS works with any Filament panel configuration. Register the plugin in each panel where you want CMS features:

// app/Providers/Filament/AdminPanelProvider.php
->plugin(TallCmsPlugin::make())

// app/Providers/Filament/EditorPanelProvider.php
->plugin(
    TallCmsPlugin::make()
        ->withoutSiteSettings() // Editors can't change settings
)

All internal URLs use Filament's Page::getUrl() method, ensuring compatibility with custom panel paths and multi-panel setups.

Customization

Custom User Model

If your application uses a custom User model:

// config/tallcms.php
'plugin_mode' => [
    'user_model' => App\Models\CustomUser::class,
],

The model must implement Illuminate\Contracts\Auth\Authenticatable.

Overriding Views

Publish views for customization:

php artisan vendor:publish --tag=tallcms-views

Views are published to resources/views/vendor/tallcms/.

Extending Resources

Create your own resource classes that extend the package resources:

namespace App\Filament\Resources;

use TallCms\Cms\Filament\Resources\CmsPages\CmsPageResource as BaseResource;

class CmsPageResource extends BaseResource
{
    // Override methods as needed
    public static function getNavigationGroup(): ?string
    {
        return 'My Custom Group';
    }
}

Database Tables

TallCMS creates these tables (all prefixed with tallcms_):

Table	Purpose
tallcms_pages	Static content pages
tallcms_posts	Blog posts
tallcms_categories	Hierarchical categories
tallcms_post_category	Post-category pivot
tallcms_site_settings	Site configuration
tallcms_media	Media library items
tallcms_media_collections	Media collections
tallcms_menus	Navigation menus
tallcms_menu_items	Menu items (nested set)
tallcms_contact_submissions	Contact form entries
tallcms_revisions	Content revision history
tallcms_preview_tokens	Preview sharing tokens

Artisan Commands

Command	Description
tallcms:install	Full installation (migrations, roles, admin user)
tallcms:setup	Setup roles, permissions, and admin user only
make:tallcms-block	Create a custom content block
tallcms:clean-preview-tokens	Remove expired preview tokens

Permissions

TallCMS integrates with Filament Shield for permissions. Default permissions are created for each resource:

• ViewAny, View, Create, Update, Delete for each resource
• View:SiteSettings for the settings page
• View:MenuItemsManager for menu management

Contributing

Contributions are welcome! Please submit issues and pull requests on GitHub.

Security

If you discover a security vulnerability, please email [e-mail] instead of using the issue tracker.

License

TallCMS is open-source software licensed under the MIT license.

Credits

• Laravel - The PHP framework
• Filament - Admin panel framework
• Livewire - Dynamic frontend
• Tailwind CSS - Utility-first CSS
• daisyUI - Tailwind component classes
• Spatie - Laravel packages

Links

• Website: tallcms.com
• Documentation: tallcms.com/docs
• Standalone: github.com/tallcms/tallcms
• Support: [e-mail]