README

A powerful and flexible page builder plugin for Filament Admin that allows you to create dynamic, multi-language pages with a block-based content system.

Features

🏗️ Block-based Page Builder - Create pages using reusable content blocks
🌍 Multi-language Support - Built-in translation system for international websites
📱 Responsive Design - Mobile-friendly page layouts
🎨 Rich Content Blocks - Text, Images, Gallery, Video, Hero sections, and more
🔧 Customizable Templates - Create and use custom block templates
🧭 Navigation Integration - Automatic navigation menu generation
👁️ Visibility Control - Control page visibility and access
🎯 Position Management - Drag and drop page ordering

Screenshots

FireShot Capture 002 - Edit - StarterKit - gigabait uk

FireShot Capture 001 - StarterKit - gigabait uk

Installation

You can install the package via composer:

composer require gigabait93/filament-pages

You can publish and run the migrations with:

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

You can publish the config file with:

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

Optionally, you can publish the views using:

php artisan vendor:publish --tag="filament-pages-views"

You can publish the language files using:

php artisan vendor:publish --tag="filament-pages-translations"

This is the contents of the published config file:

<?php

return [
    // Group label for pages in the Filament admin navigation. Set to
    // `null` to display pages without a group.
    'admin_navigation_group' => null,

    // Position of the pages group within the admin navigation menu.
    'admin_navigation_order' => 5,

    // Icon for the pages group in the admin navigation menu.
    'admin_navigation_icon' => 'heroicon-o-document-text',


    // Filament panel identifiers that should register the client-side
    // plugin. Uncomment and list your panel IDs below.
    'clients_panels_ids' => [
        // 'client',
    ],

    // The Eloquent model representing application users.
    'user_model' => \App\Models\User::class,
];

Usage

Admin Panel Setup

use Gigabait93\FilamentPages\AdminPagesPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(AdminPagesPlugin::make());
}

Client Panel Setup

use Gigabait93\FilamentPages\ClientPagesPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(ClientPagesPlugin::make());
}

Service Provider Registration

Make sure to register the service provider in your config/app.php:

'providers' => [
    // ...
    Gigabait93\FilamentPages\Providers\FilamentPagesServiceProvider::class,
],

Or if you're using Laravel 11's automatic package discovery, this will be handled automatically.

Creating Pages

Navigate to the Pages section in your Filament admin panel
Click "New Page" to create a page
Fill in the basic information:
- Name: The display name of the page
- Slug: URL-friendly identifier
- Template: Choose from available templates
- Status: Active/Inactive
- Position: Order in navigation
Add content blocks by clicking "Add Block" and choosing from:
- Text Block: Rich text content
- Markdown Text Block: Markdown formatted text
- Image Block: Single image with caption
- Gallery Block: Multiple images gallery
- Video Block: Video embedding
- Hero Block: Large banner section
- Button Block: Call-to-action buttons
- Two Columns Block: Side-by-side content
- Divider Block: Section separators

Multi-language Support

The plugin supports multi-language pages:

Configure available locales in the config file
Create translations for each page
Content blocks are automatically translatable
Use the language switcher in the admin interface

Available Content Blocks

Text Block

Rich text editor with formatting options:

Rich text content
Typography controls
Link management
List formatting

Image Block

Single image with options:

Image upload
Alt text for SEO
Caption text
Image sizing options

Gallery Block

Multiple image showcase:

Multiple image upload
Image ordering
Lightbox functionality
Grid layout options

Video Block

Video embedding:

YouTube/Vimeo URLs
Local video upload
Autoplay options
Responsive sizing

Hero Block

Large banner sections:

Background image/video
Overlay text
Call-to-action buttons
Alignment options

Button Block

Call-to-action elements:

Button text and URL
Style variants
Icon support
Target options

Custom Templates

You can create custom block templates:

Publish the views: php artisan vendor:publish --tag="filament-pages-views"
Create new template directories in resources/views/vendor/pages/blocks/
Add your custom Blade templates
Templates will be automatically discovered

Example custom template structure:

resources/views/vendor/pages/blocks/
├── custom-template/
│   ├── text.blade.php
│   ├── image.blade.php
│   └── gallery.blade.php

Helper Functions

The plugin provides several helper functions:

page_normalize_blocks()

Normalizes block content array:

$blocks = page_normalize_blocks($page->content);

page_media_url()

Generates media URLs:

$url = page_media_url($imagePath, 'public');

templatesOptions()

Gets available templates:

$templates = templatesOptions();

iconsOptions()

Gets available Heroicons:

$icons = iconsOptions();

Frontend Display

To display pages on the frontend, the plugin automatically registers routes. You can also manually create routes:

use Gigabait93\FilamentPages\Pages\Show;

Route::get('/p/{slug?}', Show::class)->name('pages.show');

Customizing Views

Publish and customize the views:

php artisan vendor:publish --tag="filament-pages-views"

The main page view is located at:

resources/views/vendor/pages/show.blade.php

Block templates are located at:

resources/views/vendor/pages/blocks/

Navigation Integration

Pages are automatically added to navigation menus. You can control this behavior:

Set navigation group in page settings
Choose navigation icon
Set navigation position
Enable/disable navigation visibility

Credits

License

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

Filament Plugin Directory

This plugin is listed in the Filament Plugin Directory.

gigabait93 / filament-pages

Maintainers

Details