Blade layout extension system for Yii2 framework.
This module adds support to Blade Layout system in your Yii2 app installation.
Developed by Joseba Juániz (@Patroklo)
This is free software. It is released under the terms of the following BSD License.
Copyright (c) 2014, by Cyneek All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
"cyneek/yii2-blade": "*"
...
'components' => [
'view' => [
'class' => 'yii\web\View',
'renderers' => [
'blade' => [
'class' => '\cyneek\yii2\blade\ViewRenderer',
'cachePath' => '@runtime/blade_cache',
],
],
],
]
...
.blade
for your view files, it should be stated here as well as in the array key of the renderers array.layout
parameterIt's possible to define the controller's parameter layout
with a Blade file. But since the Yii2 view render system it's not 100% compatible with the Blade Layout rendering, you'll have to add a behavior to that controller called BladeBehavior
that will integrate both systems.
To add this behavior you'll only have to include:
public function behaviors()
{
return [
...
'blade' => [
'class' => BladeBehavior::className()
],
...
];
}
Then the layout view file will be rendered before the views if both layout and view files have a blade file extension. If not, Yii2 normal rendering system will be used instead.
$view
instead of $this
The object $this
can't be used in Blade templates due to compatibility problems with the Blade system callings.
So, instead of this object I made the $view
object that has the same functionalities than the $this
in a normal layout system.
For example , if you want to pass $this->title
from content view to layout view, just use $view->title
,and in the layout view , you can get title by using $this->title
.
The Laravel framework documentation has an extensive guide about how to work with Blade template system. Everything should be compatible with this module since it uses the same libraries in the background.
Comments