Artisan View
This package adds a handful of view-related commands to Artisan in your Laravel project. Generate blade files that extend other views, scaffold out sections to add to those templates, and more. All from the command line we know and love!
Index
Installation
You'll have to follow a couple of simple steps to install this package.
Downloading
Via composer:
$ composer require sven/artisan-view --dev
Registering the service provider
If you're using Laravel 5.5 or above, you can skip this step. The service provider will have already been registered thanks to auto-discovery.
Otherwise, register Sven\ArtisanView\ServiceProvider::class manually in your AppServiceProvider's register method:
public function register()
{
if ($this->app->environment() !== 'production') {
$this->app->register(\Sven\ArtisanView\ServiceProvider::class);
}
}
Usage
If you now run php artisan you will see two new commands in the list:
make:viewscrap:view
Creating views
# Create a view 'index.blade.php' in the default directory
$ php artisan make:view index
# Create a view 'index.blade.php' in a subdirectory ('pages')
$ php artisan make:view pages.index
# Create a view with a different file extension ('index.html')
$ php artisan make:view index --extension=html
Extending and sections
# Extend an existing view
$ php artisan make:view index --extends=app
# Add a section to the view
$ php artisan make:view index --section=content
# Add multiple sections to the view
$ php artisan make:view index --section=title --section=content
# Add an inline section to the view
# Remember to add quotes around the section if you want to use spaces
$ php artisan make:view index --section="title:Hello world"
# Create sections for each @yield statement in the extended view
$ php artisan make:view index --extends=app --with-yields
# Add @push directives for each @stack statement in the extended view
$ php artisan make:view index --extends=app --with-stacks
REST resources
# Create a resource called 'products'
$ php artisan make:view products --resource
# Create a resource with only specific verbs
$ php artisan make:view products --resource --verb=index --verb=create --verb=edit
Scrapping views
# Remove the view 'index.blade.php'
$ php artisan scrap:view index
# Remove the view by dot notation
$ php artisan scrap:view pages.index
This will ask you if you're sure. To skip this question, pass the --force flag:
# Don't ask for confirmation
$ php artisan scrap:view index --force
Scrapping a REST resource
# Remove the resource called 'products'
$ php artisan scrap:view products --resource
This will remove the views products.index, products.show, products.create, and products.edit. If the directory products/ is empty after doing that, it will also be deleted.
You can scrap part of a resource by adding --verb flags:
# Remove the 'products.create' and 'products.edit' views.
$ php artisan scrap:view products --resource --verb=create --verb=edit
Mix and match
Of course, all the options work well together like you'd expect. So the following command...
$ php artisan make:view products --resource --extends=app --section="title:This is my title" --section=content
... will put the following contents in products/index.blade.php, products/edit.blade.php, products/create.blade.php, and products/show.blade.php:
@extends('app')
@section('title', 'This is my title')
@section('content')
@endsection
Contributing
All contributions (in the form on pull requests, issues and feature-requests) are welcome. See the contributors page for all contributors.
License
sven/artisan-view is licenced under the MIT License (MIT). Please see the license file for more information.
149 Dec 29, 2022
4 Dec 21, 2022
227 Dec 25, 2022
17 Aug 25, 2022
12 Jan 17, 2022
151 Dec 6, 2022
572 Aug 6, 2022
1.7k Jan 2, 2023
4 Oct 22, 2022
19 Jul 5, 2021
18 Nov 20, 2022
308 Nov 7, 2022
110 Dec 25, 2022
2 Sep 8, 2022
94 Nov 22, 2022
845 Jan 1, 2023
4 Mar 8, 2022