Npcink Blog
切换菜单

WordPress 主题安装导航

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

发布于
本页目录12 节

来源于：

https://merlinwp.com/
GitHub:
https://GitHub.com/richtabor/MerlinWP
本站下载：

作者介绍：

https://richtabor.com/merlin-wp/

梅林 WP

Merlin WP 旨在解决单调乏味且耗费精力的 WordPress 主题设置和入门流程。它使安装新的 WordPress 主题，推荐的 WordPress 插件，定制器设置，小部件和演示内容成为令人兴奋和令人满意的用户体验。阅读更多...

测试和测试

Merlin WP 目前处于测试阶段，目前尚不建议在生产中使用 Merlin WP，因为还有一些问题需要补充。如果你遇到任何问题，提出一个问题，让我们继续努力吧。

用法

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

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

现在你需要做的就是要求你的class-merlin.php类，merlin-config.php以及你的作曲家自动加载文件functions.php，如下所示：

require_once get_parent_theme_file_path（'/ inc/merlin/vendor/autoload.php '）;
require_once get_parent_theme_file_path（'/ inc/merlin/class-merlin.php '）;
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 将存在的 admin url slug
  • child_action_btn_url - 子主题生成器的“了解更多”链接的 URL
  • dev_mode - 保留 WordPress 管理>外观部分下的“主题设置”菜单项以进行测试
  • license_step - 启用许可证激活（与 Easy Digital Downloads Software Licensing 兼容）
  • license_help_url - 有关许可的自定义帮助链接
  • edd_item_name - EDD 项目名称必须与 EDD_Theme_Updater_Admin 类中 config 参数中的 item_name 相同。
  • edd_theme_slug - EDD slug 必须与 EDD_Theme_Updater_Admin 类中 config 参数中的 theme_slug 相同。
  • edd_remote_api_url - EDD 远程 API URL 必须与 EDD_Theme_Updater_Admin 类中 config 参数中的 remote_api_url 相同。

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

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

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

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

2.如果您在主题中的某处包含了导入文件，请使用以下代码示例：

function merlin_local_import_files() {
  return array(
    array(
      'import_file_name'             => 'Demo Import',
      'local_import_file'            => get_parent_theme_file_path( '/inc/demo/content.xml' ),
      'local_import_widget_file'     => get_parent_theme_file_path( '/inc/demo/widgets.wie' ),
      'local_import_customizer_file' => get_parent_theme_file_path( '/inc/demo/customizer.dat' ),
      'import_preview_image_url'     => 'http://www.your_domain.com/merlin/preview_import_image1.jpg',
      'import_notice'                => __( 'A special note for this import.', 'your-textdomain' ),
      'preview_url'                  => 'http://www.your_domain.com/my-demo-1',
    ),
  );
}
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 插件重置并运行更多测试。

捐款

欢迎任何人为 Merlin WP 做出贡献。请阅读有关此存储库的贡献指南。

您可以通过多种方式做出贡献：

  1. 在 GitHub 上提出一个问题
  2. 发送带有错误修复和/或新功能的 Pull 请求
  3. 提供有关增强功能的反馈和建议

执照

开源许可证旨在让您使用 Merlin WP 构建开源和个人项目。Merlin WP 开源许可证是 GPLv3。GPLv3 有很多术语，但最重要的是当你公开发布你的作品时它是如何粘性的。来自 GPL 常见问题解答：
如果您以某种方式向公众发布修改后的版本，GPL 要求您根据 GPL 将修改后的源代码提供给程序的用户。
根据 GPLv3 发布使用 Merlin WP 的项目，需要您的项目根据 GPLv3 获得许可。