TallCMS

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: 5.0
• Database: MySQL 8.0+, MariaDB 10.3+, or SQLite

Installation

1. Install via Composer:

composer require tallcms/cms

This will also install Filament 5.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:

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 your panel path (default /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

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

Publishing Workflow

TallCMS supports a full publishing workflow:

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_):

Artisan Commands

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 security@tallcms.com 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: hello@tallcms.com