Tema tidak dimaksudkan untuk berfungsi, tetapi sebagai pembangun tema, kami terutamanya perlu menyertakan beberapa ciri untuk menjadikan tema kami lebih baik dan berfungsi.

Dalam tutorial ini kita akan belajar tentang istilah "alam pemalam" dan belajar menggunakan alat yang sangat baik yang ditulis oleh Thomas Griffin: perpustakaan pengaktifan pemalam TGM.

Fungsi tema: Menceroboh wilayah pemalam

Tema direka untuk menukar reka bentuk laman web WordPress anda. Sebaik-baiknya, ia mestilah visual. Tetapi dalam zaman kegemilangan WordPress, pembangun tema sering memasukkan ciri fungsi dalam tema mereka untuk kekal berdaya saing di pasaran. Ia sepatutnya begitu, tetapi ia adalah.

Ini adalah pencerobohan wilayah pemalam. Kita boleh mentakrifkan "domain pemalam" secara ringkas: bahagian fungsi kod terletak dalam sempadan domain. Setiap kod yang mengubah fungsi tapak web anda perlu tersedia sebagai pemalam (jika ia belum tersedia dalam teras WordPress).

Dalam salah satu artikel saya sebelum ini (dalam siri "Membuat tema WordPress yang sempurna") saya menyebut peraturan praktikal dalam "dunia pemalam":

Jika ciri itu berkaitan dengan penampilan visual tapak, ia harus berada dalam tema, tetapi jika ia berkaitan dengan fungsi tapak, ia harus disertakan sebagai pemalam yang berasingan dalam tema.

Mudah kan?

Walaupun orang masih cenderung untuk mengekodkan bit ciri ke dalam tema mereka, direktori tema (seperti WordPress.org dan ThemeForest) tidak menerima tema yang menceroboh "alam pemalam". Oleh itu, menyediakan fungsi dengan tema menjadi masalah.

Nasib baik, terdapat penyelesaian yang agak mudah, dan ia tidak melanggar peraturan "alam pemalam".

Memperkenalkan perpustakaan pengaktifan pemalam TGM

TGM Plugin Activation ialah perpustakaan ringan yang direka untuk menggabungkan tema dengan pemalam. Ideanya mudah: apabila pengguna memasang tema anda, ia membenarkan pengguna memasang pemalam daripada WordPress.org, tapak web luaran atau folder tema. Begini cara pencipta perpustakaan, Thomas Griffin, mentakrifkan alat kecil yang berguna ini:

TGM Plugin Activation ialah perpustakaan PHP yang membolehkan anda meminta atau mengesyorkan pemalam dengan mudah untuk tema (dan pemalam WordPress anda). Ia membolehkan pengguna anda memasang dan juga mengaktifkan pemalam secara automatik dalam cara tunggal atau kelompok menggunakan kelas, fungsi dan antara muka WordPress asli. Anda boleh merujuk pemalam prabungkus, pemalam dari repositori pemalam WordPress, atau pemalam yang dihoskan di tempat lain di internet.

Ini mungkin penyelesaian paling bijak untuk masalah "plugin territory invasion". Dan ia mudah untuk digunakan.

Jom tengok!

Pasang pengaktifan pemalam TGM

Ia sangat mudah untuk memasang dan mengaktifkan pemalam TGM. Ikuti sahaja langkah berikut:

• Muat turun pustaka pengaktifan pemalam TGM daripada bahagian Muat Turun pada halaman.
• Buka fail zip dan ekstrak class-tgm-plugin-activation.php ke folder tema anda (di mana-mana sahaja yang anda suka). class-tgm-plugin-activation.php 解壓到您的主題文件夾（任何您喜歡的位置）。
• 打開(kāi)主題的 functions.php 文件并使用 require_once() 函數(shù)在主題中（一次）請(qǐng)求類文件。
• 創(chuàng)建一個(gè)函數(shù)來(lái)配置 TGM 插件激活，并通過(guò) add_action() 函數(shù)將其掛鉤到 tgmpa_register。
• 完成！

這非常簡(jiǎn)單，您甚至不需要復(fù)雜的 PHP 代碼來(lái)要求或推薦插件?？匆幌孪旅娴拇a：

