Создаём страницу настроек для WordPress плагина

Продолжим разговор о том, как написать свой плагин для WordPress.
В прошлый раз мы рассмотрели вопрос предустановленные настройки wordpress плагина, а сегодня попробуем написать его административную страницу. Для начала приведу функцию создания этой страницы, а затем на некоторых моментах остановлюсь подробней. В принципе основные сведения были даны в предыдущей части руководства, здесь же достаточно просто кода с комментариями.

Функция создания страницы настроек для плагина WordPress


function myplugin_options_page() { //Функция создания и обработки страницы настроек плагина
global $wpdb, $myplugin_prefs_table;
$myplugin_options = array( //Создаём массив с настройками плагина
'myplug_modify_title',
'myplug_modify_content',
);
$cmd = $_POST['cmd']; //Обработка пользовательского ввода
foreach ($myplugin_options as $myplugin_opt) {
$$myplugin_opt = get_option($myplugin_opt);
}
if ($cmd == "del_prefs") { //Если нажато "удалить фразы" - очищаем таблицу настроек плагина
$sql = "TRUNCATE TABLE $myplugin_prefs_table";
$wpdb->query( $sql );
?>
<div class="updated"><p><strong> <?php echo __('All phrases are removed from the database','example_plugin'); ?></strong></p></div> /* Сообщаем пользвателю об успешной очистке. */
<?php
}
if ($cmd == "add_prefs" && $_POST['prefs_base']) { //Если введены новые фразы в соотв. поле - обработаем их
$lines = explode("\n", $_POST['prefs_base']); //Ввод разбивается на строки и кладётся в массив, разделитель - перевод строки
foreach($lines as $line){ //Перебираем массив со строками
$line = trim($line); //Обрезка каждой строки от переводов
if (!$line) continue; //Если строка отстутствует - переходим к следующей итерации
list($title, $body) = explode("|", $line); //Разделение строки на две подстроки
//Кладём подстроки в таблицу плагина.
$sql = "INSERT INTO $myplugin_prefs_table (title, body) VALUES('$title','$body')";
$wpdb->query($sql);
}
?>
<div class="updated"><p><strong> <?php echo __('Phrases added to the database','example_plugin'); ?></strong></p></div> /*Сообщаем пользователю об успешной обработке*/
<?php
}
if ($cmd == "myplugin_save_opt") { //Обработка нажатия "Сохранить настройки"
foreach ($myplugin_options as $myplugin_opt) { //Перебор массива с настройками
$$myplugin_opt = $_POST[$myplugin_opt]; //Каждому элементу массива присваиваем введённое пользователем занчение
}

<?php
//Конец функции создания и обработки страницы настроек.
}
?>


Я постарался прокомментировать в коде все ключевые моменты, для глубокого понимания в любом случае стоит читать про html и CGI-программирование в целом. Хотя в принципе — здесь всё интуитивно понятно, а если будет необходимость добавить новые элементы на страницу настроек — обращайтесь, как минимум — подскажу, в какую сторону копать.

В следующем выпуске я перейду к рассмотрению функциональной части плагина для WordPress. Расскажу, как написать для плагина функции, получающие данные из базы и модифицирующие wordpress-публикации.
Затем займёмся русификацией плагина (внимательные должны были обратить внимание на вызовы вида Add phrases — это как раз задел для будущего грамотного перевода (фактически — интернационализации) плагина).
А в заключение — расскажу, как отправить свой плагин для проверки и последующей публикации в репозитории WordPress на wordpress.org.
Не пропустите! 🙂

P.S. По-прежнему доступен для скачивания файл плагина, уже обновлённый.

Другие заметки по созданию плагина для WordPress