README

A blog package for Filament, built on top of filament-pages. Posts are block-based content with SEO, tags, RSS feeds, and live preview out of the box.

Requirements

• PHP ^8.4
• Filament ^5.0
• bambamboole/filament-pages ^0.4

Installation

composer require bambamboole/filament-blog

Publish and run the migrations:

php artisan vendor:publish --tag="filament-blog-migrations"
php artisan migrate

Optionally publish the config:

php artisan vendor:publish --tag="filament-blog-config"

Setup

Register the plugin in your Filament panel provider:

use Bambamboole\FilamentBlog\FilamentBlogPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentBlogPlugin::make(),
        ]);
}

Register the frontend routes in routes/web.php:

use Bambamboole\FilamentBlog\Facades\FilamentBlog;

FilamentBlog::routes();

Configuration

Set your application's layout so blog views inherit your site's header, footer, and styles:

// config/filament-blog.php
'layout' => 'layouts.app',

Other configuration options:

Plugin Options

FilamentBlogPlugin::make()
    ->navigationGroup('Content')
    ->navigationIcon('heroicon-o-document-text')
    ->navigationSort(1);

Importing Posts

Posts can be imported from YAML files using the filament-pages import command:

php artisan filament-pages:import --type=post --path=resources/posts

YAML format:

title: My Post Title
slug: my-post-title
published_at: '2026-01-15 00:00:00'
excerpt: A brief summary of the post.
blocks:
  -
    type: markdown
    content: |
      The post content in markdown.

Testing

composer test

License

The MIT License (MIT). Please see License File for more information.