gregoriohc / laravel-preview
Views preview package for Laravel
Requires
- php: >=5.4.0
- illuminate/database: 5.1.*|5.2.*|5.3.*
- illuminate/http: 5.1.*|5.2.*|5.3.*
- illuminate/routing: 5.1.*|5.2.*|5.3.*
- illuminate/support: 5.1.*|5.2.*|5.3.*
- illuminate/view: 5.1.*|5.2.*|5.3.*
Requires (Dev)
- codeclimate/php-test-reporter: dev-master
- mockery/mockery: ^0.9.5
- orchestra/testbench: ~3.0
- phpunit/phpunit: ~4.0
This package is auto-updated.
Last update: 2024-12-17 09:50:21 UTC
README
WARNING: USE THIS PACKAGE ONLY IN LOCAL/DEBUG MODE! ENABLING THIS PACKAGE IN PRODUCTION ENVIRONMENTS CAN REPRESENT A BIG SECURITY ISSUE!
View preview package for Laravel
This package can be used to preview your laravel views without needing to create a route or controller to load the view. It can also be useful if you want to preview your emails views without needing to send them.
Contents
Installation
You can install the package via composer:
composer require gregoriohc/laravel-preview
You must install the service provider:
// config/app.php 'providers' => [ ... Gregoriohc\Preview\PreviewServiceProvider::class, ],
Usage
Now, if you are in local environment with debug mode enabled, you can access the preview route.
The preview route path has the following structure: /_preview/{view}?{params}
The {view}
can be any app or package view, using the dot and namespace notation of Laravel (ex.: welcome, errors.503, mypackage::myview)
For example, if you want to preview the Laravel default welcome page, you can go to: /_preview/welcome
The optional {params}
can be a list of parameters that will be converted to variables and passed to the view. The key of the parameter will be the variable name, and the value will be transformed depending on its format. The possible formats are the following:
- Object from json: If you pass a json string, it will be automatically converted to an object. For example:
user={"name": "John Doe", "email": "johndoe@example.com"}
- Model object: To load a model object, just pass (separated by
::
) the model class (with full namespace) and the object ID you are looking for. For example:user=App\User::1
. - Class method call: To call a class method, just pass (separated by
::
) the class (with full namespace), the method, and a list of params. For example:appname=Config::get::app.name
orsomething=MyClass::myMethod::param_1::param_2::param_3
. If the method is static, it will called statically, if not, a class object will be instantiated and the method will be called. - On any other case, the value will be passed without changes
More examples:
/_preview/emails.user.welcome?user=App\User::1
/_preview/admin.user.show?user=App\User::1
/_preview/mypackage::my.fantastic.view?something=Cache::get::something&anotherthing=textcontent&somenumber=123
Changelog
Please see CHANGELOG for more information what has changed recently.
Testing
$ composer test
Security
If you discover any security related issues, please email gregoriohc@gmail.com instead of using the issue tracker.
Contributing
Please see CONTRIBUTING for details.
Credits
License
The MIT License (MIT). Please see License File for more information.