Download the PHP package afrittella/back-project without Composer

WARNING. This repository is not actively maintained. Probably it's not compatible with latest versions of Laravel.

Back Project 1.3.7

Back Project is an admin panel for Laravel 5.4+ based on AdminLTE and other amazing packages. See Credits for details.

See CHANGELOG.md for detailed updates.

Features

• AdminLTE template
• Easy to use Html components and helpers for panels, buttons, links, icons
• Simple authorization management built on top of spatie/laravel-permission
• Menu management
• Media Manager: you can upload media as backend user or manage all media uploaded by other users as administrator (see Media Manager)
• Social Login

Installation

Add the Service Provider to your config.app service providers list:

Publishing configuration, assets, view, migrations

Configuration

In config/laravel-permission.php change model classes to:

Social login is disabled by default. To use it you must follow these steps:

• Change the following lines in config/back-project.php

• Create Facebook, Twitter and Linkedin applications.

• Once obtained app keys, add them to .env and to config/services.php as shown below.

  .env

  config/service.php

Language

At this time only italian and english language are supported.

Run

Please note: You don't need to publish translation files if you don't want to change default strings.

Default Laravel languages are provided by caousecs/laravel-lang package. You had to manually copy translation files based on the language you will use on your project.

Copy the content of vendor/caouecs/laravel-lang/src/[language-folder] to resources/lang/[language-folder]

BackProject, AdminLTE, Avatar assets and views

You can publish Back Project default views if you want to edit them:

Migrations

Run

Configuration

Queue

Queues can be used to send registration email.

To set up queues:

• Change .env file. Set QUEUE_DRIVER=database
• Change config/back-project.php line: "use_queue" => true,
• Run to create the jobs table
• Run
• Config queue worker as described on Laravel documentation

By default Back Project use classic notification system.

Authorization

BackProject is provided with 3 custom middleware, one of this replaces “RedirectIfAuthenticated”. If you want to use this middleware (it redirects to admin/dashboard if authenticated), you should replace the ”guest” alias in your app/Http/Middleware/Kernel.php with back project custom one and add the other two as follows:

User model

A default User model is provided with the package. It has all the features to make Back Project works well. If you would like to use your custom model, simply extend:

If you are using package model, or if your User model is not present in the default folder, you must change config/auth.php:

Remember to change user_model key in config/back-project.php if you want to use your custom User model.

Back Project simple auth method

Back Project has a simple authorization method, located in Afrittella/BackProject/Http/Controllers/Controller.php

You can use it if you want to simply check if a user is authorized to manage a record. Just use this controller instead of Laravel default controller and call “bCAuthorize” before doing any database action

Exceptions

Back Project has a default exception handler who renders custom error views. To use this handler add the following lines to Exceptions/Handler.php

Let's Start

Once completed the Configuration sections, go to your project's url (www.example.com/register), register and activate the first user who will be the site administrator.

Media Manager

Back Project use intervention/image and intervention/imagecache to manage image upload, resizing and display. Once uploaded, an image can be displayed using imagecache package and default or custom filters. Feel free to create custom filters for your images.

Change config/imagecache.php following this example:

Read the Intervention/Image documentation to know how to use it.

You can use HasOneAttachment or HasManyAttachment trait on a model to associate it to attachments table.

Example:

You can change the folder where files are uploaded in config/filesystems.php

ToDo

• Full documentation on wiki.
• More Tests.
• Better assets (js/css) management.
• Better translations management.

Credits

I was inspired by Backpack for Laravel project, but i tried to make a simple one with only the features I need for my projects. Feel free to open a PR or send a feedback if you would like to collaborate and improve it.

Back Project depends on the following packages:

• almasaeed2010/adminlte
• prologue/alerts
• doctrine/dbal
• spatie/laravel-permission
• kalnoy/nestedset
• pendonl/laravel-fontawesome
• laravelcollective/html
• caouecs/laravel-lang
• intervention/image
• intervention/imagecache

• laravel/socialite

  License

  This package is licensed under the MIT license.