Inherited theme : make it possible to customize specific blocks from base.html.twig

[aoloe]

When building a theme that inherits Quark, I think there's no clean way to customise a specific block of the base template.

This is also an issue with Antimatter.

Somebody opened a ticket for Antimatter:

getgrav/grav-theme-antimatter#97

and even made a pull request:

getgrav/grav-theme-antimatter#100

which has been left uncommented.

Please, refer to the original ticket for the reasons behind this request.

[luuuke]

I've stumbled over the same problem.

What I did to solve this problem cleanly is to explicitly add Quark as a twig namespace by using the theme's my-theme.php to listen on the onTwigLoader event and adding the Quark theme template directory.

My "my-theme" is set up using the devtools and inherits from the Quark theme. The contents of my-theme.php are as follows.

<?php
namespace Grav\Theme;

use Grav\Common\Grav;
use Grav\Common\Theme;

class MyTheme extends Quark {
    public static function getSubscribedEvents() {
        return [
            'onTwigLoader' => ['onTwigLoader', 10]
        ];
    }

    public function onTwigLoader() {
        parent::onTwigLoader();

        // add quark theme as namespace to twig
        $quark_path = Grav::instance()['locator']->findResource('themes://quark');
        $this->grav['twig']->addPath($quark_path . DIRECTORY_SEPARATOR . 'templates', 'quark');
    }
}

And when I want to overwrite a block in partials/base.html.twig I do the following:

{% extends '@quark/partials/base.html.twig' %}

{% block header %}
This is a shitty header now.
{% endblock %}

Quite a pleasure to be able to modify Gravs behavior so easily, major props to the developers.

[Karmalakas]

Just ran into the same issue. Thanks @luuuke

[rhukster]

@luuuke 's solution is elegant. I recommend this approach!

[Karmalakas]

This might be added to documentation. Maybe to cookbook section somewhere?

[rhukster]

The docs are fully open to user submissions of this type. I would gladly accept a PR that provided this approach.

[aoloe]

@rhukster i understand your position, but i don't feel like -- at this point -- closing this ticket was the right action.

indeed, one way to solve this ticket is to accept a PR that adds the snippet above to the docs.
but there is no such PR, so i consider that grav/quark still does not have an easy (or non trivial but documented) way to inherit block and the issue is still there.

please, consider reopening this ticket.

[Karmalakas]

Here you go :)

[aoloe]

thanks @Karmalakas !