包简介

README 文档

README

WordPress with Twig on budget.

Make WordPress use ".php" and ".html.twig" theme templates
Split model from view by using filters or $wp_query
Inherit from multiple themes instead of just one parent

Before	After
404.php search.php single-cpt-foo.php ...	404.html.twig search.html.twig single-cpt-foo.html.twig ...

Installation / Usage

Require via composer:

composer require rmp-up/wp-twig

And add to your "functions.php" or elsewhere:

<?php

wp_twig_register();

This function exists when composer's autoload.php is used. From now on WordPress uses ".php" and ".html.twig" templates.

Templating / How Twig works

See given files in this repo like the "index.html.twig" file:

<html>
<body>
    <div class="menu"> <a href="/">HOME</a> :: <a href="/index.php?s=404">Why?</a> </div>
    <hr>
  
    {% block foo %}
        Hello world!
    {% block %}

</body>
</html>

So by default this page shows "Hello world". In other templates we can use the surrounding HTML but replace blocks:

{% extends 'wp-twig/index.html.twig' %}

{% block foo %}
    Search results are:

    ...
{% endblock %}

Note: The path to the theme itself is also needed. This way it is possible to access files of other themes.

Using (WordPress-)Functions

Twig is extended in a way that any function can be used as a filter. This means functions like date_i18n('l, d.m.Y') or wp_list_pluck are available as filter and function:

{{ "l, d.m.Y"|date_i18n }}
{# same as #}
{{ date_i18n("l, d.m.Y") }}

{{ some_posts|wp_list_pluck('ID') }}
{{ wp_list_pluck(some_posts, 'ID') }}

{{ __("translate this!", "wp-twig") }}

But for the sake of segregation and performance, don't do get_posts('post_type=foo') within a template. Data, lists and other expensive things should be injected as follows.

Data- / Model-Layer

Injecting data via WP_Query

Since WordPress 1.5 you can inject data in templates using $wp_query->query_vars. The load_template function (and locate_template in some cases) extracts the data as variables and so does wp-twig:

<?php

add_filter(
    'init',
    static function () {
        global $wp_query;
  
        $wp_query->query_vars['user'] = wp_get_current_user();  
    }
);

This is how you may have injected data in templates until now and it is still available in Twig:

{% if user %}
    Hello {{ user.user_nicename }}
{% else %}
    Hello guest!
{% endif %}

Injecting variables in the Twig-Context

It gives you four filter for injecting data:

wp_twig_template_{type}_block_{name} (e.g. "wp_twig_template_404_block_foo")
wp_twig_block_{name} (e.g. "wp_twig_block_foo")
wp_twig_template_{type} (e.g. "wp_twig_template_index" or "wp_twig_template_search")
wp_twig_context

Those are executed in the given order so you can basically add data to templates:

<?php

add_filter(
  'wp_twig_template_page_block_foo',
  static function ( array $context ) {
    $context['bar'] = 42;

    return $context;
  }
);

The order is important to bypass already added data on the more generic levels:

<?php

add_filter(
  'wp_twig_block_foo', // more generic than "wp_twig_template_page_block_foo" from above
  static function ( array $context ) {
    if ( ! array_key_exists( 'bar', $context ) ) {
        $context['bar'] = apply_filters( 'fetch_some_expensive_data', [] );
    }

    return $context;
  }
);

Bypassing the generation of data spares some time which results in a better performance of the theme. We suggest that you encapsulate data in a Generator of other lazy contructs to enhance this even more.

rmp/wp-twig 适用场景与选型建议

rmp/wp-twig 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 4 次下载、GitHub Stars 达 0，最近一次更新时间为 2019 年 11 月 28 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 rmp/wp-twig 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 rmp/wp-twig 我们能提供哪些服务？

定制开发 / 二次开发

基于 rmp/wp-twig 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

rmp/wp-twig

包简介