<?php

/**
 * Since I'm already doing a tutorial, I'm not going to include comments to
 * this code, but if you want, you can check out the "example.php" file
 * inside the ZIP you downloaded - it has a very detailed documentation.
 */

require_once dirname( __FILE__ ) . '/class-tgm-plugin-activation.php';

add_action( 'tgmpa_register', 'mytheme_require_plugins' );

function mytheme_require_plugins() {

    $plugins = array( /* The array to install plugins */ );
    $config = array( /* The array to configure TGM Plugin Activation */ );

    tgmpa( $plugins, $config );

}

?>

從現(xiàn)在開(kāi)始，您可以通過(guò)在剛剛創(chuàng)建的函數(shù)中設(shè)置 $plugins 變量來(lái)讓用戶安裝新插件。

讓我們看看它是如何完成的。

通過(guò) TGM 插件激活安裝插件

從上面可以看出，$plugins

Buka fail functions.php tema anda dan gunakan fungsi require_once() untuk meminta fail kelas (sekali) dalam tema anda.

Buat fungsi untuk mengkonfigurasi pengaktifan pemalam TGM dan sangkutkannya ke tgmpa_register melalui fungsi add_action(). ?? ??Selesai! ?? ??Sangat mudah, anda tidak memerlukan kod PHP yang rumit untuk meminta atau mengesyorkan pemalam. Lihat kod di bawah: ??

<?php

$plugins = array(
	array( /* my first plugin */ ),
	array( /* my second plugin */ ),
	array( /* my third plugin */ ),
	// ...
	array( /* my nth plugin */ )
);

?>

??Mulai sekarang, anda boleh membenarkan pengguna memasang pemalam baharu dengan menetapkan pembolehubah $plugins dalam fungsi yang baru anda buat. ?? ??Mari kita lihat bagaimana ia dilakukan. ?? ??Pasang pemalam melalui pengaktifan pemalam TGM?? ??Seperti yang anda boleh lihat daripada di atas, pembolehubah $plugins ialah tatasusunan. Untuk menentukan pemalam untuk dipasang, anda perlu mencipta tatasusunan dalam tatasusunan itu (supaya anda boleh menetapkan parameter anda sendiri). Kedengaran sukar, tetapi tidak: ??

<?php

$plugins = array(
	array(
		'name'      => 'BuddyPress',
		'slug'      => 'buddypress',
		'required'  => false, // this plugin is recommended
	)
);

?>

??Terdapat beberapa parameter yang tersedia: ??

• name（字符串，必需）- 插件的名稱。
• slug （字符串，必需）- 插件的 slug（通常是其文件夾的名稱）。
• required （布爾值，必需） - 如果設(shè)置為 true，您的主題將“需要”該插件。如果false，主題將“推薦”它。
• source （字符串，有時(shí)需要）- 插件的源。如果是 WordPress.org 插件，則不應(yīng)使用此參數(shù)；否則，這是必需的。
• version (字符串，可選) - 插件所需的最低版本。例如;如果主題用戶已經(jīng)安裝了所需的插件，但沒(méi)有達(dá)到您指定的最低版本號(hào)，TGM 插件激活會(huì)警告用戶進(jìn)行更新。
• force_activation （布爾值，可選） - 如果設(shè)置為 true，當(dāng)您的主題處于活動(dòng)狀態(tài)時(shí)，用戶將無(wú)法停用插件。有點(diǎn)煩人，但在某些情況下可能是必要的。
• force_deactivation （布爾值，可選） - 如果設(shè)置為 true，一旦用戶切換主題，插件將被停用。
• external_url (字符串，可選) - 如果設(shè)置，插件的名稱將鏈接到插件要求通知中的此地址。

您可以通過(guò)三個(gè)選項(xiàng)讓您的用戶通過(guò) TGM 插件激活安裝插件：您可以從 WordPress 插件目錄、外部源（例如您自己的服務(wù)器或 CDN）或您的主題文件夾（例如/my-theme/plugins/shortcodes.zip)。

需要 WordPress.org 的插件

<?php

$plugins = array(
	array(
		'name'      => 'BuddyPress',
		'slug'      => 'buddypress',
		'required'  => false, // this plugin is recommended
	)
);

