Automatická instalace pluginů vyžadovaných šablonou

Vytváříte vlastní šablony, děláte na zakázku, nebo publikujete free vzhledy pro redakční systém WordPress? Určitě jste se dostali do situace, kdy jste museli klientovi, nebo komukoliv jinému, kdo chce vaši šablonu použít, že aby se mu ty obrázky hýbali stejně jako na demu, musí si nainstalovat takový a takový plugin. Mám pro vás tip na zajímavou třídu, pomocí které jednoduše rozšíříte funkčnost vaší šablony o upozornění na nutnost instalovat potřebné pluginy.

Třída se jmenuje TGM plugin activation a najdete ji na Github https://github.com/thomasgriffin/TGM-Plugin-Activation.

Pro přidání této funkčnosti nemusíte stahovat zip soubor, ale stačí jen do složky šablony umístit soubor class-tgm-plugin-activation.php. Předpokládám, že většina z vás chce mít v souborech pořádek, tak má v šabloně složku například library, kam takové soubory umísťuje. Na Githubu je také soubor examples, kde je popsána implementace třídy a který si doporučuji projít.

Vložení třídy a nastavení

do souboru functions.php musíme nejprve třídu vložit, proto do něj přidáme následující řádek:

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

Samozřejmě, pokud máte soubor umístěn jinde, cesta bude odlišná.

Dále musíme zaregistrovat funkci, pomocí které budeme třídu aktivovat:

add_action( 'tgmpa_register', 'my_theme_register_required_plugins' );

Vytvoříme si vlastní funkci:

function my_theme_register_required_plugins() {
 
}

A do té začneme vkládat potřebné údaje. Jako první vytvoříme pole, do kterého budeme vkládat jednotlivé pluginy:

$plugins = array(
 
array(
'name'=> 'Ourplugin', 
'slug'=> 'ourplugin', 
'source'=> get_stylesheet_directory() . '/includes/plugins/our_plugin.zip',
'required'=> true, 
'version'=> '', 
'force_activation'=> true,
'force_deactivation'=> false,
		),
);
  • Name je jméno pluginu,
  • slug je url pluginu v administraci,
  • source je url zip souboru pluginu,
  • required znamená, že je plugin vyžadovaný, pokud jej nastavíte na false, bude jen doporučený,
  • version – pokud ji vyplníte, bude vyžadována stejná, nebo vyšší verze pluginu,
  • force_activation znamená, že plugin je aktivovaný se šablonou a nejde deaktivovat, dokud je šablona aktivní,
  • force_deactivation naopak znamená deaktivaci pluginu při deaktivaci šablon.
Čtěte  Jak povolit zakázané typy souborů

Celé pole s hodnotami můžete opakovat pro tolik pluginů, kolik budete potřebovat. Podle toho, jaké hodnoty nastavíte, bude se po instalaci šablony zobrazovat upozornění, že jsou pluginy vyžadovány, nebo doporučeny. Dále se také u upozornění zobrazí odkaz na instalaci a aktivaci pluginů, takže uživatel nemusí nic hledat. Díky tomu, že je upozornění stále viditelné, bude uživatel vědět, co má dělat.

Jako poslední krok musíme do funkce přidat ještě konfiguraci, takže pod pole, které jsme si vytvořili přidáme následující řádky:

$theme_text_domain = 'tgmpa';

Textovou doménu pro případný překlad a pole $config které můžete nechat tak jak je a nemusíte na něm nic měnit:

$config = array(
'domain'       		=> $theme_text_domain,
'default_path' 		=> '', 
'parent_menu_slug' 	=> 'themes.php', 
'parent_url_slug' 	=> 'themes.php', 
'menu'         		=> 'install-required-plugins', 
'has_notices'      	=> true,                       
'is_automatic'    	=> false,			
'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 ), // %1$s = plugin name
'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' 
		)
	);
Čtěte  Jak zobrazovat obsah webu v Google Answer Boxu s CTR přes 32 %?

Přestože vypadá složitě, jedná se většinou o výpis různých upozornění.

Nakonec vložíme:

tgmpa( $plugins, $config );

Pokud jste vše udělali správně, po aktivaci vaší šablony by se mělo zobrazit upozornění na nutnost instalace definovaných pluginů.

About The Author

Zajímá mne Wordpress, responsivní šablony a zkrátka vše kolem tohoto skvělého redakčního systému.

Související články

Přidejte komentář

Vaše emailová adresa nebude zveřejněna. Vyžadované informace jsou označeny *

Chcete mít přehled o dění ve světě WordPressu?

Přímo do vašeho emailu

Pravidelný přehled o novinkách, trendech a událostech, které se točí kolem WordPressu. Souhrn toho nejzajímavějšího od nás i ze zahraničí.