Files

T

E.Noorlander cd498c8c3a v2.5.1: Admin theme refactor, Navigation plugin, user roles, guide restructure

- Reorganize admin into admin/theme/default/ (views + assets)
- Rename GuideNav to Navigation plugin (essential, protected)
- Plugin assets support (SCSS/CSS) loaded after theme CSS
- User roles: Admin, Content Manager, BI Manager, Site Admin
- Role-based access control (RBAC) for admin routes and sidebar
- Guide restructure: sub-topics in separate folders with sidebar nav
- Dynamic breadcrumb for homepage and subdirectories
- Fix theme path traversal (../../ -> ../) in admin.php
- Fix CodeMirror mode load order (xml -> css -> js -> htmlmixed -> php)
- Fix editor-toolbar.js null checks for plugin edit pages
- Layout select from theme.json with live frontmatter update
- Footer sticky at bottom of viewport (min-height: 100vh)
- Breadcrumb color fix (var(--nav-font) -> var(--header-bg))
- Remove language switcher from guide pages
- Update README.md and README.en.md
- Bump version to 2.5.1

2026-08-10 15:36:29 +02:00

6.0 KiB

Raw Blame History

Twig templates

Basic syntax

{# Comment #}
{{ variable }}
{{ variable|default('default') }}
{% if condition %}...{% endif %}
{% for item in items %}...{% endfor %}
{% extends 'base.twig' %}
{% block content %}{% endblock %}
{% include 'partials/header.twig' %}

base.twig example

<!DOCTYPE html>
<html lang="{{ current_lang }}">
<head>
    <meta charset="UTF-8">
    <title>{{ page_title }} - {{ site_title }}</title>
    <meta name="description" content="{{ seo_description }}">
    <link rel="stylesheet" href="{{ theme_css_url }}">
</head>
<body>
    {% include 'partials/header.twig' %}
    
    {% block content %}{% endblock %}
    
    {% include 'partials/footer.twig' %}
</body>
</html>

Variables available in templates

Page data

Variable	Type	Description
`page_title`	string	Current page title (HTML-escaped)
`content`	string	Rendered page content (HTML)
`page_metadata`	array	Frontmatter metadata of the page
`layout`	string	Layout name (e.g. `full_content`)
`sidebar_content`	string	Sidebar content from plugins (HTML)
`breadcrumb`	string	Breadcrumb HTML (generated by CMS)

Site data

Variable	Type	Description
`site_title`	string	Site title from config.json
`default_page`	string	Default page path
`homepage`	string	Homepage path
`homepage_title`	string	Homepage title
`is_homepage`	bool	Whether current page is the homepage
`is_guide_page`	bool	Whether current page is a guide page
`has_content`	bool	Whether content directory is not empty
`cms_version`	string	CMS version number

Variable	Type	Description
`menu`	string	Rendered menu HTML
`current_page`	string	Current page path
`breadcrumb`	string	Breadcrumb HTML

Language

Variable	Type	Description
`current_lang`	string	Current language code (e.g. `nl`)
`current_lang_upper`	string	Current language in uppercase
`available_langs`	array	Available languages with `code`, `name`, `url`, `is_current`

SEO

Variable	Type	Description
`seo_description`	string	SEO description
`seo_keywords`	string	SEO keywords
`block_ai_bots`	bool	Block AI bots
`block_search_engines`	bool	Block search engines

Author

Variable	Type	Description
`author_name`	string	Author name
`author_website`	string	Author website URL
`author_git`	string	Author Git URL

Theme

Variable	Type	Description
`theme_title`	string	Theme title
`theme_css_url`	string	Compiled CSS URL
`theme_js_url`	string	JavaScript URL
`theme_config`	array	Theme configuration from theme.json
`theme_base_url`	string	Theme base URL (e.g. `/themes/default`)
`theme_css_files`	array	List of CSS files
`theme_js_files`	array	List of JS files
`theme_favicon`	string	Favicon URL
`plugin_css_urls`	array	CSS URLs from plugins (loaded after theme CSS)

Theme colors

Variable	Type	Description
`header_color`	string	Header background color
`header_font_color`	string	Header text color
`header_height`	string	Header height in px
`navigation_color`	string	Navigation background color
`navigation_font_color`	string	Navigation text color
`nav_height`	string	Navigation height in px
`sidebar_background`	string	Sidebar background color
`sidebar_border`	string	Sidebar border color

File info

Variable	Type	Description
`created`	string	File creation date
`modified`	string	File modification date
`show_created`	bool	Whether to show creation date
`file_info_block`	bool	Whether to show file info block

Translations

Variable	Type	Description
`t_home`	string	"Home" translation
`t_search`	string	"Search" translation
`t_search_placeholder`	string	Search placeholder translation
`t_search_button`	string	Search button translation
`t_welcome`	string	"Welcome" translation
`t_created`	string	"Created" translation
`t_modified`	string	"Modified" translation
`t_author`	string	"Author" translation
`t_manual`	string	"Manual" translation
`t_guide`	string	"Guide" translation
`t_no_content`	string	"No content" translation
`t_no_results`	string	"No results" translation
`t_results_found`	string	"Results found" translation
`t_powered_by`	string	"Powered by" translation
`t_page_not_found`	string	"Page not found" translation
`t_page_not_found_text`	string	"Page not found" text translation
`t_mappen`	string	"Folders" translation
`t_paginas`	string	"Pages" translation

Layouts and blocks

A layout template extends base.twig and fills the content block:

{% extends 'base.twig' %}

{% block content %}
<div class="container">
    {{ content|raw }}
</div>
{% endblock %}

Conditional sidebar

{% if sidebar_content %}
<div class="row">
    <aside class="col-md-4">
        {{ sidebar_content|raw }}
    </aside>
    <main class="col-md-8">
        {{ content|raw }}
    </main>
</div>
{% else %}
<div class="container">
    {{ content|raw }}
</div>
{% endif %}

Language switcher

{% for lang in available_langs %}
    <a href="{{ lang.url }}" class="{{ lang.is_current ? 'active' : '' }}">
        {{ lang.name }}
    </a>
{% endfor %}

Plugin CSS loading

Plugin CSS is automatically loaded after theme CSS, so themes can override plugin styling:

{% for cssUrl in plugin_css_urls|default([]) %}
    <link href="{{ cssUrl }}" rel="stylesheet">
{% endfor %}

6.0 KiB Raw Blame History

Twig templates

Basic syntax

base.twig example

Variables available in templates

Page data

Site data

Menu & Navigation

Language

SEO

Author

Theme

Theme colors

File info

Translations

Layouts and blocks

Conditional sidebar

Language switcher

Plugin CSS loading

6.0 KiB

Raw Blame History