在本教學(xué)的最後一部分中，我們學(xué)習(xí)如何使用 TGM 外掛程式啟動(dòng)類別來(lái)在任何時(shí)候都需要 Envato WordPress 工具包外掛程式我們的主題正在使用中。該外掛程式允許用戶在管理員中安裝和更新購(gòu)買的主題。

下一部分將教您如何實(shí)作 Envato WordPress 工具包庫(kù)，以便我們可以使用 Envato Marketplace API 定期檢查我們的主題何時(shí)有可用更新。

當(dāng)有更新可用時(shí)，我們會(huì)在管理員中顯示通知，並引導(dǎo)使用者存取外掛程式進(jìn)行更新。

1.?包含工具包庫(kù)

我們首先需要將工具包庫(kù)包含在我們的專案中。下載 Envato WordPress 工具包庫(kù) ZIP 檔案。解壓縮並將資料夾 envato-wordpress-toolkit-library 複製到主題中的 inc 資料夾中。您最終應(yīng)該得到這些路徑：

• mytheme/inc/envato-wordpress-toolkit-library/class-envato-protected-api.php
• mytheme/inc/envato-wordpress-toolkit-library/class-envato-wordpress-theme-upgrader.php

2.?管理員掛鉤函數(shù)

現(xiàn)在我們可以開(kāi)始編碼了。我們將掛鉤 admin_init 操作。將以下程式碼加入您的 functions.php 中：

/**
 * Load the Envato WordPress Toolkit Library check for updates
 * and direct the user to the Toolkit Plugin if there is one
 */
function envato_toolkit_admin_init() {

    // Include the Toolkit Library
    include_once( get_template_directory() . '/inc/envato-wordpress-toolkit-library/class-envato-wordpress-theme-upgrader.php' );

    // Add further code here

}
add_action( 'admin_init', 'envato_toolkit_admin_init' );

3.?使用工具包外掛程式資訊

工具包庫(kù)需要 Envato 使用者名稱和 API 金鑰才能運(yùn)作。由於我們?cè)谏弦粋€(gè)教程中需要 Toolkit 插件，因此我們可以使用在其設(shè)定中找到的使用者名稱和 API 金鑰欄位的輸入值。如果這些欄位未填寫，我們可以顯示一則通知，要求使用者在 Toolkit 外掛程式中輸入它們。

// Use credentials used in toolkit plugin so that we don't have to show our own forms anymore
$credentials = get_option( 'envato-wordpress-toolkit' );
if ( empty( $credentials['user_name'] ) || empty( $credentials['api_key'] ) ) {
    add_action( 'admin_notices', 'envato_toolkit_credentials_admin_notices' );
    return;
}

我們需要在外部新增對(duì)應(yīng)的鉤子函數(shù)來(lái)顯示我們的管理通知：

/**
 * Display a notice in the admin to remind the user to enter their credentials
 */
function envato_toolkit_credentials_admin_notices() {
    $message = sprintf( __( "To enable theme update notifications, please enter your Envato Marketplace credentials in the %s", "default" ),
        "<a href='" . admin_url() . "admin.php?page=envato-wordpress-toolkit'>Envato WordPress Toolkit Plugin</a>" );
    echo "<div id='message' class='updated below-h2'><p>{$message}</p></div>";
}

4.定期更新檢查

工具包庫(kù)始終使用 Envato Marketplace API 檢查主題更新。這並不好，因?yàn)槊看问褂谜咴煸L管理頁(yè)面時(shí)都執(zhí)行它會(huì)顯著減慢頁(yè)面載入時(shí)間。我們只需要定期檢查更新。

每 3 小時(shí)檢查一次聽(tīng)起來(lái)是個(gè)好主意：

// Check updates only after a while
$lastCheck = get_option( 'toolkit-last-toolkit-check' );
if ( false === $lastCheck ) {
    update_option( 'toolkit-last-toolkit-check', time() );
    return;
}

// Check for an update every 3 hours
if ( 10800 < ( time() - $lastCheck ) ) {
    return;
}

// Update the time we last checked
update_option( 'toolkit-last-toolkit-check', time() );

5.?檢查更新

最後，我們可以使用該函式庫(kù)檢查更新：

// Check for updates
$upgrader = new Envato_WordPress_Theme_Upgrader( $credentials['user_name'], $credentials['api_key'] );
$updates = $upgrader->check_for_theme_update();

// If $updates->updated_themes_count == true then we have an update!

6.主題更新通知

從這一刻起，您可以選擇使用工具包庫(kù)函數(shù) $upgrader->upgrade_theme(); 自動(dòng)更新主題，但是，我相信給用戶一個(gè)選擇通常是一個(gè)好主意。

我的建議是只顯示主題更新的通知，並允許用戶使用 Toolkit 外掛程式進(jìn)行更新：

// Add update alert, to update the theme
if ( $updates->updated_themes_count ) {
    add_action( 'admin_notices', 'envato_toolkit_admin_notices' );
}

我們需要在目前函數(shù)之外顯示顯示通知的函數(shù)：

/**
 * Display a notice in the admin that an update is available
 */
function envato_toolkit_admin_notices() {
    $message = sprintf( __( "An update to the theme is available! Head over to %s to update it now.", "default" ),
        "<a href='" . admin_url() . "admin.php?page=envato-wordpress-toolkit'>Envato WordPress Toolkit Plugin</a>" );
    echo "<div id='message' class='updated below-h2'><p>{$message}</p></div>";
}

為什麼要先使用該外掛？

您可能認(rèn)為也可以只使用 Toolkit 函式庫(kù)而不使用 Toolkit 外掛程式，然後也許只在主題選項(xiàng)中顯示我們自己的使用者名稱和 API 金鑰表單.

雖然這是完全可能做到的，但使用該插件為我們帶來(lái)了一些好處：

1. 在全新主題啟動(dòng)中，如果先前已安裝 Toolkit 插件，我們的主題將自動(dòng)檢查更新。
2. 我們不需要新增一組額外的表單供使用者填寫。
3. 使用者可以自行更新 Toolkit 插件，因此 Marketplace API 中的變更可以應(yīng)用於 WordPress 實(shí)例，而無(wú)需任何主題指導(dǎo)。

結(jié)論

就是這樣！我們整合了 Envato WordPress 工具包外掛程式和函式庫(kù)來(lái)檢查主題更新?，F(xiàn)在，一旦市場(chǎng)中有更新可用，我們的客戶就會(huì)收到管理員通知。我們所做的最好的事情是他們可以輕鬆執(zhí)行更新而無(wú)需離開(kāi)管理員。

您可以繼續(xù)從文章上方的連結(jié)下載完整的原始程式碼。該程式碼還包含本教程前一部分中涵蓋的主題。

由於這是我的第一個(gè)教學(xué)系列，我非常感謝任何回饋、評(píng)論和建議。讓我知道你的想法！