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\LogicExceptionwill 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:
$this->layout('base-template') ?>
$this->start('body') ?>
<h1>Hallo $this->e($name)?>h1>
<small>$this->pathFor('profile', ['name'=> $name])?>small> $this->stop() ?>
baseUrl($permalink = '')
Retrieve the base url of your Slim application. Example:
"baseUrl()?>">Some Link
Or you can pass a permalink
"baseUrl('some/path')?>">Some Other Link
basePath()
Retrieve the base url of your Slim application. Example:
"stylesheet" href="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.
466 Dec 8, 2022
111 Jul 23, 2022
60 Oct 26, 2022
620 Jan 7, 2023
6 Oct 14, 2022
1 May 12, 2021
5 May 18, 2022
118 Jun 24, 2022
2.5k Dec 30, 2022
415 Dec 27, 2022
2.6k Dec 30, 2022
6 Jul 9, 2022
7 Aug 6, 2021
1 Oct 11, 2022
139 Dec 30, 2022
6 Aug 30, 2022
2 Jun 1, 2022
2 Dec 16, 2021
9 Apr 29, 2021