jeremykenedy/laravel-users

Laravel 用户管理 CRUD 包

资助包维护!
jeremykenedy
Patreon

安装: 77,766

依赖项: 2

建议者: 0

安全: 0

星标: 416

关注者: 26

分支: 117

开放问题: 2

语言:Blade

类型:

V4.4.0 2023-11-02 02:58 UTC

README

Laravel Users

Laravel 用户 | 一个 Laravel 用户 CRUD 管理包 Package

一个包含所有必要路由、视图、模型和控制器,用于用户管理仪表板及其关联页面的用户管理 CRUD 包。只需几分钟即可轻松开始创建、更新、编辑和删除用户,无需进行大量设置;轻松搜索所有用户,对大型用户基础非常有用。

Latest Stable Version Total Downloads Travis-CI Build StyleCI Scrutinizer Code Quality License: MIT Become a Patreon

目录

特性

要求

集成

Laravel 用户可以在不使用以下角色包的情况下直接使用,也可以使用

安装说明

  1. 在终端中从项目的根目录运行

    Laravel 5.6, 5.7, 5.8, 6, 7, 和 8+ 使用

        composer require jeremykenedy/laravel-users
    

    Laravel 5.5 使用

        composer require jeremykenedy/laravel-users:2.0.2
    

    Laravel 5.4 使用

        composer require jeremykenedy/laravel-users:1.4.0
    

    Laravel 5.3 使用

        composer require jeremykenedy/laravel-users:1.3.0
    

    Laravel 5.2 使用

        composer require jeremykenedy/laravel-users:1.2.0
    
  2. 注册包

  • Laravel 5.5, 5.6, 5.7, 5.8, 6, 7, 8+ 使用包自动发现功能,无需编辑 config/app.php 文件。

  • Laravel 5.4 及以下版本在 config/app.php 中的 providers 下使用以下命令注册包

       Collective\Html\HtmlServiceProvider::class,
       jeremykenedy\laravelusers\LaravelUsersServiceProvider::class,
    
  1. 注册依赖别名
  • Laravel 5.5 及以上版本使用包自动发现功能,无需编辑 config/app.php 文件。

  • Laravel 5.4 及以下版本在 config/app.php 中的 aliases 下使用以下命令

        'Form' => Collective\Html\FormFacade::class,
        'Html' => Collective\Html\HtmlFacade::class,
    
  1. 从项目的根目录运行以下命令发布包配置和语言文件

        php artisan vendor:publish --tag=laravelusers
    

配置

发布资产后,您可以直接在 /config/laravelusers.php 中配置 Laravel Users。

    /*
    |--------------------------------------------------------------------------
    | Laravel-users setting
    |--------------------------------------------------------------------------
    */

    // The parent blade file
    'laravelUsersBladeExtended'     => 'laravelusers::layouts.app', // 'layouts.app'

    // Enable `auth` middleware
    'authEnabled'                   => true,

    // Enable Optional Roles Middleware on the users assignments
    'rolesEnabled'                  => false,

    /*
     | Enable Roles Middlware on the usability of this package.
     | This requires the middleware from the roles package to be registered in `App\Http\Kernel.php`
     | An Example: of roles middleware entry in protected `$routeMiddleware` array would be:
     | 'role' => \jeremykenedy\LaravelRoles\Middleware\VerifyRole::class,
     */

    'rolesMiddlwareEnabled'         => true,

    // Optional Roles Middleware
    'rolesMiddlware'                => 'role:admin',

    // Optional Role Model
    'roleModel'                     => 'jeremykenedy\LaravelRoles\Models\Role',

    // Enable Soft Deletes - Not yet setup - on the roadmap.
    'softDeletedEnabled'            => false,

    // Laravel Default User Model
    'defaultUserModel'              => 'App\User',

    // Use the provided blade templates or extend to your own templates.
    'showUsersBlade'                => 'laravelusers::usersmanagement.show-users',
    'createUserBlade'               => 'laravelusers::usersmanagement.create-user',
    'showIndividualUserBlade'       => 'laravelusers::usersmanagement.show-user',
    'editIndividualUserBlade'       => 'laravelusers::usersmanagement.edit-user',

    // Use Package Bootstrap Flash Alerts
    'enablePackageBootstapAlerts'   => true,

    // Users List Pagination
    'enablePagination'              => true,
    'paginateListSize'              => 25,

    // Enable Search Users- Uses jQuery Ajax
    'enableSearchUsers'             => true,

    // Users List JS DataTables - not recommended use with pagination
    'enabledDatatablesJs'           => false,
    'datatablesJsStartCount'        => 25,
    'datatablesCssCDN'              => 'https://cdn.datatables.net/1.10.12/css/dataTables.bootstrap.min.css',
    'datatablesJsCDN'               => 'https://cdn.datatables.net/1.10.12/js/jquery.dataTables.min.js',
    'datatablesJsPresetCDN'         => 'https://cdn.datatables.net/1.10.12/js/dataTables.bootstrap.min.js',

    // Bootstrap Tooltips
    'tooltipsEnabled'               => true,
    'enableBootstrapPopperJsCdn'    => true,
    'bootstrapPopperJsCdn'          => 'https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.12.9/umd/popper.min.js',

    // Icons
    'fontAwesomeEnabled'            => true,
    'fontAwesomeCdn'                => 'https://use.fontawesome.com/releases/v5.0.6/css/all.css',

    // Extended blade options for packages app.blade.php
    'enableBootstrapCssCdn'         => true,
    'bootstrapCssCdn'               => 'https://maxcdn.bootstrap.ac.cn/bootstrap/4.0.0/css/bootstrap.min.css',

    'enableAppCss'                  => true,
    'appCssPublicFile'              => 'css/app.css',

    'enableBootstrapJsCdn'          => true,
    'bootstrapJsCdn'                => 'https://maxcdn.bootstrap.ac.cn/bootstrap/4.0.0/js/bootstrap.min.js',

    'enableAppJs'                   => true,
    'appJsPublicFile'               => 'js/app.js',

    'enablejQueryCdn'               => true,
    'jQueryCdn'                     => 'https://code.jqueryjs.cn/jquery-3.3.1.min.js',

