Хуки, шаблоны и безопасная форма
Тип lab_note уже существует. Теперь добавим на отдельную страницу форму, которая сохраняет заметку только после проверки прав и одноразового токена WordPress.
Разберём по шагам
Хук admin_post_lab_note_create вызывает обработчик после отправки формы на wp-admin/admin-post.php. Шорткод [lab_note_form] вставляет форму на страницу. nonce подтверждает происхождение запроса, но сам по себе не даёт право менять данные: отдельно нужен current_user_can. Здесь сразу публикуем новые заметки, поэтому проверяем право publish_posts; редактирование существующей записи по ID в этом примере не реализовано.
Слова, которые пригодятся
- Хук
- Точка WordPress, к которой плагин подключает функцию.
admin_post_lab_note_createзапускается при отправке формы с такимaction. - Шорткод
- Короткая запись в содержимом страницы, которую плагин заменяет своим HTML. Здесь
[lab_note_form]выводит форму. - Nonce
- Токен WordPress, который помогает отличить ожидаемую отправку формы от подделанного запроса; он не заменяет проверку прав.
- Capability
- Отдельное право пользователя на действие.
publish_postsтребуется нашему обработчику, потому что он создаёт сразу опубликованную заметку.
wp_unslash убирает служебные обратные косые черты из входа WordPress, sanitize_text_field очищает название перед сохранением, а esc_url защищает адрес в HTML-форме. Поле required помогает в браузере, но сервер всё равно проверяет пустое название.
Для гостей хук admin_post_nopriv_lab_note_create не зарегистрирован: прямой POST не создаёт запись. Роль Contributor умеет редактировать свои черновики, но не имеет publish_posts, поэтому форма и серверный обработчик отказывают ей в немедленной публикации.
Рабочий пример
// Добавьте ниже кода первого урока в fsl-lab-notes.php.
add_shortcode('lab_note_form', function () {
if (!current_user_can('publish_posts')) {
return '<p>Для добавления заметки нужны права автора.</p>';
}
return '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '">'
. '<input type="hidden" name="action" value="lab_note_create">'
. wp_nonce_field('lab_note_create', 'lab_note_nonce', true, false)
. '<label>Название <input name="note_title" required maxlength="200"></label>'
. '<button type="submit">Добавить заметку</button></form>';
});
add_action('admin_post_lab_note_create', function () {
if (!current_user_can('publish_posts')) {
wp_die('Нет права создавать заметки', '', ['response' => 403]);
}
check_admin_referer('lab_note_create', 'lab_note_nonce');
$title = sanitize_text_field(wp_unslash($_POST['note_title'] ?? ''));
if ($title === '') {
wp_die('Введите название', '', ['response' => 400]);
}
$id = wp_insert_post([
'post_type' => 'lab_note',
'post_status' => 'publish',
'post_title' => $title,
'post_author' => get_current_user_id(),
], true);
if (is_wp_error($id)) {
wp_die('Не удалось сохранить заметку', '', ['response' => 500]);
}
wp_safe_redirect(get_permalink($id));
exit;
});
Практика
Сохраните заметку через браузер и проверьте два отказа. Так станет видно, какую работу выполняет проверка прав, а какую — nonce.
- В Visual Studio Code откройте
wp-content/plugins/fsl-lab-notes/fsl-lab-notes.php, вставьте пример после закрытия});первого урока, без второго<?php, и сохраните. Выполните из~/notes-wp-labкомандуphp -l wp-content/plugins/fsl-lab-notes/fsl-lab-notes.php: ожидается отсутствие синтаксических ошибок. - Создайте страницу командой
php ../wp-cli-2.12.0.phar post create --post_type=page --post_status=publish --post_title="Добавить заметку" --post_content="[lab_note_form]" --porcelainи запомните ID. Запустите серверphp ../wp-cli-2.12.0.phar server --host=127.0.0.1 --port=8002; оставьте терминал открытым. В браузере откройтеhttp://127.0.0.1:8002/?page_id=ID: гость видит сообщение о правах, а не форму. - Откройте
http://127.0.0.1:8002/wp-login.php, войдите какlabadminс локальным паролем и вернитесь на страницу формы. ВведитеФорма и хук, нажмите «Добавить заметку». Браузер перейдёт на адрес новой заметки; командаphp ../wp-cli-2.12.0.phar post list --post_type=lab_note --fields=ID,post_title,post_statusво втором терминале покажет новую строку. - Для отрицательной проверки отправьте без входа
curl -i -X POST -d "action=lab_note_create¬e_title=Недопустимо" http://127.0.0.1:8002/wp-admin/admin-post.php: ждите отказ, затем проверьте списком, что «Недопустимо» не сохранено. В браузере под администратором откройте инструменты разработчикаF12, найдите в форме скрытое полеname="lab_note_nonce", временно измените егоvalueнаinvalidи отправьте форму: WordPress покажет ошибку токена, новой записи не будет. После обновления страницы браузер восстановит исходное значение.
Как проверить себя
Форма с действующими правами и nonce создаёт заметку; гость не получает форму, а запрос без корректного токена не добавляет строку.
Если не получилось
- Видите текст
[lab_note_form]вместо формы? Проверьте активацию плагина и точное написание шорткода на странице. - После входа всё ещё нет формы? Проверьте, что вы вошли как администратор учебной установки, а адрес страницы начинается с
127.0.0.1:8002. - Получили ошибку nonce после долгой паузы? Обновите страницу формы и отправьте её заново; не копируйте старый токен.
Куда заглянуть дальше
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