rectitude-open/filament-photos

Filament Photos is a Filament plugin for managing curated photo collections and galleries.

v1.8.0 2025-07-19 03:56 UTC

README

Filament Photos Banner

Filament Photos

Do not use Tests PHPStan Latest Version on Packagist Total Downloads PRs Welcome

Filament Photos is a Filament plugin that adds a dedicated photo management section to your Filament admin panel. Unlike basic media management, this plugin is designed for organizing and showcasing curated photo collections such as company equipment displays, team activities, project galleries, or any categorized photo content that requires structured presentation.

The plugin provides a complete photo management system with categories, SEO optimization, and an intuitive admin interface, making it perfect for businesses and organizations that need to manage and display their visual content professionally.

This package is also a standalone part of a CMS project: FilaPress.

Note: This plugin relies on several excellent Laravel/Filament plugins. Before installing Filament Photos, you must ensure that all the following dependencies are installed and properly configured in your project. Eloquent Sluggable, Filament SEO, Filament Curator, Filament Tree

Resource Page Cluster Migration Model Config View Localization

Installation

You can install the package via composer:

composer require rectitude-open/filament-photos

You can publish and run the migrations with:

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

You can publish the config file with:

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

Optionally, you can publish the translations using

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

This is the contents of the published config file:

return [
    'cluster' => [
        'navigation_sort' => 0,
        'navigation_icon' => 'heroicon-o-photo',
    ],
    'photo' => [
        'navigation_sort' => 0,
        'navigation_icon' => 'heroicon-o-photo',
        'datetime_format' => 'Y-m-d H:i:s',
        'navigation_badge' => false,
        'model' => \RectitudeOpen\FilamentPhotos\Models\Photo::class,
        'filament_resource' => \RectitudeOpen\FilamentPhotos\Filament\Resources\PhotoResource::class,
    ],
    'photo_category' => [
        'model' => \RectitudeOpen\FilamentPhotos\Models\PhotoCategory::class,
        'page' => \RectitudeOpen\FilamentPhotos\Filament\Pages\PhotoCategory::class,
        'navigation_sort' => 2,
        'navigation_icon' => 'heroicon-o-rectangle-stack',
    ],
    'editor_component_class' => \Filament\Forms\Components\RichEditor::class,
];

Usage

The package provides a resource page that allows you to view photos in your Filament admin panel.

To use the resource page provided by this package, you need to register it in your Panel Provider first.

namespace App\Providers\Filament;

use RectitudeOpen\FilamentPhotos\FilamentPhotosPlugin;

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->plugins([
                FilamentPhotosPlugin::make()
            ]);
    }
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

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