身為 ThemeForest 中的 WordPress 作者，我們希望透過偶爾為客戶提供錯(cuò)誤修復(fù)和主題增強(qiáng)功能來讓他們滿意。但我們面臨的一個(gè)關(guān)鍵問題是如何在有更新可供下載時(shí)通知我們的用戶。

在過去，我們每個(gè)人都必須在自己的主題更新通知程式實(shí)作中進(jìn)行編碼。雖然現(xiàn)在有一個(gè)複選框可以啟用 Envato 市場(chǎng)中的項(xiàng)目更新通知，但用戶仍然必須針對(duì)每個(gè)項(xiàng)目打開它，並手動(dòng)執(zhí)行主題更新。

如果更新通知顯示在 WordPress 管理中心內(nèi)不是更好嗎？並且可以在管理員中立即執(zhí)行更新嗎？幸運(yùn)的是，我們現(xiàn)在擁有 Envato WordPress 工具包外掛和工具包庫。

在本系列中，您將學(xué)習(xí)如何將這些工具包整合到您的主題中。

我們將在本系列中介紹什麼內(nèi)容

在本教程中，我們將在我們的主題中實(shí)作 Envato WordPress 工具包外掛程式和函式庫。當(dāng)我們的主題被啟動(dòng)時(shí)，用戶將被要求安裝並啟動(dòng) Toolkit 外掛。

一旦外掛程式處於活動(dòng)狀態(tài)，我們的主題將定期檢查更新，如果發(fā)現(xiàn)更新，則會(huì)在管理中顯示一則通知，引導(dǎo)使用者存取外掛程式以更新主題。

本教學(xué)分為兩部分：

• 第 1 部分 - 整合 TGM 外掛啟動(dòng)類，使使用我們的主題時(shí)需要 Envato WordPress Toolkit 外掛；和
• 第 2 部分 - 在我們的主題中實(shí)作 Envato WordPress 工具包庫，以允許新的主題版本檢查和更新。

外掛程式和函式庫？

Envato WordPress 工具包有兩種形式，有不同的用途和目的。為了避免混淆這兩者，這裡有一個(gè)比較：

• 工具包外掛程式 - 這是一個(gè)獨(dú)立的插件，任何 Envato 客戶都可以在其 WordPress 網(wǎng)站中安裝。啟動(dòng)後，所有先前購買的主題以及主題更新都可以直接從管理員下載。
• 工具包庫 - 作者可以在其 WordPress 主題中包含程式碼，使主題能夠使用 Envato Marketplace API 檢查主題版本更新並進(jìn)行自我更新。

1.包含所需的檔案

我們首先需要在專案中包含一些文件。我們將把 Toolkit 外掛程式與我們的主題捆綁在一起，並使用 TGM 外掛程式啟動(dòng)來安裝和啟動(dòng) Toolkit。

1. 下載 TGM 外掛程式啟動(dòng)並將主類別腳本放入主題中的 inc 資料夾中。路徑應(yīng)為：mytheme/inc/class-tgm-plugin-activation.php
2. #接下來，下載 Envato WordPress Toolkit 外掛程式 ZIP 檔案並將其放入主題中名為「plugins」的新資料夾中。路徑應(yīng)為：mytheme/plugins/envato-wordpress-toolkit-master.zip

2.TGM鉤子函數(shù)

現(xiàn)在我們已經(jīng)有了所需的文件，讓我們開始編碼。我們需要在 functions.php 中包含 TGM 外掛程式啟動(dòng)類，並掛鉤到自訂 WordPress 操作。我們將在此處設(shè)置 TGM 的一些設(shè)置，並定義要包含的插件。

/**
 * Load the TGM Plugin Activator class to notify the user
 * to install the Envato WordPress Toolkit Plugin
 */
require_once( get_template_directory() . '/inc/class-tgm-plugin-activation.php' );
function tgmpa_register_toolkit() {

	// Code here

}
add_action( 'tgmpa_register', 'tgmpa_register_toolkit' );

3.指定Toolkit外掛

#接下來，我們配置包含 Toolkit 外掛所需的參數(shù)。在 tgmpa_register_toolkit 函數(shù)內(nèi)，加入以下程式碼。如果您在第 1 步驟中指定了另一個(gè)外掛程式資料夾，請(qǐng)變更來源參數(shù)中的路徑。

// Specify the Envato Toolkit plugin
$plugins = array(
	array(
		'name' => 'Envato WordPress Toolkit',
		'slug' => 'envato-wordpress-toolkit-master',
		'source' => get_template_directory() . '/plugins/envato-wordpress-toolkit-master.zip',
		'required' => true,
		'version' => '1.5',
		'force_activation' => true,
		'force_deactivation' => false,
		'external_url' => '',
	),
);

