Content files, blueprints, templates and controllers in Kirby are all connected through their filenames: a content file
blogarticle.txt will use the
blogarticle.yml file when it is opened in the Panel, and will be rendered with the
blogarticle.php template in the frontend using an
blogarticle.php controller to load the logic if available.
If a template with the same filename as the content text file doesn't exist, Kirby will fall back to the required
So, the easiest way to share a template between pages with different blueprints would be to use the
However, there might be situations where this is not desired, like when the
default template should really be the last fallback template, or if you need multiple shared templates.
The templates extension to the rescue. With the template extension, Kirby allows you to register templates in a plugin. The templates extension accepts an array of key/value pairs, where the key is the name of the template and the value the path to the file in your plugin folder:
How can we leverage this extension to use the same template for multiple page types? By simply assigning the same file to multiple template names, like this:
If you ever decide that one of the page types should get a different template, you can either change this in the plugin, or add a new template in the
An example: Assuming the
jobs page type should get its own template, place a
jobs.php template into
You can also use this setup to register the same controller for these templates. Note that the syntax for registering controllers is different from registering templates:
And it also works for page models:
We define a Base model, and assign it to different page model names.
In a real world example, your class would most probably go into a separate file, for details see the page models reference.