README

Woodlets是测试版。我们认为它足够稳定，可以在生产环境中使用，我们就是这么做的。
但是，你应该将默认模板目录从views/defaultTemplates复制到您主题的woodlets目录中。这有助于防止与未来Woodlets版本的兼容性问题。

欢迎反馈和功能请求！

Woodlets是一个WordPress插件，它使主题开发更高效、更有趣。
主要功能包括

• 基于Twig的强有力主题开发
• 使用单个Twig模板文件创建小工具
• 多列页面布局
• 具有数据继承的自定义页面模板字段
• 简单地向主题定制器添加控件
• 与原生WordPress小工具兼容

安装

建议通过TGM Plugin Activation进行安装。使用TGMPA插件激活，您可以定义Woodlets为您的主题的必需依赖项。
但是，还有一个捆绑版本可以手动安装。

通过TGM插件激活安装

1. 按照安装手册中的说明安装TGM插件激活。

2. 包含并配置TGM插件激活库以加载Woodlets

   <?php
   require_once dirname( __FILE__ ) . '/class-tgm-plugin-activation.php';
   
   add_action( 'tgmpa_register', function() {
       $plugins = array(
           array(
               'name'               => 'Woodlets',
               'slug'               => 'woodlets',
               'source'             => 'https://github.com/Neochic/Woodlets/releases/download/v0.6.13/woodlets-v0.6.13-bundled.zip',
               'required'           => true,
               'force_activation'   => true,
               'force_deactivation' => true
           )
       );
       tgmpa( $plugins );
   });

查看"Woodlets Seed"-Theme Tgm.php以获取一个有效示例。

手动安装

1. 前往发布页面并下载最新的捆绑版本。
2. 将zip存档解压缩到您的WordPress插件目录中（通常为"wp-content/plugins/")。
3. 在WordPress安装的插件页面上激活插件。

入门指南

对于创建新的Woodlets主题，我们建议使用"Woodlets-CLI"而不是从头开始。查看"Woodlets Example"-Theme也是一个好主意。

手动创建主题

1. 请确保Woodlets插件已安装并激活。

2. 创建一个新的主题（如WordPress文档所述，它至少应包含style.css和index.php）

3. 将以下行放入您的index.php

   <?php
   do_action('neochic_woodlets_render_template');

   操作neochic_woodlets_render_template初始化模板渲染。

4. 激活您的新主题。

5. 创建至少包含一个列的第一个页面模板。了解如何创建自己的页面模板。

6. 创建您的第一个Woodlets小工具。了解如何创建自定义小工具。

7. 将您的新小工具添加到页面模板列的允许小工具配置中。

8. 创建或编辑一个页面，并使用您的新页面布局在后台和前端测试您的插件。

进一步阅读

• 小工具
• 字段类型
• 页面模板
• 主题定制
• 布局
• 帖子和其他模板
• 多语言
• 操作和过滤器