MerlinWP - 更好的 WordPress 主题设置向导

Merlin WP 是即将推出的，高度可配置的 WordPress 主题设置向导，专为主题开发人员而构建。

最后更新于 2025-06-04

本页目录9 节

Merlin WP 旨在解决繁琐而繁琐的 WordPress 主题设置和入门过程。它使安装新的 WordPress 主题，推荐的 WordPress 插件，自定义程序设置，小部件和演示内容成为令人兴奋和令人愉悦的用户体验。

官网：https://merlinwp.com

GitHub：https://GitHub.com/richtabor/MerlinWP

本站下载（2019.09.23）：

用法

1.将 Merlin WP 添加到您的 WordPress 主题

首先，从 Merlin WP GitHub 存储库下载最新版本。接下来，将发行版中的所有文件添加到您的主题中。

现在，您所需要做的就是需要class-merlin.php该类，merlin-config.php并且 composer 会自动加载您的文件functions.php，如下所示：

1
require_once get_parent_theme_file_path（'/ inc/merlin/vendor/autoload.php '）;
2
require_once get_parent_theme_file_path（'/ inc/merlin/class-merlin.php '）;
3
require_once get_parent_theme_file_path（'/ inc/merlin-config.php '）;

在上面的示例中，/merlin/目录和merlin-config.php文件都放置在主题的/inc/目录位置中。另外，如果您的主题中包含 TGMPA，请确保在其后包括 Merlin WP。

2.配置 Merlin WP

该merlin-config.php文件告诉 Merlin WP 该类的安装位置。在此配置文件中，您还可以启用 Easy Digital Downloads Software 许可证激活步骤。

配置文件还允许您修改任何文本字符串。

directory—在主题中放置 merlin 代码目录的位置（例如：inc/merlin，如果您将merlin文件夹放置在主题的inc文件夹中）
merlin_url — Merlin WP 将存在的管理 URL 段
child_action_btn_url —子主题生成器的“了解更多”链接的网址
dev_mode —保留“ WordPress 管理员”>“外观”部分下的“主题设置”菜单项以进行测试
license_step —打开许可证激活（与 Easy Digital Downloads Software 许可兼容）
license_help_url —有关许可的自定义帮助链接
edd_item_name — EDD 项目名称必须与 EDD_Theme_Updater_Admin 类的 config 参数中的 item_name 相同。
edd_theme_slug — EDD 段塞必须与 EDD_Theme_Updater_Admin 类的 config 参数中的 theme_slug 相同。
edd_remote_api_url — EDD 远程 API URL 必须与 EDD_Theme_Updater_Admin 类的 config 参数中的 remote_api_url 相同。

3.定义演示内容导入文件

您将需要以下文件：

content.xml -使用 WordPress 导出器导出的演示内容
widgets.wie—使用小部件导入器和导出器导出小部件
customizer.dat-使用“ 定制程序导出/导入”导出的定制程序设置

拥有这些文件后，您可以将它们上传到服务器（推荐），或将它们包括在主题中的某个位置。接下来，在主题中定义一个过滤器，以使 WP Merlin 知道这些文件位于何处。根据放置导入文件的位置，有两种方法来定义过滤器：

1.如果将导入文件上载到服务器，请使用此代码示例并进行编辑，以适合您的文件位置：

1
function merlin_import_files() {
2
  return array(
3
    array(
4
      'import_file_name'           => 'Demo Import',
5
      'import_file_url'            => 'http://www.your_domain.com/merlin/demo-content.xml',
6
      'import_widget_file_url'     => 'http://www.your_domain.com/merlin/widgets.json',
7
      'import_customizer_file_url' => 'http://www.your_domain.com/merlin/customizer.dat',
8
      'import_preview_image_url'   => 'http://www.your_domain.com/merlin/preview_import_image1.jpg',
9
      'import_notice'              => __( 'A special note for this import.', 'your-textdomain' ),
10
      'preview_url'                => 'http://www.your_domain.com/my-demo-1',
11
    ),
12
  );
13
}
14
add_filter( 'merlin_import_files', 'merlin_import_files' );

2.如果将导入文件包括在主题的某个位置，请使用以下代码示例：

1
function merlin_local_import_files() {
2
  return array(
3
    array(
4
      'import_file_name'             => 'Demo Import',
5
      'local_import_file'            => get_parent_theme_file_path( '/inc/demo/content.xml' ),
6
      'local_import_widget_file'     => get_parent_theme_file_path( '/inc/demo/widgets.wie' ),
7
      'local_import_customizer_file' => get_parent_theme_file_path( '/inc/demo/customizer.dat' ),
8
      'import_preview_image_url'     => 'http://www.your_domain.com/merlin/preview_import_image1.jpg',
9
      'import_notice'                => __( 'A special note for this import.', 'your-textdomain' ),
10
      'preview_url'                  => 'http://www.your_domain.com/my-demo-1',
11
    ),
12
  );
13
}
14
add_filter( 'merlin_import_files', 'merlin_local_import_files' );

多个演示导入

如果您有多个演示导入，则只需使用适当的数据定义多个数组。有关两个预定义的演示导入的示例，请查看merlin-filters-sample.php文件。

Redux 框架导入

如果您在主题中使用 Redux Framework，则也可以将其导入。请查看该merlin-filters-sample.php文件，以获取有关如何定义 Redux 导入文件的示例。

4.轻松数字下载软件许可证激活

您将需要使用 EDD 和 EDD 软件许可附加组件在设置向导中部署此步骤。默认情况下，此步骤是禁用的，因此您必须在merlin-config.php文件中启用它（请查看上面的“ 配置 Merlin WP”步骤）。

在merlin-config.php文件中配置了所有必需的设置后，将在子主题步骤之后立即显示许可证激活步骤。

集成是针对 EDD 许可主题示例完成的，您也可以将其添加到主题中。这将添加一个主题许可证页面，用户可以在其中禁用或检查许可证的到期日期。

5.添加过滤器

软件包下载merlin-filters-sample.php中包含一个文件，其中包含可用于修改 Merlin 的不同过滤器的示例。一个主要的例子是使用merlin_generate_child_functions_php过滤器来修改所生成的子主题functions.php文件的内容。

您可能还需要过滤主题演示的主页，以便 Merlin WP 一旦完成运行，就知道将哪些页面设置为主页。

6.调试/日志文件

在中创建一个日志文件.../wp-content/uploads/merlin-wp/main.log。在日志文件中，您会看到哪里出了问题。

7.测试

为了进行测试，您将需要创建一个新的标准 WordPress 安装并添加集成了 Merlin WP 的主题构建。然后，您可以使用 WP Reset 插件来重置并运行更多测试。

阅读偏好

工具