路由

  • /users
  • /users/{id}
  • /users/create
  • /users/{id}/edit
路由深入

所需包

(包含在此包中)

截图

Show Users Show User Edit User Edit User Password Create User Create User Modal Delete User Modal Error Create Error Update Error Delete

文件树

laravel-users/
├── .env.travis
├── .gitignore
├── .travis.yml
├── LICENSE
├── composer.json
├── phpunit.xml
├── readme.md
└── src
    ├── App
    │   └── Http
    │       └── Controllers
    │           └── UsersManagementController.php
    ├── LaravelUsersFacade.php
    ├── LaravelUsersServiceProvider.php
    ├── config
    │   └── laravelusers.php
    ├── resources
    │   ├── lang
    │   │   └── en
    │   │       ├── app.php
    │   │       ├── forms.php
    │   │       ├── laravelusers.php
    │   │       └── modals.php
    │   └── views
    │       ├── layouts
    │       │   └── app.blade.php
    │       ├── modals
    │       │   ├── modal-delete.blade.php
    │       │   └── modal-save.blade.php
    │       ├── partials
    │       │   ├── bs-visibility-css.blade.php
    │       │   ├── form-status.blade.php
    │       │   ├── search-users-form.blade.php
    │       │   └── styles.blade.php
    │       ├── scripts
    │       │   ├── check-changed.blade.php
    │       │   ├── datatables.blade.php
    │       │   ├── delete-modal-script.blade.php
    │       │   ├── save-modal-script.blade.php
    │       │   ├── search-users.blade.php
    │       │   ├── toggleText.blade.php
    │       │   └── tooltips.blade.php
    │       └── usersmanagement
    │           ├── create-user.blade.php
    │           ├── edit-user.blade.php
    │           ├── show-user.blade.php
    │           └── show-users.blade.php
    └── routes
        └── web.php

  • 可以使用 brew 安装 tree 命令:brew install tree
  • 使用以下命令生成文件树:tree -a -I '.git|node_modules|vendor|storage|tests'

打开一个问题

在打开问题之前有一些考虑事项

  • 你们都太棒了!
  • 阅读说明 并确保所有步骤都 正确遵循
  • 检查 问题是否不是针对您的开发环境 特定 设置。
  • 提供 复现步骤
  • 尝试调查 问题,如果您 有解决方案,请提交一个 pull request
  • 显示您已尝试 调查问题
  • 检查 您正在 报告的问题是否是以前报告的问题的重复
  • 遵循这些说明表明您已尝试。
  • 如果您有任何问题,请发送电子邮件至 jeremykenedy@gmail.com
  • 需要帮助吗?我可以在Slack上尽力协助您: https://opensourcehelpgroup.slack.com
  • 请体谅这是一个开源项目,我在提交问题时免费提供给社区。

许可证

Laravel 用户 | Laravel 用户管理包是开源软件,遵循 MIT 许可协议。祝您使用愉快!