Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Laravel-Backpack/Base
Until 2018, Backpack v3 used this Base package to offer admin authentication and a blank admin panel using AdminLTE. Backpack v4 no longer uses this package, they're now built-in - use Backpack/CRUD instead.
https://github.com/Laravel-Backpack/Base
admin adminlte laravel
Last synced: about 2 months ago
JSON representation
Until 2018, Backpack v3 used this Base package to offer admin authentication and a blank admin panel using AdminLTE. Backpack v4 no longer uses this package, they're now built-in - use Backpack/CRUD instead.
- Host: GitHub
- URL: https://github.com/Laravel-Backpack/Base
- Owner: Laravel-Backpack
- License: other
- Archived: true
- Created: 2016-02-23T19:11:14.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2020-10-14T12:10:37.000Z (about 4 years ago)
- Last Synced: 2024-08-01T08:07:13.894Z (5 months ago)
- Topics: admin, adminlte, laravel
- Language: PHP
- Homepage: http://backpackforlaravel.com
- Size: 22 MB
- Stars: 916
- Watchers: 58
- Forks: 263
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/Laravel-Backpack/Base/pull/435#issuecomment-708341325)
[](https://travis-ci.org/Laravel-Backpack/base)
[](https://scrutinizer-ci.com/g/laravel-backpack/crud)
[](https://styleci.io/repos/52384487)
[![Total Downloads][ico-downloads]][link-downloads]
**Note: This package is only used by Backpack v3. Starting with Backpack v4, everything this package does is included in [Backpack/CRUD](https://github.com/laravel-backpack/crud) - one package to rule them all.**
Laravel Backpack v3.x's central package, which includes:
- admin login interface, using AdminLTE;
- basic menu;
- pretty error pages;
- alerts system (notification bubbles);
## Install on Laravel 7.x, 8.x and up
Since September 2019, when we released Backpack 4.x, this package is no longer used. Only Backpack 3.x uses Backpack\Base, and Backpack 3.x will not receive support for Laravel 7.x, 8.x and above. We do encourage you to use Backpack + Laravel 7/8/up, but to do that please use [the latest major version of Backpack](https://backpackforlaravel.com/docs).
## Install on Laravel 6, 5.8, 5.7, 5.6 or 5.5
1) Run in your terminal:
``` bash
composer require backpack/base
php artisan backpack:base:install
```
2) Make sure the reset password emails have the correct reset link by adding these to your ```User``` model:
- before class name ```use Backpack\Base\app\Notifications\ResetPasswordNotification as ResetPasswordNotification;```
- as a method inside the User class:
``` php
/**
* Send the password reset notification.
*
* @param string $token
* @return void
*/
public function sendPasswordResetNotification($token)
{
$this->notify(new ResetPasswordNotification($token));
}
```
3) [optional] Change values in config/backpack/base.php to make the admin panel your own. Change menu color, project name, developer name etc.
## Upgrades
### Upgrading from Laravel 5.8 to Laravel 6
- just upgrade your Laravel version and make sure you're running Backpack/Base 1.1.9 or higher;
### Upgrading from Laravel 5.7 to Laravel 5.8 (or from Base 1.0 to Base 1.1)
- Upgrade to Laravel 5.8; you might need to change your ```backpack/crud``` dependency to ```3.6.*``` in your ```composer.json```;
- in your ```App\Models\BackpackUser``` instead of ```Tightenco\Parental\HasParent```, please use ```Backpack\Base\app\Models\Traits\InheritsRelationsFromParentModel```; [here's the diff](https://github.com/Laravel-Backpack/Base/pull/362/files#diff-f075b83ebb2b1ef3ba84dec14b395607);
- in your ```app/config/backpack/base.php``` please change your ```default_date_format``` and ```default_datetime_format``` to ```Do MMMM YYYY``` and ```Do MMMM YYYY, HH:mm``` respectively;
- if you've overwritten ```inc/head.blade.php``` or ```inc/scripts.blade.php```, please make sure you [use the newest version of Bootstrap](https://github.com/Laravel-Backpack/Base/pull/362/files#diff-96ac3ea4d0cb85053acf44e3772eb5f1); they've fixed a security vulnerability (XSS);
## Usage
1. Register a new user at yourappname/admin/register
2. Your admin panel will be available at yourappname/admin or yourappname/login
3. [optional] If you're building an admin panel, you should close the registration. In config/backpack/base.php look for "registration_open" and change it to false.
## Overwriting Functionality
If you need to modify how this works in a project:
- create a ```routes/backpack/base.php``` file; the package will see that, and load _your_ routes file, instead of the one in the package;
- create controllers/models that extend the ones in the package, and use those in your new routes file;
- modify anything you'd like in the new controllers/models;
## Change log
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.
## Security
_Officially_ this package has:
- stopped receiving updates in Sep 2019;
- stopped receiving _security_ updates in Sep 2020;
However, if you discover any security related issues, please email [email protected] and we'll probably push an update nonetheless. Or at least inform people who are still using this version of the vulnerability. We take security seriously, so we'll go above and beyond to make sure our users' admin panels are safe.
Please **[subscribe to the Backpack Newsletter](http://backpackforlaravel.com/newsletter)** so you can find out about any security updates, breaking changes or major features. We send an email every 1-2 months.
## Credits
- [Cristian Tabacitu][link-author]
- [All Contributors][link-contributors]
## License
Backpack is free for non-commercial use and 69 EUR/project for commercial use. Please see [License File](LICENSE.md) and [backpackforlaravel.com](https://backpackforlaravel.com/#pricing) for more information.
## Hire us
We've spend more than 50.000 hours creating, polishing and maintaining administration panels on Laravel. We've developed e-Commerce, e-Learning, ERPs, social networks, payment gateways and much more. We've worked on admin panels _so much_, that we've created one of the most popular software in its niche - just from making public what was repetitive in our projects.
If you are looking for a developer/team to help you build an admin panel on Laravel, look no further. You'll have a difficult time finding someone with more experience & enthusiasm for this. This is _what we do_. [Contact us](https://backpackforlaravel.com/need-freelancer-or-development-team). Let's see if we can work together.
[ico-version]: https://img.shields.io/packagist/v/backpack/base.svg?style=flat-square
[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square
[ico-downloads]: https://img.shields.io/packagist/dt/backpack/base.svg?style=flat-square
[link-packagist]: https://packagist.org/packages/backpack/base
[link-downloads]: https://packagist.org/packages/backpack/base
[link-author]: http://tabacitu.ro
[link-contributors]: ../../contributors