README

此 mu-plugin 允许主题和插件开发者使用 Nette Latte v2.5 编写模板。

要求

WordPress：4.7+ PHP：5.6.0+ 许可证：GPLv2 或更高版本 许可证 URI：https://gnu.ac.cn/licenses/gpl-2.0.html

使用 Composer 安装

1. 转到 wp-content/mu-plugins 文件夹，并使用 composer require mejta/wp-latte 命令要求 wp-latte。
2. 不要忘记在加载器（例如 wp-content/mu-plugins/load.php）中加载 composer 依赖项。

<?php // wp-content/mu-plugins/load.php
require WPMU_PLUGIN_DIR . '/vendor/autoload.php';

使用 Git 安装

1. 转到 wp-content/mu-plugins 文件夹，并使用 git clone git@github.com:mejta/wp-latte.git 命令克隆存储库。
2. 转到插件文件夹：cd wp-latte
3. 使用 composer install 安装 composer 依赖项
4. 不要忘记在加载器中加载插件（例如 wp-content/mu-plugins/load.php）

<?php // wp-content/mu-plugins/load.php
require WPMU_PLUGIN_DIR . '/wp-latte/vendor/autoload.php';
require WPMU_PLUGIN_DIR . '/wp-latte/wp-latte.php';

使用方法

在插件激活后，您可以在主题中使用 Nette Latte 模板。只需使用 .latte 文件扩展名代替 .php。具有 .php 扩展名的模板文件将继续工作，但在模板解析中，这些模板将具有较低的优先级。

对于 header.php 和 footer.php 存在限制。您应该在布局文件中使用 {php wp_head()} 和 {php wp_footer()} 宏来代替。如果您需要使用 header.php 和 footer.php 文件（例如 WooCommerce 插件），请将这些文件留空。

如果您希望在插件未激活的情况下有回退，请在主题文件夹中添加 index.php，其中包含一些有意义的信息，说明需要插件。

您还可以定义自己的自定义筛选器和宏。在您的 functions.php 文件中使用以下代码。

<?php // wp-content/themes/my-theme/functions.php
use NetteLatteEngine\NetteLatteEngine;

// https://latte.nette.org/en/guide#toc-user-defined-macros
NetteLatteEngine::addMacro('test', $start_php_code, $end_php_code);

// https://latte.nette.org/en/guide#toc-custom-filters
NetteLatteEngine::addFilter('test', $callback_function);

如果您想定义自定义文章模板，请创建主题根目录中的模板文件，并在文件的开始处放置如下注释块

{*
Template Name: Custom template file
Template Post Type: post, page
*}
...
<h1>Content</h1>
...

贡献

请随意改进插件并在 Github 存储库 中打开 pull request。