?>

從外部源請(qǐng)求插件

<?php

$plugins = array(
	array(
		'name'               => 'My Awesome Plugin',
		'slug'               => 'my-awesome-plugin',
		'source'             => 'http://files.my-website.com/my-awesome-plugin.zip',
		'required'           => true, // this plugin is required
		'external_url'       => 'http://my-website.com/introducing-my-awesome-plugin', // page of my plugin
		'force_deactivation' => true, // deactivate this plugin when the user switches to another theme
	)
);

?>

從主題目錄中獲取插件

<?php

$plugins = array(
	array(
		'name'               => 'My Super Sleek Slider',
		'slug'               => 'my-super-sleek-slider',
		'source'             => get_stylesheet_directory() . '/lib/plugins/my-super-sleek-slider.zip', // The "internal" source of the plugin.
		'required'           => true, // this plugin is required
		'version'            => '1.2', // the user must use version 1.2 (or higher) of this plugin
		'force_activation'   => false, // this plugin is going to stay activated unless the user switches to another theme
	)
);

?>

配置 TGM 插件激活

注意到示例代碼末尾帶有兩個(gè)參數(shù)的 tgmpa() 函數(shù)了嗎？第二個(gè)參數(shù)是 $config 變量，它也恰好是一個(gè)數(shù)組，就像 $plugins 參數(shù)一樣。顧名思義，您可以使用此數(shù)組配置 TGM 插件激活庫(kù)。它還有自己的一組選項(xiàng)需要設(shè)置：

• id（字符串） - 您在主題中實(shí)現(xiàn)的 TGM 插件激活庫(kù)的唯一 ID。這實(shí)際上非常重要：如果另一個(gè)插件也使用 TGM 插件激活，則不同的 ID 可以防止沖突。
• default_path (string) - 主題內(nèi)插件的默認(rèn)絕對(duì)路徑。設(shè)置此選項(xiàng)后，您可以使用 ZIP 文件的名稱作為插件的 source 參數(shù)。
• menu (字符串) - 插件安裝頁(yè)面的菜單項(xiàng)。
• has_notices (boolean) - 如果設(shè)置為 true，則會(huì)顯示必需/推薦插件的管理員通知。
• dismissible (boolean) - 如果設(shè)置為 true，用戶可以“忽略”通知。
• dismiss_msg (string) - 如果 dismissable 選項(xiàng)設(shè)置為 false，則此消息將顯示在管理通知上方。
• is_automatic (boolean) - 如果設(shè)置為 true，插件將在用戶同意安裝后激活。
• message (string) - 在插件表之前顯示的可選 HTML。
• strings (array) - 另一個(gè) array 包含要顯示的消息。您也可以將它們?cè)O(shè)置為可翻譯字符串。查看 example.php 文件以查看消息字符串的完整列表。

<?php

$config = array(
	'id'           => 'mytheme-tgmpa', // your unique TGMPA ID
	'default_path' => get_stylesheet_directory() . '/lib/plugins/', // default absolute path
	'menu'         => 'mytheme-install-required-plugins', // menu slug
	'has_notices'  => true, // Show admin notices
	'dismissable'  => false, // the notices are NOT dismissable
	'dismiss_msg'  => 'I really, really need you to install these plugins, okay?', // this message will be output at top of nag
	'is_automatic' => true, // automatically activate plugins after installation
	'message'      => '<!--Hey there.-->', // message to output right before the plugins table
	'strings'      => array(); // The array of message strings that TGM Plugin Activation uses
);

?>

總結(jié)一切

正如您所看到的，通過(guò) WordPress 主題提供功能并非不可能 - 您只需考慮用戶從您的主題切換到另一個(gè)主題時(shí)的情況。 TGM 插件激活庫(kù)提供了一種非常聰明的按書(shū)本操作的方法。

您覺(jué)得這個(gè)工具怎么樣？您曾經(jīng)使用過(guò)它，或者您打算將來(lái)使用它嗎？請(qǐng)?jiān)谙旅姘l(fā)表評(píng)論，告訴我們您的想法。如果您喜歡這篇文章，請(qǐng)不要忘記與您的朋友分享！