https://github.com/nafiesl/laravel-starter-kit
Laravel 5.2 starter kit
https://github.com/nafiesl/laravel-starter-kit
Last synced: 1 day ago
JSON representation
Laravel 5.2 starter kit
- Host: GitHub
- URL: https://github.com/nafiesl/laravel-starter-kit
- Owner: nafiesl
- Created: 2016-03-07T11:41:52.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-11-28T22:53:15.000Z (almost 8 years ago)
- Last Synced: 2025-10-04T00:42:00.698Z (4 days ago)
- Language: PHP
- Size: 1020 KB
- Stars: 4
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Laravel 5.2 Starter Kit
This is a starter kit for building new web application with **Laravel 5.2**.
## Current features
1. User Authentication
- Login & Logout
- Register
- Change Password
- Forgot Password
- User Roles and Permissions
2. Users, Roles, Permissions, References, and Site Options Migration and seeder
3. Users CRUD
4. Site Options
5. Database Backup and Restore
- With [Laravel Backup Manager](https://github.com/backup-manager/laravel) package
- List Backup Files within `/storage/app/backup/db` folder, sort by descending Last Modified time
- Create New Backup File
- Restore database from Backup File
- Download Backup File
- Delete Backup File
- Upload Backup File from local machine
## How to use?
1. Download zip file and Extract to your localhost document directory
- Or clone git repo `$ git clone https://github.com/nafiesl/Laravel-Starter-Kit.git project-name`
2. `$ cd project-name`
3. Install packages dependencies `$ composer install`
4. Duplicate **.env.example** into **.env** : `$ cp .env.example .env`
5. Create new database on MySQL
6. Set your database credential on `.env` file
7. Generate **APP_KEY** : `$ php artisan key:generate`
8. Set permission to storage folder: `$ sudo chmod 777 -R storage`
9. Migrate database : `$ php artisan migrate --seed`
10. Go to `app/Providers/AuthServiceProvider.php` than uncomment line `30-34` and line `45`
```php
public function boot(GateContract $gate)
{
$this->registerPolicies($gate);
// foreach ($this->getPermissions() as $permission) {
// $gate->define($permission->name, function ($user) use ($permission) {
// return $user->hasPermission($permission);
// });
// }
}
protected function getPermissions()
{
// return Permission::with('roles')->get();
}
```
11. Run your installed application with: `php artisan serve`
12. Open `http://localhost:8000` from your browser to access the application
13. Login with seeded credential:
- Login ID : `admin`, password: `admin`
- Login ID : `member`, password: `member`
### What Seeders do?
1. Add 2 Users: **Admin** (with password: *admin*) and **Member** (with password: *member*)
2. Add 2 Roles: `admin` and `member`
3. Assign **Admin** user to `admin` role
4. Assign **Member** user to `member` role
5. Add 4 Permissions: `manage_users`, `manage_options`, `manage_backups`, and `manage_role_permissions`
6. Assign 4 mentioned permission above to `admin` role
## Custom Services
### Site Option
This is like site preferences or settings feature.
We can use **Site Option** like this within blade file :
```php
{{ Option::get('key') }} // value
// or
{{ Option::get('site_title') }} // Laravel App
```
or within Class file:
```php
use Option;
class MasterController extends Controller {
public function getSiteTitle() {
$siteTitle = Option::get('site_title');
return $siteTitle;
}
}
```
### Form Field
This service require [Laravel Collective Package](https://laravelcollective.com/docs/5.2/html) and [Bootstrap 3](http://getbootstrap.com/) to make it work. For example we need a text field within our form:
```php
{!! FormField::text('name') !!}
```
will return
```html
Name
```
Example for Checkbox and Radios.
We can use **numeric array** or **associative array** for Labels and Values :
```php
{!! FormField::checkboxes('group', [1 => 'Admin', 'Member']) !!}
{!! FormField::radios('status', ['a' => 'Active', 'b' => 'Inactive']) !!}
```
will return
```html
Group
Admin
Member
Active
Inactive
```
## License
The Laravel framework is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)