Incluir um modelo parcial

Estou tentando usar o Drupal 8, com um tema personalizado, devido a grandes diferenças de estrutura para os meus requisitos. Tenho uma página - front.twig.html e uma página.twig.html, gostaria de criar partes do modelo, conforme usado em phrozn oder em um projeto normal do Symfony2, por exemplo, footer.html.twig e header.html.twig. Esses modelos são salvos em um subdiretório / parts /.

Mas quando chamo esses modelos normalmente, recebo apenas uma string com o nome do modelo.

Por exemplo:

{# in page.html.twig or page--front.html.twig #}
{% include 'parts/footer.html.twig' %} 

Retorna o nome do arquivo como string:

parts/footer.html.twig

É possível fazer isso com o Drupal 8?

Você não pode fazer caminhos relativos; todos os caminhos devem ser da raiz do Drupal ou baseados no caminho do namespace do diretório 'templates': https://www.drupal.org/node/2143557 .

Eu evitaria "da raiz do Drupal" e usaria os namespaces, pelo menos até https://www.drupal.org/node/2291449 ser resolvido.

{% include '@mytheme/parts/footer.html.twig' %}

Edit: Se você deseja passar argumentos adicionais para loop ou verificar alguns vars no seu twigmodelo incluído, você deve escrever desta maneira:

{% include '@mytheme/includes/form-block.html.twig' with {dog: true} %}

Edit: Agora que https://www.drupal.org/node/2291449 foi confirmado, você também pode:

{% include 'footer.html.twig' %}

Consulte https://www.drupal.org/node/2369981 para saber por que você viu o nome do arquivo como uma sequência em vez de uma exceção útil.

Use um caminho completo para o diretório do tema. Se você usar o espaço para nome, precisará alterá-lo se trouxer o código para outro site ou tema.

Isso deve funcionar:

{% include directory ~ '/templates/parts/footer.html.twig' %}

Também é possível usar o uso de um array pelo Twig para criar um fallback quando o arquivo não existe.

Por exemplo. Se footer.html.twig não estiver disponível, defaultfooter.html.twig seria usado.

{{ include([
  '@yourthemename/parts/footer.html.twig',
  '@yourthemename/parts/defaultfooter.html.twig'
]) }}

Nota: ainda estou tentando descobrir se essa é a melhor prática ou não.

Observe que você pode passar variáveis ​​após a withpalavra-chave:

{# template.html will have access to the variables from the current context and the additional ones provided #}
{% include 'template.html' with {'foo': 'bar'} %}

{% set vars = {'foo': 'bar'} %}
{% include 'template.html' with vars %}

Consulte a documentação do Twig http://twig.sensiolabs.org/doc/tags/include.html

Agora que a herança do modelo Add Twig com base no registro do tema, foi permitido confirmar a adição de carregadores Twig , você também pode usar a seguinte linha.

{% include 'footer.html.twig' %}

Para Drupal 8

A inclusão de um arquivo galho no tema quando você faz um {% include 'FILE_NAME.html.twig' %}Drupal espera que seu ARQUIVO esteja localizado no seu Diretório de Temas atual. Basta colocá-lo lá e vai funcionar.

Incluindo um arquivo galho no seu módulo

Se você quiser adicioná-lo em um MÓDULO, precisará declará-lo na Função TEMA. No seu arquivo .module, adicione o seguinte:

<?php function YOUR_MODULE_NAME_theme($existing, $type, $theme, $path) {   
   'FILE_NAME' => [
      'variables' => [
      ],
      'template' => 'FILE_NAME',
    ], ?>

Em seguida, coloque seu arquivo Twig em YOUR_MODULE / template / FILE_NAME.html.twig