Думаю ті хто колись качали теми для WordPress або купували їх на таких біржах як themeforest, помічали що багато тем після встановлення та активації просять встановити для них необхідні плагіни. Сьогодні ми поговоримо про бібліотеку Активація плагіна TGM яка дає можливість встановлювати плагіни після активації теми, дізнаємося як у преміум темах усі плагіни ставляться на автоматі. Плагіни можна буде встановлювати як із репозиторію WordPress, так і з інших зовнішніх джерел, також можна буде встановлювати плагіни які розробляли ви та поклали у вашу тему. Клас цієї бібліотеки встановлює та активує плагіни на основі WordPress API, а це означає, що проблем при оновленні бути не повинно.

Як настроїти TGM Plugin Activation

Налаштування ми будемо проводити на стандартній темі TwentyEleven, але ви можете скористатися й іншою темою, перевірте тільки щоб у вашій темі у файлі style.css, був доданий коментар виду: Текстовий домен: двадцять одинадцять. Нижче у шкірі ми будемо його використовувати у змінній $theme_text_domain = «двадцять одинадцять»;.

Для початку нам необхідно завантажити бібліотеку з сайту розробників або з GitHub і покласти в корінь нашої теми файл class-tgm-plugin-activation.php та папку плагіни з усім її вмістом.

Після того як необхідні скопійовані файли нам потрібно підключити наш клас до шаблону. Підключення класу здійснюємо через файл functions.php.

У файл functions.php, у верхній частині додаємо код виклику функції встановлення обов'язкових плагінів:

require_once dirname(__ФАЙЛ__).'/class-tgm-plugin-activation.php';
add_action('tgmpa_register','my_theme_register_required_plugins');

Нижче додамо код самої функції:

function my_theme_register_required_plugins(){
	$plugins = array(
		/* установка плагинов из папки темы, которые вы поставляете в комплекте */
		array(
			'ім'я' => 'TGM Example Plugin', // имя  плагина
			'slug' => 'tgm-example-plugin', // Имя плагина (совпадает с именем папки плагина)
			'source' => get_stylesheet_directory().'/plugins/tgm-example-plugin.zip', // источник плагина
			'required' => false, 
			// 'required' - плагин обязательый? нужно ли го активировать поле установки?
		),
		/* установка плагинов на автомате из репозитория wordpress */
		array(
			'ім'я' => 'Edit Howdy',
			'slug' => 'edit-howdy', 
			// слуг можно посмотреть в ссылке к плагину
			// https://wordpress.org/plugins/edit-howdy/ - edit-howdy			
		),
		array(
			'ім'я' => 'Evanto dashboard',
			'slug' => 'evantodashboard',
			'source' => get_stylesheet_directory().'/plugins/evantodashboard.zip', // источник плагина
			'required' => false,
		),
	);
	
	$theme_text_domain = 'twentyeleven'; // текстовый домен темы
	$config = array(
		/*domain => $theme_text_domain, // текстовый домен, точно такой как указан в вашей теме*/
		/*dafault_path => '', // Абсолютный путь по умолчанию к папке плагинов*/
		/*menu => 'install-my-theme-plugin', // Menu slug*/
		'settings' => array(
			/*'page_title'	=> __('Install Required Plugins', $theme_text_domain)*/
			/*'menu_title'	=> __('Install Plugins', $theme_text_domain)*/
			/*'instructions_install'	=> __( 'The %1$s plugin is required for this theme. Click on the big blue button below to install and activate %1$s.', $theme_text_domain ), // %1$s = plugin name */
			/*'instructions_activate'  => __( 'The %1$s is installed but currently inactive. Будь ласка, перейдіть на сторінку <a href="%2$с">сторінка адміністрування плагінів</a> сторінка, щоб активувати його"., $theme_text_domain ), // %1$s = plugin name, %2$s = URL-адреса сторінки плагінів */
			/*'кнопка' => __( "Встановити %s зараз", $theme_text_domain ), // %1$s = plugin name */
			/*'встановлення' => __( 'Встановлення плагіна: %s', $theme_text_domain ), // %1$s = plugin name */
			/*'упс' => __( "Щось пішло не так з API плагіна"., $theme_text_domain ), // */
			/*'notice_can_install' => __( "Для цієї теми потрібен плагін %1$s. <a href="%2$с"><strong>Натисніть тут, щоб розпочати процес встановлення</strong></a>. Вас можуть попросити надати облікові дані FTP на основі налаштувань вашого сервера.", $theme_text_domain ), // %1$s = plugin name, %2$s = URL-адреса сторінки TGMPA */
			/*'notice_cannot_install' => __( "Вибачте, але у вас немає правильних дозволів на встановлення плагіна %s. Зверніться до адміністратора цього сайту, щоб отримати допомогу щодо встановлення плагіна.", $theme_text_domain ), // %1$s = plugin name */
			/*'notice_can_activate' => __( "Для цієї теми потрібен плагін %1$s. Цей плагін наразі неактивний, тому, будь ласка, перейдіть до <a href="%2$с">сторінка адміністрування плагінів</a> щоб активувати його"., $theme_text_domain ), // %1$s = plugin name, %2$s = URL-адреса сторінки плагінів */
			/*'notice_cannot_activate' => __( "Вибачте, але у вас немає правильних дозволів на активацію плагіна %s. Зверніться до адміністратора цього сайту за допомогою щодо активації плагіна.", $theme_text_domain ), // %1$s = plugin name */
			/*'повернення' => __( "Повернутися до обов'язкового інсталятора плагінів", $theme_text_domain ), // */
		),
	);
	TGMPA( $плагіни, $конфігурація );
}

Якщо ви все зробили правильно, то побачите повідомлення про те, що необхідно встановити плагіни, які є обов'язковими для даної теми, повідомлення буде такого виду.

Натискаємо на кнопку Почніть установку плагінів і у вас з'явиться вікно зі списком ваших плагінів.

У вікні ми можемо бачити, що пункт Edit Howdy відображається як посилання, при натисканні ви зможете почитати про цю плагін, тому що ми його встановлюємо з репозиторію. Інші плагіни будуть неактивними, оскільки встановлюватимуться з папки теми.

Запустимо автоматичне встановлення плагінів

• Виберіть плагіни, які необхідно встановити,
• Виберіть дію “install”,
• Натисніть застосувати.

Якщо все зробили правильно, то у вас 2 плагіна встановляться і один виведе помилку (Під час встановлення інформаційної панелі Evanto сталася помилка: Завантаження не вдалося. Надана неправильна URL-адреса..). Помилка з'явилася тому, що в нашу тему ми не додавали файл плагіна Evanto dashboard.

Залишилося тільки відзначити всі необхідні плагіни та активувати їх.

Якщо все зробили правильно, то ви отримаєте повідомлення (Наступні плагіни успішно активовано: Редагувати Привіт і плагін прикладу TGM).

Якщо ви не встановили всі плагіни і вирішили робити установку по одному, при цьому ви втратили вікно установки, то ви завжди зможете повернутися на сторінку установки через меню адміністратора у розділі Зовнішній вигляд -> Встановіть плюсіни.

От і все, пробуємо встановлювати свої плагіни! Успіхів у розробці зручних та якісних тем для WordPress.