Pug Renderer
This is a (heavily based on the PhpRenderer) renderer for rendering Pug view scripts into a PSR-7 Response object. It works well with Slim Framework 3.
Security risks
Pug Renderer uses Pug.php under the hood. Pug Renderer is merely a thin layer to Pug.php work with Slim 3. We will not keep track of vulnerabilities. Please refer to the original project to find out more how to prevent issues and to report vulnerabilities.
Installation
Install with Composer:
$ composer require md/pug-slim
Usage with Slim 3
getContainer();
$container['renderer'] = new PugRenderer("./templates");
$app->get('/hello/{name}', function ($request, $response, $args) {
return $this->renderer->render($response, "/hello.pug", $args);
});
$app->run();">
use Slim\Views\PugRenderer; include "vendor/autoload.php"; $app = new Slim\App(); $container = $app->getContainer(); $container['renderer'] = new PugRenderer("./templates"); $app->get('/hello/{name}', function ($request, $response, $args) { return $this->renderer->render($response, "/hello.pug", $args); }); $app->run();
Usage with any PSR-7 Project
render(new Response(), "/path/to/template.pug", $yourData);">
//Construct the View $pugView = new PugRenderer("./path/to/templates"); //Render a Template $response = $pugView->render(new Response(), "/path/to/template.pug", $yourData);
Template Variables
You can add variables to your renderer that will be available to all templates you render.
"Title"
];
$pugView = new PugRenderer("./path/to/templates", $templateVariables);
// or setter
$pugView->setAttributes($templateVariables);
// or individually
$pugView->addAttribute($key, $value);">
// via the constructor $templateVariables = [ "title" => "Title" ]; $pugView = new PugRenderer("./path/to/templates", $templateVariables); // or setter $pugView->setAttributes($templateVariables); // or individually $pugView->addAttribute($key, $value);
Data passed in via ->render() takes precedence over attributes.
"Title"
];
$pugView = new PhpRenderer("./path/to/templates", $templateVariables);
//...
$pugView->render($response, $template, [
"title" => "My Title"
]);
// In the view above, the $title will be "My Title" and not "Title"">
$templateVariables = [ "title" => "Title" ]; $pugView = new PhpRenderer("./path/to/templates", $templateVariables); //... $pugView->render($response, $template, [ "title" => "My Title" ]); // In the view above, the $title will be "My Title" and not "Title"
Exceptions
\RuntimeException - if template does not exist
\InvalidArgumentException - if $data contains 'template'
References
- To learn more about Pug go to https://pugjs.org
- Here is an online HTML to Pug converter https://html2pug.herokuapp.com/
1 Oct 23, 2021
13 Nov 11, 2022
64 Jul 30, 2022
1 Oct 16, 2021
15 Jul 28, 2022
49 Jan 8, 2022
67 May 18, 2022
399 Aug 18, 2022
71 Sep 29, 2022
4 Feb 12, 2022
3 Mar 4, 2022
16 Jun 7, 2022
526 Dec 5, 2022
1 Feb 1, 2022
15 Jan 4, 2022
3 Nov 19, 2022
31 Jun 25, 2021
873 Jan 7, 2023