Rankbeam SEO

• Installation
• What you get
• Requirements
  • Contributing / local development
• Usage
• Structured data (optional)
• Testing
  • Testbench note (provider order)
• License

Add a complete SEO editor to any Filament 4 or 5 resource in two lines. Editors get live Google and social previews, focus keywords, canonical and robots controls, social-image validation, and clear indicators showing whether each value is manual or inherited from Rankbeam's fallback chain.

Free and MIT licensed. Values are stored through rankbeam/laravel-seo, with no extra columns on your resource tables.

Filament guide · Full documentation · Packagist

#Installation

composer require rankbeam/laravel-seo-filament

Installing this package pulls in the core (rankbeam/laravel-seo). If you have not set the core up yet:

php artisan vendor:publish --tag=seo-config
php artisan migrate

#What you get

• Live Google and social previews while editors type.
• Title, description, focus keywords, canonical, robots, and social-image fields.
• Manual-versus-fallback source indicators for every effective value.
• Optional schema.org fields for breadcrumbs, FAQs, and products.
• Filament 4 and 5 support, tested in CI.

#Requirements

Core 2 installs are supported under this constraint: when the newer seoMetaForLocale() helper is not available, the forms hydrate through the older seoMeta() relation.

#Usage

The model behind your resource must use the core HasSEO trait:

use Rankbeam\Seo\Traits\HasSEO;

class Post extends Model
{
    use HasSEO;
}

Then add the section to the resource — two lines:

use Rankbeam\Seo\Filament\Concerns\HasSEOFields;

class PostResource extends Resource
{
    use HasSEOFields;                       // 1

    public static function form(Schema $schema): Schema
    {
        return $schema->components([
            TextInput::make('title'),
            // ...
            static::seoSection(),           // 2
        ]);
    }
}

static::seoSection(['title', 'description']) limits the section to a subset of fields (title, description, focus_keywords, canonical, robots, og_image).

The tabbed Google/social preview is shown by default. Pass showPreview: false to omit it (the source-indicators panel is unaffected):

static::seoSection(showPreview: false);   // or SEOFields::make(showPreview: false)

Without the trait, SEOFields::make() returns the same section directly.

Upgrading: the preview view was replaced by the tabbed editor. If you published the package views, refresh or remove the stale copy — see UPGRADING.md.

#Structured data (optional)

Add a second, optional section so editors can attach schema.org JSON-LD without code:

static::seoSchemaSection(),     // or SEOSchemaFields::make()

It writes into the core seo_meta.schema_jsonld column and is pure UI binding over the core schema builders — a one-toggle automatic breadcrumb (BreadcrumbSchema::fromModelAncestors()) plus a repeater of FAQ (FAQSchema) and Product (ProductSchema) blocks. Every built document is validated by the core SchemaValidator; a malformed block (e.g. a Product with no offer) is rejected on save. Schema it can't represent (a hand-authored @graph, an exotic @type, richer Product fields) is preserved verbatim. See the Filament guide for details.

composer update --with "filament/filament:~4.0" && vendor/bin/pest   # Filament 4 leg
composer update --with "filament/filament:~5.0" && vendor/bin/pest   # Filament 5 leg

#License

MIT — see LICENSE.md.