Skip to content

gregoriohc/laravel-preview

Repository files navigation

Preview

Latest Version on Packagist Software License Build Status StyleCI Quality Score Code Climate Test Coverage Total Downloads

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": "[email protected]"}
  • 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 or something=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 [email protected] 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.