README

仪表盘包是一个即插即用的Laravel包，它为您的Laravel项目提供快速简便的仪表盘集成，内置可自定义的资产，用于分析、用户、角色、权限和服务条款管理。

要求

Laravel 5.8
Laratrust 5.2

安装

使用PHP依赖管理器composer安装此包。

composer require rwbuild/dashboard

设置

安装完成后，运行

php artisan dashboard:setup

此命令将在database > migrations中创建迁移文件。在继续之前，请先运行迁移命令。

php artisan migrate

安装

01

迁移命令成功运行后，运行以下命令将仪表盘安装到您的应用程序中。

php artisan dashboard:install

然后，

php artisan migrate

02

成功运行此命令后，您的文件夹结构应发生变化，看起来像这样

在app>Http>Controllers内，将创建一个包含控制器文件的Dashboard文件夹。

在app>Http>View>Composers内将生成视图组合器文件，为Blade视图提供动力。

在app>Helpers内还将生成一个助手类，您可以在此处放置您的辅助函数以进行个性化定制。

在resources>views内，将创建一个包含Blade文件的dashboard文件夹。这些是可以自定义的视图，为仪表盘提供动力。

在routes/web.php和api.php中，文件将被更新为仪表盘路由，看起来应该是这样的

...
/*
|--------------------------------------------------------------------------
| Dashboard Routes
|--------------------------------------------------------------------------
*/
Route::group(['namespace' => 'Dashboard', 'prefix' => 'dashboard'], function () {
    ...
});

在public>css文件夹中，您应该有包含仪表盘所有样式的dashboard.css文件。

在public>js文件夹中，您应该有dashboard.js和dashboard_analytics.js文件。

03

在AppServiceProvider.php中加载视图组合器类

use App\Http\View\Composers\Dashboard\ { 
    TosComposer,
    HomeComposer,
    UsersComposer,
    RolesComposer,
    ReportsComposer,
    PermissionsComposer
};
...
   public function boot()
    {
        View::composer('dashboard::assets.home', HomeComposer::class);
        View::composer('dashboard::assets.users', UsersComposer::class);
        View::composer('dashboard::assets.roles', RolesComposer::class);
        View::composer('dashboard::assets.permissions', PermissionsComposer::class);
        View::composer('dashboard::assets.tos', TosComposer::class);
        View::composer('dashboard::assets.reports', ReportsComposer::class);
    }

04

在composer.json中添加助手文件

...
"files": [
    "app/Helpers/DashboardHelpers.php"
]
...

Then run composer dump-autoload

05

转到app>Http>Kernel.php并添加中间件到您的$routeMiddleware数组中

...
'visit.log' => \Dashboard\Http\Middlewares\LogVisit::class

您应该将此中间件添加到您的web路由中，以记录用户的网站访问。

在您的主布局或入口文件中包含dashboard_analytics.js文件

    <script src="{{ asset('js/dashboard_analytics.js') }}"></script>

• 功能访问

  要获取用户访问的点击或功能的分析，请在目标事件上调用函数daFeatureVisit(featureName)

  例如。

      onclick="daFeatureVisit('apply')"

配置

为了使包正常工作，请检查配置是否设置正确。在config文件夹中，您应该找到包含应用程序模型配置的dashboardmodels.php。这告诉包在哪里查找模型。根据模型指向的命名空间配置每个键。

At this point, you should be able to navigate to /dashboard and get it working. 

深入研究

在包的控制器中访问模型

可以通过以下方式在仪表盘控制器中执行对模型的所有操作

使用模型外观

...
use Dashboard\Facades\Model;
...

public function index()
{
    return Model::user()::all();
}
...

使用模型定义特性

...
use ModelsDefinition;

public function show()
{
    return $this->user::findOrFail(1);
}
...

享受乐趣 😎

许可证

MIT