README

Laravel 项目的一个启动套件。

安装

1-使用 composer 安装包

 composer require xmen/starter-kit

2-使用以下命令发布并运行迁移

php artisan vendor:publish --provider="Xmen\StarterKit\StarterKitServiceProvider" --tag="migrations"
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="migrations"
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
php artisan migrate

3-使用以下命令发布资源

php artisan vendor:publish --provider="Xmen\StarterKit\StarterKitServiceProvider" --tag="assets"
php artisan vendor:publish --provider="Xmen\StarterKit\StarterKitServiceProvider" --tag="fonts"

4-使用以下命令发布语言文件

php artisan vendor:publish --provider="Xmen\StarterKit\StarterKitServiceProvider" --tag="lang"

5-将 StarterKit 特性添加到 User 模型

use Xmen\StarterKit\Models\StarterKit;

class User extends Authenticatable {
    use StarterKit;
...
}

6-在 RouteServiceProvider 中将主页路径更改为仪表板

//app/Providers/RouteServiceProvider.php

public const HOME = '/dashboard';

7-在 Kernel.php 中添加 role 中间件

    //app/Http/Kernel.php

    protected $routeMiddleware = [
        ...
        'role' => \Spatie\Permission\Middlewares\RoleMiddleware::class,
    ];

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="Xmen\StarterKit\StarterKitServiceProvider" --tag="config"

这是已发布配置文件的内容

return [
    //The dashboard uri
    'uri'=>'dashboard',
];

使用方法

通过运行 install 命令创建管理员用户，然后登录仪表板

php artisan starter-kit:install

如果需要登录/注册，请安装 laravel/ui

Laravel 9 及以上版本

composer require laravel/ui
php artisan ui vue
php artisan ui vue --auth

Laravel 8.x

composer require laravel/ui
php artisan ui bootstrap
php artisan ui vue
php artisan ui bootstrap --auth

Laravel 6.x & 7.x

composer require laravel/ui "^2.4"
php artisan ui bootstrap
php artisan ui vue
php artisan ui bootstrap --auth

修复认证页面 CSS

您必须将此行添加到 app.layout.blade.php

<link href="{{ asset('vendor/starter-kit/css/app.css') }}" rel="stylesheet">

Laravel Scout

一些模型已经与 Scout 和 tntsearch 驱动器集成，例如 Post 模型。您可以在这些模型中使用 Scout 的功能。

如果您在现有项目中安装了启动套件，您可以使用以下命令导入模型

php artisan scout:import \\Xmen\\StarterKit\\Models\\Post

更多信息请参阅 scout 文档

JavaScript

在自定义 starterKit 时，您可以使用全局可用的各种助手来为您的 JavaScript 组件提供服务。 $，axios，chart，alertify 是全局可用的。

添加 JavaScript 和 CSS

您可以将具有名称和文件路径的 javascript 和 css 文件添加到仪表板。

\StarterKit::script('new-chart',resource_path('js/new-chart.js'));
\StarterKit::style('new-color',resource_path('scss/new-color.css'));

更新

在更新到新的 StarterKit 版本后，您应确保使用 publish 命令更新 StarterKit 的 JavaScript 和 CSS 资产以及语言文件，并使用 view:clear 清除任何缓存的视图。这将确保新更新的 StarterKit 版本使用最新版本。

php artisan starter-kit:publish --force

备注

如果您遇到 Laravel mix 问题，/vendor/xmen/starter-kit/package-sample.json 可能会帮助您。顺便说一句，别忘了备份您的 package.json

添加波斯语 jdate & 修复分页

// AppServiceProvider.php top of file
use Xmen\StarterKit\Helpers\TDate;

// in the boot function
public function boot()
{
    //
    Carbon::setLocale('fa_IR');

    Carbon::macro('jdate', function ($format) {
        $dt = new TDate();
        return $dt->PDate($format,self::this()->timestamp);
    });

    Paginator::useBootstrap();
}

使用波斯语日期

然后，您可以在任何地方使用您自定义的格式，如下所示。

$user->created_at->jdate('Y/m/d');

测试

composer test

翻译您的语言或单词

 php artisan vendor:publish --provider="Translator\Framework\TranslatorServiceProvider"

安全

如果您发现任何与安全相关的问题，请通过电子邮件 sadeghpm@gmail.com 反馈，而不是使用问题跟踪器。

致谢

截图 & 在线教程（波斯语）

https://aparat.com/v/TAvPy

许可证

MIT 许可证（MIT）。有关更多信息，请参阅许可证文件。

xmen / starter-kit

维护者

详细信息