This plugin extends Kirby’s templates with a powerful layout system.
Download and copy this repository to /site/plugins/layouts.
git submodule add https://github.com/getkirby/layouts.git site/plugins/layouts
composer require getkirby/layouts
You can create full HTML layouts in a new /site/layouts folder. Layouts can define slots, which will then be filled with content by templates.
You can create as many layouts as you need in your /site/layouts folder. Start with a default.php layout that will be picked up if no layout name is specified in the template.
<html>
<head>
<title><?= $page->title() ?></title>
</head>
<body>
<?php slot() ?>
<?php endslot() ?>
</body>
</html><?php layout() ?>
<h1>Hello world</h1>
<p>This will end up in the default slot</p>To use a specific layout, you can pass its name to the layout() method.
<html>
<head>
<title>Blog</title>
</head>
<body>
<h1>Blog</h1>
<?php slot() ?>
<?php endslot() ?>
</body>
</html><?php layout('blog') ?>
<!-- some articles -->You can add as many different slots to your layout as you need. The default slot goes without a specific name. Every other slot needs a unique name. Slots in layouts can define default content, which will be rendered if the slot is not used in the template.
<html>
<head>
<?php slot('head') ?>
<title>Blog</title>
<?php endslot() ?>
</head>
<body>
<div class="page">
<header class="header">
<a href="/">Logo</a>
</header>
<div class="sidebar">
<?php slot('sidebar') ?>
<!-- default sidebar setup -->
<?php endslot() ?>
</div>
<main class="main">
<h1>Blog</h1>
<?php slot() ?>
<!-- this is the default slot -->
<?php endslot() ?>
</main>
</div>
</body>
</html>Once the slots are defined, you can fill them from your template. If you use multiple slots, you must wrap content for each slot in the slot and endslot methods.
<?php slot('sidebar') ?>
<nav>
<!-- a custom sidebar menu -->
</nav>
<?php endslot() ?>
<?php slot() ?>
<!-- html for the default slot -->
<?php endslot() ?>Kirby's template system stays exactly as you know it. You can still work with templates without layouts and you can also still use snippets – in your templates and in your layouts.
<html>
<head>
<?php slot('head') ?>
<title>Blog</title>
<?php endslot() ?>
</head>
<body>
<div class="page">
<?php snippet('header') ?>
<div class="sidebar">
<?php slot('sidebar') ?>
<?php snippet('sidebar') ?>
<?php endslot() ?>
</div>
<main class="main">
<h1>Blog</h1>
<?php slot() ?>
<!-- this is the default slot -->
<?php endslot() ?>
</main>
</div>
</body>
</html>You can pass global data to the layout method and make it available in every slot and snippet of your layout.
<html>
<head>
<?php slot('head') ?>
<title><?= $title ?></title>
<?php endslot() ?>
</head>
<body>
<div class="page">
<?php snippet('header') ?>
<div class="sidebar">
<?php slot('sidebar') ?>
<?php snippet('sidebar') ?>
<?php endslot() ?>
</div>
<main class="main">
<h1>Blog</h1>
<?php slot() ?>
<!-- this is the default slot -->
<?php endslot() ?>
</main>
</div>
</body>
</html><?php layout('blog', ['title' => 'Blog') ?>
Some more content ...MIT