qundg / modulator
Modulator帮助进行Wordpress的模块化Web开发。
Requires
- composer/installers: ^1.2
- twig/twig: *
README
Modulator帮助进行Wordpress的模块化Web开发,通过...
- 与Timber集成
- 使用Twig将逻辑与显示分离
- 提供一个基础结构,使得网站的不同组成部分(即模块)各自位于一个单独的目录中
许可证
Modulator由quäntchen + glück开发,并在此以GPL许可证发布。我们不提供支持,并保留在未经通知的情况下随时更改API的权利。但你可以自由地fork、进一步开发、根据需要调整或制作蛋糕。开源使这一切成为可能 :)
Timber集成
Modulator与Timber合作得非常好。通过命名空间timber
,可以在Modulator模板中访问Timber变量(例如,{{ timber.theme.path }}
)。也可以在Modulator模板中使用Timber的扩展。
遗憾的是,目前无法从Timber外部访问Twig实例。因此,Modulator使用自己的Twig实例,并通过所有必要的Timber过滤器来提供变量和扩展。如果更新Timber后Modulator出现问题,这可能是由于更改了过滤器。在这种情况下,需要在Timber中查找更改的过滤器,并在Modulator的构造函数中进行调整。
全局变量
Modulator通过命名空间globals
提供对共享变量的访问(例如,{{ globals.home_url }}
)。但是,Timber集成是单向的,即Modulator的全局变量不在Timber中可用。目前有以下变量:
globals.home_url
用于主页URLglobals.theme_url
用于主题目录URLglobals.images_url
用于主题目录内的/assets/img/
的URL
更新时需要注意什么?
由于Modulator已经进行了一些重大的更新,因此在进行某些更新时需要手动操作
到2.0.0或更高版本
在2.0.0之前,使用了一个自开发的模板系统,而自2.0.0起,Modulator开始使用Twig。因此,版本之间不兼容,即从1.x更新到2.x时,必须将所有模块的视图重新编写为Twig。
到2.2.0或更高版本
在2.2.0之前,所有模块会自动包含style.css和script.js。自2.2.0起不再如此,因为模块可以更灵活地集成到构建过程中,例如使用Gulp。因此,在这次更新中,需要注意将资产以其他方式包含。