Wallogit.com
2017 © Pedro Peláez
WordPress templating DSL
Write WordPress theme templates with familiar ease and modern features., (*1)
, (*2)
Meadow is a theme templating solution, aiming to find a balance between native WordPress concepts and power of Twig dedicated templating language., (*3)
Require package in your theme project with Composer:, (*4)
composer require rarst/meadow
Instantiate object some time during theme load:, (*5)
$meadow = new \Rarst\Meadow\Core; $meadow->enable();
Meadow follows conventions of WordPress template hierarchy:, (*6)
index.php becomes index.twig.{{ get_header() }} will look for header.twig (with fallback to header.php)Template Tags API (and PHP functions in general) are set up to work transparently from Twig templates:, (*7)
{{ the_title() }}
WordPress filters set up to be available as Twig filters:, (*8)
{{ 'This is the title'|the_title }}
Full range of Twig functionality is naturally available, including template inheritance:, (*9)
{# single.twig #}
{% extends 'index.twig' %}
{% block entry_title %}
{{ parent() }}
{% endblock %}
To inherit parent template in child theme prepend it with folder's name:, (*10)
{# child-theme/index.twig #}
{% extends 'parent-theme/index.twig' %}
Meadow attempts not just "map" WordPress to Twig, but also meaningfully extend both to improve historically clunky WP constructs., (*11)
This is primarily achieved by implementing custom Twig tags, abstracting away complexities for specific tasks., (*12)
{% loop %}
<h2><a href="{{ the_permalink() }}">{{ the_title() }}</a></h2>
{{ the_content() }}
{% endloop %}
{% loop { 'post_type' : 'book', 'orderby' : 'title' } %} {# expression for arguments #}
<h2><a href="{{ the_permalink() }}">{{ the_title() }}</a></h2>
{{ the_content() }}
{% endloop %}
<ul class="comment-list">
{% comments %}
<li>
{{ comment_text() }}
{# no </li> - self-closing #}
{% endcomments %}
</ul>
In Hybrid Wing theme (work in progress):, (*13)
MIT, (*14)
WordPress templating DSL
MIT
wordpress twig
WordPress templating DSL
MIT
wordpress twig
WordPress templating DSL
MIT
wordpress twig