Пишем плагин для WordPress
Для того чтобы не изобретать велосипеды, необходимо с генерировать шаблоны файлов плагина. Например при помощи этого сервиса. В моём случае плагин называется ssk_read, поэтому далее везде фигурирует в названиях файлов он.
Получится структура папок вида:
Необходимо поместить все файлы в папку /wp_content/plugins..и собственно на этом моменте плагин уже будет доступен в админке для ативации.
Далее попробуем нарисовать страницу настроек в панели администрирования. Для этого добавим в /admin/class-ssk_read-admin.php в функцию конструкта класса хук добавления пункта меню:
|
1 2 |
add_action( 'admin_menu', 'register_my_config_page'); |
И далее в основном теле плагина skk_read.php добавим функцию register_my_config_page, которая непосредственно регистрирует этот пункт меню к выводу на экран:
|
1 2 3 4 5 6 7 8 |
function register_my_config_page(){ add_menu_page( 'SSK_Read', 'SSK_Read', 'edit_others_posts','ssk_read', 'DrawPage', plugins_url( 'ssk_read/images/logo.png' ), 6 ); } function DrawPage(){ ?> <h1 class="wp-heading-inline">Основные настройки</h1> <?php }; |
После этого в меню админки появится новый пункт меню, с выводом пустой страницы. Добавим в функцию DrawPage функционал вывода сохраненных настроек:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
function DrawPage(){ ?> <h1 class="wp-heading-inline">Основные настройки</h1> <form method="post" action="options.php"> <?php settings_fields('ssk_read_settings'); do_settings_sections( 'ssk_read'); submit_button(); ?> </form> <?php }; |
На этом этапе пока появится только кнопка «сохранить изменения», потому как мы еще не указали ядру, какие именно настройки мы хотим хранить. Для этого добавим в /admin/class-ssk_read-admin.php в функцию конструкта класса хук инициализации настроек:
|
1 |
add_action( 'admin_init', 'ssk_read_fields'); |
И далее в основном классе ssk_read.php добавим функции регистрации полей и их вывода:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
function ssk_read_fields(){ register_setting('ssk_read_settings','api_doc_url','string'); register_setting('ssk_read_settings','api_doc_login','string'); register_setting('ssk_read_settings','api_doc_password','string'); add_settings_section( 'ssk_settings_section_id', 'Соединение с 1С Документооборот','', 'ssk_read' ); add_settings_field('api_doc_url','URL вызова API','DrawApiTxtField','ssk_read','ssk_settings_section_id',array('name' => 'api_doc_url')); add_settings_field('api_doc_login','Логин','DrawApiTxtField','ssk_read','ssk_settings_section_id',array('name' => 'api_doc_login')); add_settings_field('api_doc_password','Пароль','DrawApiPasswordField','ssk_read','ssk_settings_section_id',array('name' => 'api_doc_password')); } function DrawApiTxtField($args){ $value = get_option( $args[ 'name' ] ); echo '<input type="text" id="'.$args[ 'name' ].'" name="'.$args[ 'name' ].'" value="'.$value.'" />'; } function DrawApiPasswordField($args){ $value = get_option( $args[ 'name' ] ); echo '<input type="password" id="'.$args[ 'name' ].'" name="'.$args[ 'name' ].'" value="'.$value.'" />'; } |
Получилось функционирующее сохранение:
Однако не хватает уведомления об успешном сохранении. Добавим хук:
|
1 |
add_action( 'admin_notices', 'ssk_custom_notice' ); |
И вывод сообщения:
|
1 2 3 4 5 6 7 8 9 10 11 |
function ssk_custom_notice(){ if ( isset( $_GET[ 'page' ] ) && 'ssk_read' == $_GET[ 'page' ] && isset( $_GET[ 'settings-updated' ] ) && true == $_GET[ 'settings-updated' ] ) { echo '<div class="notice notice-success is-dismissible"><p>Настройки сохранены!</p></div>'; } } |