backpack/base

Laravel Backpack's base package, which offers admin authentication and a blank admin panel using AdminLTE

1.1.13 2019-09-17 09:02 UTC

README

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Style CI Total Downloads

Laravel Backpack v3.x's central package, which includes:

  • admin login interface, using AdminLTE;
  • basic menu;
  • pretty error pages;
  • alerts system (notification bubbles);

Note: This package is only used by Backpack v3. Starting with Backpack v4, everything this package does is included in Backpack/CRUD - one package to rule them all.

Security updates and breaking changes

Please subscribe to the Backpack Newsletter so you can find out about any security updates, breaking changes or major features. We send an email every 1-2 months.

Example generated CRUD interface

Install on Laravel 6, 5.8, 5.7, 5.6 or 5.5

  1. Run in your terminal:
composer require backpack/base
php artisan backpack:base:install
  1. 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:
  /**
   * Send the password reset notification.
   *
   * @param  string  $token
   * @return void
   */
  public function sendPasswordResetNotification($token)
  {
      $this->notify(new ResetPasswordNotification($token));
  }
  1. [optional] Change values in config/backpack/base.php to make the admin panel your own. Change menu color, project name, developer name etc.

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;
  • 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; 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.

Example generated CRUD interface

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 for more information what has changed recently.

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email hello@tabacitu.ro instead of using the issue tracker.

Please subscribe to the Backpack Newsletter so you can find out about any security updates, breaking changes or major features. We send an email every 1-2 months.

Credits

License

Backpack is free for non-commercial use and 49 EUR/project for commercial use. Please see License File and backpackforlaravel.com 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. Let's see if we can work together.