Merlin WP旨在解决繁琐而繁琐的WordPress主题设置和入门过程。它使安装新的WordPress主题,推荐的WordPress插件,自定义程序设置,小部件和演示内容成为令人兴奋和令人愉悦的用户体验。
Github:https://github.com/richtabor/MerlinWP
本站下载(2019.09.23):
MerlinWP-master.zip


用法
1.将Merlin WP添加到您的WordPress主题
首先,从Merlin WP GitHub存储库下载最新版本。接下来,将发行版中的所有文件添加到您的主题中。
现在,您所需要做的就是需要class-merlin.php
该类,merlin-config.php
并且composer会自动加载您的文件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将存在的管理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.如果将导入文件上载到服务器,请使用此代码示例并进行编辑,以适合您的文件位置:
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插件来重置并运行更多测试。