Tingkatkan tema anda: Sepadukan pemalam Envato WordPress Toolkit

Sebagai pengarang WordPress di ThemeForest, kami berharap dapat memastikan pelanggan kami gembira dengan memberikan mereka pembetulan pepijat dan peningkatan tema sekali-sekala. Tetapi isu utama yang kami hadapi ialah cara memberitahu pengguna kami apabila kemas kini tersedia untuk dimuat turun.

Pada masa lalu, kami masing-masing perlu mengekod dalam pelaksanaan pemberitahuan kemas kini tema kami sendiri. Walaupun kini terdapat kotak pilihan untuk mendayakan pemberitahuan kemas kini projek dalam Pasaran Envato, pengguna masih perlu menghidupkannya untuk setiap projek dan melakukan kemas kini tema secara manual.

Bukankah lebih baik jika pemberitahuan kemas kini muncul di pusat pentadbir WordPress? Dan bolehkah kemas kini dilakukan dengan segera dalam pentadbir? Nasib baik, kami kini mempunyai pemalam Envato WordPress Toolkit dan pustaka toolkit.

Dalam siri ini, anda akan belajar cara menyepadukan kit alat ini ke dalam tema anda.

Apa yang akan kami kupas dalam siri ini

Dalam tutorial ini, kami akan melaksanakan pemalam Envato WordPress Toolkit dan perpustakaan ke dalam tema kami. Apabila tema kami diaktifkan, pengguna akan diminta untuk memasang dan mengaktifkan pemalam Toolkit.

Setelah pemalam aktif, tema kami akan menyemak kemas kini dengan kerap dan jika kemas kini ditemui, pemberitahuan akan dipaparkan dalam pentadbir mengarahkan pengguna mengakses pemalam untuk mengemas kini tema.

Tutorial ini terbahagi kepada dua bahagian:

• Bahagian 1 - Mengintegrasikan kelas pengaktifan pemalam TGM supaya menggunakan tema kami memerlukan pemalam Envato WordPress Toolkit dan
;
• Bahagian 2 - Melaksanakan perpustakaan Envato WordPress Toolkit ke dalam tema kami untuk membenarkan semakan dan kemas kini versi tema baharu.

Plugin dan perpustakaan?

Envato WordPress toolkit datang dalam dua perisa dengan kegunaan dan tujuan yang berbeza. Untuk mengelakkan kekeliruan kedua-duanya, berikut adalah perbandingan:

• ToolkitPlugin - Ini ialah pemalam kendiri yang boleh dipasang oleh mana-mana pelanggan Envato dalam laman WordPress mereka. Selepas pengaktifan, semua tema yang dibeli sebelum ini serta kemas kini tema boleh dimuat turun terus daripada pentadbir.
• Perpustakaan Toolkit - Pengarang boleh memasukkan kod dalam tema WordPress mereka yang membolehkan tema menyemak kemas kini versi tema dan mengemas kini sendiri menggunakan API Envato Marketplace.

1.Sertakan dokumen yang diperlukan

Kami terlebih dahulu perlu memasukkan beberapa fail dalam projek. Kami akan menggabungkan pemalam Toolkit dengan tema kami dan menggunakan pengaktifan pemalam TGM untuk memasang dan mengaktifkan Toolkit.

1. Muat turun pemalam TGM untuk mengaktifkan dan meletakkan skrip kelas utama ke dalam folder inc dalam tema. Laluan hendaklah: mytheme/inc/class-tgm-plugin-activation.php
2. Seterusnya, muat turun fail ZIP pemalam Envato WordPress Toolkit dan letakkannya ke dalam folder baharu yang dipanggil “plugin” dalam tema anda. Laluan hendaklah: mytheme/plugins/envato-wordpress-toolkit-master.zip

2.Fungsi cangkuk TGM

Sekarang kita mempunyai fail yang diperlukan, mari mulakan pengekodan. Kita perlu memasukkan kelas pengaktifan pemalam TGM dalam functions.php dan menyambung ke dalam tindakan WordPress tersuai. Di sini kami akan menyediakan beberapa tetapan untuk TGM dan menentukan pemalam untuk disertakan.

/**
 * 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.Nyatakan pemalam Kit Alat

Seterusnya, kami mengkonfigurasi parameter yang diperlukan untuk memasukkan pemalam Toolkit. Di dalam fungsi tgmpa_register_toolkit, tambahkan kod berikut. Jika anda menetapkan folder pemalam lain dalam tgmpa_register_toolkit 函数内，添加以下代码。如果您在第 1 步中指定了另一个插件文件夹，请更改源参数中的路径。

// 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 变量添加更多数组来添加其他插件。

4.配置TGM

然后设置 TGM 的选项。同样在 tgmpa_register_toolkit 函数中，在上一步下方添加以下代码来配置 TGM。我不会深入探讨各个设置的具体作用。如果您想了解有关这些设置的更多信息，TGM 插件激活网站可以很好地解释每一个细节。

// 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 变量更改为您正在使用的文本域，或将其保留为 default。

5.启动TGM

最后，让我们在 tgmpa_register_toolkitLangkah 1

tgmpa( $plugins, $config );

4.

Kemudian tetapkan pilihan TGM. Juga dalam fungsi tgmpa_register_toolkit, tambahkan kod berikut di bawah langkah sebelumnya untuk mengkonfigurasi TGM. Saya tidak akan menerangkan secara spesifik perkara yang dilakukan oleh setiap tetapan. Jika anda ingin mengetahui lebih lanjut tentang tetapan ini, tapak web TGM Plugin Activation melakukan kerja yang bagus untuk menerangkan setiap butiran. rrreee

Mulakan TGM

Akhir sekali, mari kita mulakan TGM sebelum fungsi tgmpa_register_toolkit tamat.

Simpan