Элементы управления плагином

При реализации плагина часто требуется выводить в админку элменеты управления:

• Включение/отключение какой-либо функции
• Ввод информации, либо изображения
• Выбор чего-либо из списка
• и т.д.

Создаем меню элемента управления

function true_options() {
	global $true_page;
	add_plugins_page( 'Управление модулями', 'Управление модулями', 'manage_options', 'my-plugin.php', 'true_option_page');  
}
add_action('admin_menu', 'true_options');

Для того, чтобы добавить подменю уже в существующие стандартные пункты меню используется функции:

• add_dashboard_page — Добавляет подменю в меню Консоль (Dashboard)
• add_posts_page — Добавляет подменю в меню Записи (Posts)
• add_media_page — Добавляет подменю в меню Медиафайлы (Media)
• add_links_page — Добавляет подменю в меню Ссылки (Links)
• add_pages_page — Добавляет подменю в меню Страницы (Pages)
• add_comments_page — Добавляет подменю в меню Комментарии (Comments)
• add_theme_page — Добавляет подменю в меню Внешний вид (Appearance)
• add_plugins_page — Добавляет подменю в меню Плагины (Plugins)
• add_users_page — Добавляет подменю в меню Пользователи (Users)
• add_management_page — Добавляет подменю в меню Инструменты (Tools)
• add_options_page — Добавляет подменю в меню Параметры (Settings)

Далее создаем функцию вывода — то что будет на странице настроек

// Возвратная функция (Callback)
function true_option_page(){
 global $true_page;
 ?><div class="wrap">
 <h2>Дополнительные параметры сайта</h2>
 <form method="post" enctype="multipart/form-data" action="options.php">
 <?php 
 settings_fields('true_options'); // меняем под себя только здесь (название настроек)
 do_settings_sections($true_page);
 ?>
 <p class="submit"> 
 <input type="submit" class="button-primary" value="<?php _e('Save Changes') ?>" /> 
 </p>
 </form>
 </div><?php
}

И далее функции регистрации и создания полей управления

// Регистрируем настройки
// Настройки будут храниться в базе под названием true_options (это также видно в предыдущей функции)
function true_option_settings() {
global $true_page;
// Присваиваем функцию валидации ( true_validate_settings() ). Вы найдете её ниже
register_setting( 'true_options', 'true_options', 'true_validate_settings' ); // true_options

// Добавляем секцию
add_settings_section( 'true_section_1', 'Текстовые поля ввода', '', $true_page );

// Создадим текстовое поле в первой секции
$true_field_params = array(
'type' => 'text', // тип
'id' => 'my_text',
'desc' => 'Пример обычного текстового поля.', // описание
'label_for' => 'my_text' // позволяет сделать название настройки лейблом (если не понимаете, что это, можете не использовать), по идее должно быть одинаковым с параметром id
);
add_settings_field( 'my_text_field', 'Текстовое поле', 'true_option_display_settings', $true_page, 'true_section_1', $true_field_params );

// Создадим textarea в первой секции
$true_field_params = array(
'type' => 'textarea',
'id' => 'my_textarea',
'desc' => 'Пример большого текстового поля.'
);
add_settings_field( 'my_textarea_field', 'Большое текстовое поле', 'true_option_display_settings', $true_page, 'true_section_1', $true_field_params );

// Добавляем вторую секцию настроек

add_settings_section( 'true_section_2', 'Другие поля ввода', '', $true_page );

// Создадим чекбокс
$true_field_params = array(
'type' => 'checkbox',
'id' => 'my_checkbox',
'desc' => 'Пример чекбокса.'
);
add_settings_field( 'my_checkbox_field', 'Чекбокс', 'true_option_display_settings', $true_page, 'true_section_2', $true_field_params );

// Создадим выпадающий список
$true_field_params = array(
'type' => 'select',
'id' => 'my_select',
'desc' => 'Пример выпадающего списка.',
'vals' => array( 'val1' => 'Значение 1', 'val2' => 'Значение 2', 'val3' => 'Значение 3')
);
add_settings_field( 'my_select_field', 'Выпадающий список', 'true_option_display_settings', $true_page, 'true_section_2', $true_field_params );

// Создадим радио-кнопку
$true_field_params = array(
'type' => 'radio',
'id' => 'my_radio',
'vals' => array( 'val1' => 'Значение 1', 'val2' => 'Значение 2', 'val3' => 'Значение 3')
);
add_settings_field( 'my_radio', 'Радио кнопки', 'true_option_display_settings', $true_page, 'true_section_2', $true_field_params );

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


// Функция отображения полей ввода
// Здесь задаётся HTML и PHP, выводящий поля

function true_option_display_settings($args) {
extract( $args );

$option_name = 'true_options';

$o = get_option( $option_name );

switch ( $type ) {
case 'text':
$o[$id] = esc_attr( stripslashes($o[$id]) );
echo "<input class='regular-text' type='text' id='$id' name='" . $option_name . "[$id]' value='$o[$id]' />";
echo ($desc != '') ? "<br /><span class='description'>$desc</span>" : "";
break;
case 'textarea':
$o[$id] = esc_attr( stripslashes($o[$id]) );
echo "<textarea class='code large-text' cols='50' rows='10' type='text' id='$id' name='" . $option_name . "[$id]'>$o[$id]</textarea>";
echo ($desc != '') ? "<br /><span class='description'>$desc</span>" : "";
break;
case 'checkbox':
$checked = ($o[$id] == 'on') ? " checked='checked'" : '';
echo "<label><input type='checkbox' id='$id' name='" . $option_name . "[$id]' $checked /> ";
echo ($desc != '') ? $desc : "";
echo "</label>";
break;
case 'select':
echo "<select id='$id' name='" . $option_name . "[$id]'>";
foreach($vals as $v=>$l){
$selected = ($o[$id] == $v) ? "selected='selected'" : '';
echo "<option value='$v' $selected>$l</option>";
}
echo ($desc != '') ? $desc : "";
echo "</select>";
break;
case 'radio':
echo "<fieldset>";
foreach($vals as $v=>$l){
$checked = ($o[$id] == $v) ? "checked='checked'" : '';
echo "<label><input type='radio' name='" . $option_name . "[$id]' value='$v' $checked />$l</label><br />";
}
echo "</fieldset>";
break;
}
}

Поделиться в соц. сетях: