An admin panel for news with categories and tags, using Backpack CRUD on Laravel 5.2 or 5.3.
PHP
Latest commit 3bbc2cc Nov 11, 2016 @tabacitu tabacitu committed on GitHub Update README.md

README.md

Backpack\NewsCRUD

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

An admin panel for menu items on Laravel 5, using Backpack\CRUD. Add, edit, reorder, nest, rename menu items and link them to Backpack\PageManager pages, external link or custom internal link.

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.

Install

Since NewsCRUD is just a Backpack\CRUD example, you can choose to install it one of two ways.

(A) Download and place files in your application (recommended)

or

(B) As a package

The only PRO of installing it as a package is that you may benefit from updates. But the reality is there is very little (if any) bug fixing to do, so you probably won't need to update it, ever.

Installation type (A) - download

1) Download the latest build.

2) Paste the 'app' and 'database' folders over your projects (merge them). No file overwrite warnings should come up.

3) Replace all mentions of 'Backpack\NewsCRUD\app' in the pasted files with your application's namespace ('App' if you haven't changed it):

  • app/Http/Controllers/Admin/ArticleCrudController.php
  • app/Http/Controllers/Admin/CategoryCrudController.php
  • app/Http/Controllers/Admin/TagCrudController.php
  • app/Http/Requests/ArticleRequest.php
  • app/Http/Requests/CategoryRequest.php
  • app/Http/Requests/TagRequest.php
  • app/Models/Article.php
  • app/Models/Category.php
  • app/Models/Tag.php

4) Run the migration to have the database table we need:

php artisan migrate

5) Add NewsCRUD to your routes file:

Route::group(['prefix' => 'admin', 'middleware' => ['web', 'auth'], 'namespace' => 'Admin'], function () {
    // Backpack\NewsCRUD
    CRUD::resource('article', 'ArticleCrudController');
    CRUD::resource('category', 'CategoryCrudController');
    CRUD::resource('tag', 'TagCrudController');
});

6) [optional] Add a menu item for it in resources/views/vendor/backpack/base/inc/sidebar.blade.php or menu.blade.php:

<li class="treeview">
    <a href="#"><i class="fa fa-newspaper-o"></i> <span>News</span> <i class="fa fa-angle-left pull-right"></i></a>
    <ul class="treeview-menu">
      <li><a href="{{ url('admin/article') }}"><i class="fa fa-newspaper-o"></i> <span>Articles</span></a></li>
      <li><a href="{{ url('admin/category') }}"><i class="fa fa-list"></i> <span>Categories</span></a></li>
      <li><a href="{{ url('admin/tag') }}"><i class="fa fa-tag"></i> <span>Tags</span></a></li>
    </ul>
</li>

Installation type (B) - package

1) In your terminal, run:

$ composer require backpack/newscrud

2) Then add the service providers to your config/app.php file:

'Backpack\NewsCRUD\NewsCRUDServiceProvider',

3) Publish the migration:

php artisan vendor:publish --provider="Backpack\NewsCRUD\NewsCRUDServiceProvider"

4) Run the migration to have the database table we need:

php artisan migrate

5) [optional] Add a menu item for it in resources/views/vendor/backpack/base/inc/sidebar.blade.php or menu.blade.php:

<li class="treeview">
    <a href="#"><i class="fa fa-newspaper-o"></i> <span>News</span> <i class="fa fa-angle-left pull-right"></i></a>
    <ul class="treeview-menu">
      <li><a href="{{ url('admin/article') }}"><i class="fa fa-newspaper-o"></i> <span>Articles</span></a></li>
      <li><a href="{{ url('admin/category') }}"><i class="fa fa-list"></i> <span>Categories</span></a></li>
      <li><a href="{{ url('admin/tag') }}"><i class="fa fa-tag"></i> <span>Tags</span></a></li>
    </ul>
</li>

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

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 $19/project for commercial use. Please see License File and backpackforlaravel.com for more information.