來源于：

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做出貢獻。請閱讀有關此存儲庫的貢獻指南。

您可以通過多種方式做出貢獻：

1. 在GitHub上提出一個問題
2. 發送帶有錯誤修復和/或新功能的Pull請求
3. 提供有關增強功能的反饋和建議

執照

開源許可證旨在讓您使用Merlin WP構建開源和個人項目。Merlin WP開源許可證是GPLv3。GPLv3有很多術語，但最重要的是當你公開發布你的作品時它是如何粘性的。來自GPL常見問題解答：

如果您以某種方式向公眾發布修改后的版本，GPL要求您根據GPL將修改后的源代碼提供給程序的用戶。

根據GPLv3發布使用Merlin WP的項目，需要您的項目根據GPLv3獲得許可。