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

来源于：

https://merlinwp.com/

Github:

https://github.com/richtabor/MerlinWP

本站下载：

[zrz_file link="https://n.getimg.net/www/2019/04/184090c56c61b5.zip" name="MerlinWP" code=""]

作者介绍：

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.定义演示内容导入文件

您需要以下文件：

content.xml - 使用WordPress导出器导出演示内容
widgets.wie- 使用Widget Importer＆Exporter导出的小部件
customizer.dat- 使用Customizer Export / Import导出的Customizer设置

获得这些文件后，您可以将它们上传到服务器（推荐），或将它们包含在主题中的某个位置。接下来，在主题中定义一个过滤器，让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做出贡献。请阅读有关此存储库的贡献指南。

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

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

执照

开源许可证旨在让您使用Merlin WP构建开源和个人项目。Merlin WP开源许可证是GPLv3。GPLv3有很多术语，但最重要的是当你公开发布你的作品时它是如何粘性的。来自GPL常见问题解答：

如果您以某种方式向公众发布修改后的版本，GPL要求您根据GPL将修改后的源代码提供给程序的用户。

根据GPLv3发布使用Merlin WP的项目，需要您的项目根据GPLv3获得许可。

{{userData.name}}已认证

WordPress主题安装导航