bigboxwc/wp-template-loader

WordPress 视图/模板加载助手。

1.0.2 2018-06-15 19:38 UTC

This package is not auto-updated.

Last update: 2024-09-29 06:08:49 UTC


README

为WordPress模板系统增加稳定性。

目录

安装

通过Composer使用此组件是最佳方式。

composer require bigboxwc/wp-template-loader

基本用法

核心模板过滤初始化应在运行时进行。这会将WordPress的核心模板文件(模板层次结构)默认路由到您选择的布局目录(/resources/views/layout)。

( new \BigBoxWC\WP_Template_Loader\Loader() )::watch();

不是加载/single.php,而是加载/resources/views/layout/single.php

定义自定义目录

默认视图目录是/resources/views,其中包含相对于该目录的layoutpartials目录。要更改这些,请将它们传递给Loader实例化。

( new \BigBoxWC\WP_Template_Loader\Loader( [
	'base_path'    => 'resources/templates',
	'layout_dir'   => 'wp-pages',
	'partials_dir' => 'parts',
] ) )::watch();

手动加载视图

Loader类还提供了不使用WordPress的模板加载系统来加载视图的能力。这些可以轻松地集成到您的主题可能已经使用的任何现有模板助手。

渲染视图

\BigBoxWC\WP_Template_Loader\Loader::view( 'my-view' );

将输出resources/views/my-view.php的内容。

获取视图

$view = \BigBoxWC\WP_Template_Loader\Loader::get_view( 'my-view' );

resources/views/my-view.php的内容分配给一个变量。

在自定义目录中渲染视图

\BigBoxWC\WP_Template_Loader\Loader::view( 'global/header' );

将输出resources/views/global/header.php的内容。

使用传入变量渲染视图

\BigBoxWC\WP_Template_Loader\Loader::view( 'global/header', [
	'min' => true,
] );

将输出包含全局作用域中可用的变量$minresources/views/global/header.php的内容。

渲染部分

可以使用partial()方法而不是view()方法重复上述方法,以自动查找设置的$partial_dir位置。

贡献

欢迎所有反馈/错误报告/拉取请求。

许可

此代码在GPL许可证下发布。

有关完整的版权和许可证信息,请查看与此源代码一起分发的LICENSE文件。