README

Nexus 是一个基于 Laravel 框架的 Admin 控制面板

安装

需求

• Composer
• Laravel 框架 6.x/7.x/8.x
• Laravel Mix
• Node.js & NPM

安装 Nexus

在控制台终端运行以下命令

$ composer require zrkb/nexus

或者如果您想下载文件，请将以下配置添加到 composer.json 文件中

    "repositories": [
        {
            "type": "path",
            "url": "../nexus"
        }
    ],

现在运行

$ composer require zrkb/nexus @dev

数据库凭证

接下来请确保创建一个新的数据库，并将您的数据库凭证添加到 .env 文件中

DB_HOST=localhost
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=secret

运行安装程序

最后，运行安装命令和迁移 Artisan 命令。

$ php artisan nexus:install

管理员用户

为了为管理员面板创建用户，请运行以下命令

$ php artisan nexus:user

管理员用户提供者

您的管理员用户必须从 Nexus Admin 模型继承，您可以在 nexus.php 配置文件中更改此设置

'providers' => [
    'admins' => [
        'driver' => 'eloquent',
        'model' => \Nexus\Models\Admin::class,
    ],

    // ...
],

用法

定义资源

您可以使用 nexus:crud Artisan 命令生成新的资源

$ php artisan nexus:crud Bookmark

这将创建以下文件

// Model
app/Models/Bookmark.php

// Controller
app/Http/Controllers/Backend/BookmarkController.php

// Migration
database/migrations/YYYY_MM_DD_HHIISS_create_bookmarks_table.php

// Views
resources/views/bookmarks/create.blade.php
resources/views/bookmarks/edit.blade.php
resources/views/bookmarks/form.blade.php
resources/views/bookmarks/index.blade.php
resources/views/bookmarks/show.blade.php

注意：您可能需要运行 php artisan migrate 命令以在数据库中创建表。

注册资源

资源创建完成后，我们需要将它们添加到项目中

1. 添加路由

编辑您的 routes/web.php 文件和新的资源

Nexus::resource('bookmarks', 'BookmarkController');

或等效的

Nexus::group(function () {
    Route::resource('bookmarks', 'BookmarkController');
});

2. 添加到侧边栏

编辑您的 resources/views/vendor/nexus/sidebar/user.blade.php 文件并添加以下代码

<li>
    <a href="{{ route('bookmarks.index') }}"
        class="nav-link {{ is_route('bookmarks.index') ? 'active' : '' }}"
        role="button">
        <i class='bx bx-bookmarks'></i>
        <span>Bookmarks</span>
    </a>
</li>

这就完成了！您可以刷新仪表板页面，您将看到侧边栏中有一个新的项目，点击它并探索您的新资源。

待办事项

• 在创建资源时自动为开发者角色分配权限
• 在登录时添加用于 认证路由重定向 的中间件
• 迁移文件占位符
• 菜单管理
• 媒体库管理
• 占位符文件的条件（案例：不是所有模型都将使用软删除功能）
• 分析 Scaffold 与运行时生成
• 将博客作为一个包分离

安全

如果您发现任何安全相关的问题，请使用问题跟踪器。

致谢

• Felix Ayala

许可

MIT 许可证 (MIT)。请参阅 许可文件 获取更多信息。