slim / views
Smarty and Twig View Parser package for the Slim Framework
Installs: 1 377 879
Dependents: 67
Suggesters: 0
Security: 0
Stars: 308
Watchers: 30
Forks: 57
Open Issues: 17
Requires
- php: >=5.3.0
- slim/slim: >=2.4.0
Suggests
- smarty/smarty: Smarty templating system
- twig/twig: Twig templating system
This package is auto-updated.
Last update: 2022-11-10 10:19:46 UTC
README
This repository contains custom View classes for the template frameworks listed below. You can use any of these custom View classes by either requiring the appropriate class in your Slim Framework bootstrap file and initialize your Slim application using an instance of the selected View class or using Composer (the recommended way).
Slim Views only officially support the following views listed below.
- Smarty
- Twig
How to Install
using Composer
Install in your project by running the following composer command:
$ php composer require slim/views
Smarty
How to use
<?php require 'vendor/autoload.php'; $app = new \Slim\Slim(array( 'view' => new \Slim\Views\Smarty() ));
To use Smarty options do the following:
$view = $app->view(); $view->parserDirectory = dirname(__FILE__) . 'smarty'; $view->parserCompileDirectory = dirname(__FILE__) . '/compiled'; $view->parserCacheDirectory = dirname(__FILE__) . '/cache';
Twig
How to use
<?php require 'vendor/autoload.php'; $app = new \Slim\Slim(array( 'view' => new \Slim\Views\Twig() ));
To use Twig options do the following:
$view = $app->view(); $view->parserOptions = array( 'debug' => true, 'cache' => dirname(__FILE__) . '/cache' );
In addition to all of this we also have a few helper functions which are included for both view parsers. In order to start using these you can add them to their respective view parser as stated below:
Twig
$view->parserExtensions = array( new \Slim\Views\TwigExtension(), );
Smarty
$view->parserExtensions = array( dirname(__FILE__) . '/vendor/slim/views/Slim/Views/SmartyPlugins', );
These helpers are listed below.
- urlFor
- siteUrl
- baseUrl
- currentUrl
urlFor
Twig
Inside your Twig template you would write:
{{ urlFor('hello', {"name": "Josh", "age": "19"}) }}
You can easily pass variables that are objects or arrays by doing:
<a href="{{ urlFor('hello', {"name": person.name, "age": person.age}) }}">Hello {{ name }}</a>
If you need to specify the appname for the getInstance method in the urlFor functions, set it as the third parameter of the function in your template:
<a href="{{ urlFor('hello', {"name": person.name, "age": person.age}, 'admin') }}">Hello {{ name }}</a>
Smarty
Inside your Smarty template you would write:
{urlFor name="hello" options="name.Josh|age.26"}
or with the new array syntax:
{urlFor name="hello" options=["name" => "Josh", "age" => "26"]}
You can easily pass variables that are arrays as normal or using the (.):
<a href="{urlFor name="hello" options="name.{$person.name}|age.{$person.age}"}">Hello {$name}</a>
If you need to specify the appname for the getInstance method in the urlFor functions, set the appname parameter in your function:
<a href="{urlFor name="hello" appname="admin" options="name.{$person.name}|age.{$person.age}"}">Hello {$name}</a>
siteUrl
Twig
Inside your Twig template you would write:
{{ siteUrl('/about/me') }}
Smarty
Inside your Smarty template you would write:
{siteUrl url='/about/me'}
baseUrl
Twig
Inside your Twig template you would write:
{{ baseUrl() }}
Smarty
Inside your Smarty template you would write:
{baseUrl}
currentUrl
Twig
Inside your Twig template you would write:
{{ currentUrl() }}
Smarty
Inside your Smarty template you would write:
{currentUrl}
Authors
License
MIT Public License