projek-xyz / slim-plates
Render your Slim 3 application views using Plates template engine.
Fund package maintenance!
feryardiant
creasico
Installs: 51 139
Dependents: 2
Suggesters: 0
Security: 0
Stars: 27
Watchers: 6
Forks: 2
Open Issues: 0
Requires
- php: >=5.5.0
- league/plates: ~3.1
- slim/slim: ~3.0
Requires (Dev)
- phpunit/phpunit: ~4.0
- squizlabs/php_codesniffer: ~2.7
This package is auto-updated.
Last update: 2024-10-22 18:42:01 UTC
README
Plates Template Integration for Slim micro framework 3
Render your Slim 3 application views using Plates template engine.
Install
Via Composer
$ composer require projek-xyz/slim-plates --prefer-dist
Requires Slim micro framework 3 and PHP 5.5.0 or newer.
Usage
// Create Slim app $app = new \Slim\App(); // Fetch DI Container $container = $app->getContainer(); // Register Plates View helper: // Option 1, using PlatesProvider $container->register(new \Projek\Slim\PlatesProvider); // Option 2, using Closure $container['view'] = function ($c) { $view = new \Projek\Slim\Plates([ // Path to view directory (default: null) 'directory' => 'path/to/views', // Path to asset directory (default: null) 'assetPath' => 'path/to/static/assets', // Template extension (default: 'php') 'fileExtension' => 'tpl', // Template extension (default: false) see: http://platesphp.com/extensions/asset/ 'timestampInFilename' => false, ]); // Set \Psr\Http\Message\ResponseInterface object // Or you can optionaly pass `$c->get('response')` in `__construct` second parameter $view->setResponse($c->get('response')); // Instantiate and add Slim specific extension $view->loadExtension(new Projek\Slim\PlatesExtension( $c->get('router'), $c->get('request')->getUri() )); return $view; }; // Define named route $app->get('/hello/{name}', function ($request, $response, $args) { return $this->view->render('profile', [ 'name' => $args['name'] ]); })->setName('profile'); // Run app $app->run();
NOTE:
- If you are using option 1 please make sure you already have
$container['settings']['view']
in your configuration file. Plates::setResponse()
is required to usePlates::render()
otherwise\LogicException
will thrown.
Custom functions
This component exposes some Slim functions to your Plates templates.
pathFor()
You can use this function to generate complete URLs to any Slim application named route. Example:
<?php $this->layout('base-template') ?> <?php $this->start('body') ?> <h1>Hallo <?=$this->e($name)?></h1> <small><?=$this->pathFor('profile', ['name'=> $name])?></small> <?php $this->stop() ?>
baseUrl($permalink = '')
Retrieve the base url of your Slim application. Example:
<a href="<?=$this->baseUrl()?>">Some Link</a>
Or you can pass a permalink
<a href="<?=$this->baseUrl('some/path')?>">Some Other Link</a>
basePath()
Retrieve the base url of your Slim application. Example:
<link rel="stylesheet" href="<?=$this->basePath().'asset/css/main.css'?>">
uriFull()
Retrieve full request URI.
uriScheme()
Retrieve the scheme component of the URI.
uriHost()
Retrieve the host component of the URI
uriPort()
Retrieve the port component of the URI.
uriPath()
Retrieve the path component of the URI.
uriQuery()
Retrieve the query string component of the URI.
uriFragment()
Retrieve the fragment component of the URI.
Contributing
Please see CONTRIBUTING and CONDUCT for details.
License
This library is open-sourced software licensed under MIT license.