Hit the ground running when building your new Laravel project with boilerplate and extra functionality out of the box!
Check out the official documentation here.
Demo application, just login with user: [email protected]
and password: password
-
Download the project with
git clone https://github.com/laravel-enso/Enso.git
-
Run in the project folder
composer install
-
Configure
.env
file. Runphp artisan key:generate
-
Run
php artisan migrate
-
Login into the project with user:
[email protected]
, password:password
-
(optional) Setup the
config/laravel-enso.php
file -
(optional)
npm install
/npm run dev
Enjoy!
- Customizable and powerful data-tables:
- server side, with multi-argument,
- full column search
- sublime snippet for table template
- server-side excel export for every tables - coming soon
- Bootstrap select - server side builder with parameters conditioning, including pivot parameters
- Advanced owner / roles / permissions structure
- Log management - view, download, clear
- User action logger, so you can keep track of who's done what
- User impersonation function, via middleware
- Bootstrap Tour powered tutorials
- Localisation support
- Charts component with server side data builder
- Comments component with support for tagging users
- Documents component with upload, download and inline view
- Ability to track who created, updated and deleted models, using traits
- File uploader and file management library with VueJS front end component
- Avatar functionality for all users
- Ability to track the different versions of a model through its lifetime
- Front-end date-picker, time-picker and type-ahead components VueJS
- User application preferences - every user has the ability to choose his theme (from 10 variants), set the menu style, app language and more
- Queueable jobs
- Push notifications - working out of the box (requires Pusher)
- Automatic breadcrumbs generation
- Application-wide timestamp formatting customization through the configuration file
- many more helpers and hidden gems
fully working in less than 5 minutes!
- the standard Laravel authentication is used, via email & password
- application wide, checking user status: active/inactive. The check is made for every request, via a middleware. The inactive status prevents the user from logging in and making requests. If an user becomes inactive while he's still logged in, at his next request he'll be logged out and redirected to the login page with a notification
- application-section wide, via the menu visibility, depending on the user's role. The users that don't have access to a certain menu, can't see it. The check is made before each menu redraw. This level doesn't block access to the routes, it just affects the visibility of the menus
- application-section wide, depending on permitted access to routes, which is tied to the user's role and the associated permissions for that role. The check is made for each request, via a middleware. If the user is not allowed on a route a 403 response is given back and a
laravel.log
entry is made. - content specific, via gates & policies. The check is made locally, when and where gates & policies are used
- for the routes within the application, the 'core' middleware group is applied
- the 'core' group contains the middleware below, presented in the order they're applied:
verify-active-state
- checks users's status (active/inactive)action-logger
- logs for each request the user's id, route, url, the HTTP verb and the timestampsverify-route-access
- authorizes the access to a routeimpersonate
- starts and stops the impersonation of a user, when neededset-language
- sets the user's chosen language (localisation)
Owners, Roles & Users
- users represent the operators using the application
- roles are collections of permissions
- owners are user groups, and can represent departments, types, and even companies
- an owner can have many users
- an owner can have many roles
- an user has just one owner and just one role
- the role of a user may only be one of the roles available for its owner
- users have an active or inactive status, where inactive users cannot login or make requests into the application (but can set/reset their password)
The mechanism allows saving and loading upon every request the user's preferences for several aspects of the application.
- the preferences can be updated from the right-hand sidebar. From here the user can also reset the preferences to default.
- the user's preferences are store in the
preferences
table, undervalue
column in JSON format. - list of preferences
lang
- the user's languagetheme
- the currently selected themedtStateSave
- flag for saving the state/preferences for each data-table within the application (for up to 90 days)fixedHeader
- flag for setting the header fixed or scrollablecollapsedSidebar
- flag for setting the starting position of the main sidebar extended or collapsed
- config
- within the configuration file
config/larave-enso.php
various options may be set, such as the folders used for storing uploads, avatars, etc. the caching duration and the timestamps format when displaying them
- within the configuration file
- the implicit
login
event that Laravel fires on a user's login triggers a listener that stores the user's ip, user-agent and timestamps inside thelogins
table
- where needed,
EnsoException
instances are thrown. \EnsoException is also a Facade. - depending on the type of the request (ajax or non ajax) a different response is returned
Built with with ❤️, crafted on Laravel 5.4, Bootstrap 3.3.7, Vuejs 2.x and:
AdminLTE, DataTables, Bootswatch Paper, Chartjs, Font awesome, Toastr.js, Particles.js, Nprogress.js, Bootstrap Tour, Bootstrap Select, Bootstrap Datepicker
Special thanks to Taylor Otwell, Jeffrey Way, Evan You, Allan Jardine and Abdullah Almsaeed.
are welcome. Pull requests are great, but issues are good too.
This package is released under the MIT license.