Filament Page with Sidebar 项目教程

Filament Page with Sidebar 项目教程

filament-page-with-sidebar项目地址:https://gitcode.com/gh_mirrors/fi/filament-page-with-sidebar

项目介绍

Filament Page with Sidebar 是一个用于 Laravel Filament 的开源项目，旨在通过在侧边栏中组织页面，使页面之间的导航更加舒适。该项目支持页面和资源页面，并提供了丰富的配置选项和自定义功能。

项目快速启动

安装

首先，确保你已经安装了 Laravel 和 Filament。然后，通过 Composer 安装 Filament Page with Sidebar：

composer require aymanalhattami/filament-page-with-sidebar

配置

你可以选择发布配置、视图和组件文件：

php artisan vendor:publish --tag="filament-page-with-sidebar-config"
php artisan vendor:publish --tag="filament-page-with-sidebar-views"

使用

在资源页面中使用

假设你有一个 UserResource，你可以通过添加 HasPageSidebar 特性来激活侧边栏：

use AymanAlhattami\FilamentPageWithSidebar\Traits\HasPageSidebar;
use Filament\Resources\Resource;

class UserResource extends Resource
{
    use HasPageSidebar; // 使用这个特性来激活侧边栏

    protected static string $resource = UserResource::class;

    protected function getHeaderActions(): array
    {
        return [
            Actions\EditAction::make(),
        ];
    }
}

在页面中使用

在任何你希望包含侧边栏的页面中，添加 HasPageSidebar 特性，并定义 sidebar 方法：

use AymanAlhattami\FilamentPageWithSidebar\Traits\HasPageSidebar;
use Filament\Pages\Page;

class GeneralSettings extends Page
{
    use HasPageSidebar; // 使用这个特性来激活侧边栏

    public static function sidebar(): FilamentPageSidebar
    {
        return FilamentPageSidebar::make()
            ->setNavigationItems([
                PageNavigationItem::make('General Settings')
                    ->translateLabel()
                    ->url(GeneralSettings::getUrl())
                    ->icon('heroicon-o-cog-6-tooth')
                    ->isActiveWhen(function () {
                        return request()->routeIs(GeneralSettings::getRouteName());
                    })
                    ->visible(true),
                // 其他导航项
            ]);
    }
}

应用案例和最佳实践

应用案例

Filament Page with Sidebar 可以用于各种管理后台，例如：

• 网站设置管理
• 用户管理
• 订单管理

最佳实践

• 模块化设计：将不同的功能模块化，便于管理和维护。
• 自定义导航项：根据实际需求自定义导航项，提高用户体验。
• 权限控制：结合 Laravel 的权限系统，对不同的用户角色进行权限控制。

典型生态项目

Filament Page with Sidebar 可以与其他 Laravel 生态项目结合使用，例如：

• Filament Admin：一个功能强大的管理后台框架。
• Laravel Horizon：用于监控和管理队列。
• Laravel Telescope：用于调试和监控应用。

通过结合这些项目，可以构建一个功能全面、易于管理的应用系统。

filament-page-with-sidebar项目地址:https://gitcode.com/gh_mirrors/fi/filament-page-with-sidebar