MerlinWP - 更好的WordPress主題設置向導

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，如下所示：

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插件來重置并運行更多測試。