您也可以透過在 $plugins 變數(shù)新增更多陣列來新增其他外掛程式。

4.配置TGM

然後設(shè)定 TGM 的選項(xiàng)。同樣在 tgmpa_register_toolkit 函數(shù)中，在上一步下方加入以下程式碼來設(shè)定 TGM。我不會(huì)深入探討各個(gè)設(shè)定的具體作用。如果您想了解有關(guān)這些設(shè)定的更多信息，TGM 插件啟動(dòng)網(wǎng)站可以很好地解釋每一個(gè)細(xì)節(jié)。

// i18n text domain used for translation purposes
$theme_text_domain = 'default';

// Configuration of TGM
$config = array(
	'domain'       	   => $theme_text_domain,
	'default_path' 	   => '',
	'parent_menu_slug' => 'admin.php',
	'parent_url_slug'  => 'admin.php',
	'menu'         	   => 'install-required-plugins',
	'has_notices'      => true,
	'is_automatic'     => true,
	'message' 		   => '',
	'strings'      	   => array(
		'page_title'                      => __( 'Install Required Plugins', $theme_text_domain ),
		'menu_title'                      => __( 'Install Plugins', $theme_text_domain ),
		'installing'                      => __( 'Installing Plugin: %s', $theme_text_domain ),
		'oops'                            => __( 'Something went wrong with the plugin API.', $theme_text_domain ),
		'notice_can_install_required'     => _n_noop( 'This theme requires the following plugin: %1$s.', 'This theme requires the following plugins: %1$s.' ),
		'notice_can_install_recommended'  => _n_noop( 'This theme recommends the following plugin: %1$s.', 'This theme recommends the following plugins: %1$s.' ),
		'notice_cannot_install'  		  => _n_noop( 'Sorry, but you do not have the correct permissions to install the %s plugin. Contact the administrator of this site for help on getting the plugin installed.', 'Sorry, but you do not have the correct permissions to install the %s plugins. Contact the administrator of this site for help on getting the plugins installed.' ),
		'notice_can_activate_required'    => _n_noop( 'The following required plugin is currently inactive: %1$s.', 'The following required plugins are currently inactive: %1$s.' ),
		'notice_can_activate_recommended' => _n_noop( 'The following recommended plugin is currently inactive: %1$s.', 'The following recommended plugins are currently inactive: %1$s.' ),
		'notice_cannot_activate' 		  => _n_noop( 'Sorry, but you do not have the correct permissions to activate the %s plugin. Contact the administrator of this site for help on getting the plugin activated.', 'Sorry, but you do not have the correct permissions to activate the %s plugins. Contact the administrator of this site for help on getting the plugins activated.' ),
		'notice_ask_to_update' 			  => _n_noop( 'The following plugin needs to be updated to its latest version to ensure maximum compatibility with this theme: %1$s.', 'The following plugins need to be updated to their latest version to ensure maximum compatibility with this theme: %1$s.' ),
		'notice_cannot_update' 			  => _n_noop( 'Sorry, but you do not have the correct permissions to update the %s plugin. Contact the administrator of this site for help on getting the plugin updated.', 'Sorry, but you do not have the correct permissions to update the %s plugins. Contact the administrator of this site for help on getting the plugins updated.' ),
		'install_link' 					  => _n_noop( 'Begin installing plugin', 'Begin installing plugins' ),
		'activate_link' 				  => _n_noop( 'Activate installed plugin', 'Activate installed plugins' ),
		'return'                          => __( 'Return to Required Plugins Installer', $theme_text_domain ),
		'plugin_activated'                => __( 'Plugin activated successfully.', $theme_text_domain ),
		'complete' 						  => __( 'All plugins installed and activated successfully. %s', $theme_text_domain ),
		'nag_type'						  => 'updated'
	)
);

將 $theme_text_domain 變數(shù)變更為您正在使用的文字網(wǎng)域，或?qū)⑵浔Ａ魹?default。

5.啟動(dòng)TGM

最後，讓我們?cè)?tgmpa_register_toolkit 函數(shù)結(jié)束之前初始化 TGM。

tgmpa( $plugins, $config );

現(xiàn)在儲(chǔ)存您的functions.php

#嘗試一下

嘗試啟動(dòng)您的主題。如果您尚未安裝或啟動(dòng) Envato WordPress Toolkit 外掛，那麼您應(yīng)該會(huì)看到與此類似的通知：

#結(jié)論

從我們現(xiàn)在所掌握的情況來看，我們實(shí)際上可以停止該系列，您的用戶將能夠從管理員內(nèi)部更新主題；但是，用戶只有在 Toolkit 管理面板中才能看到更新。

本教學(xué)的第 2 部分將教您如何整合 Envato WordPress 工具包庫，以及如何在 ThemeForest 中出現(xiàn)主題更新時(shí)顯示管理通知。