УРОК · WordPress: темы и плагины

Хуки, шаблоны и безопасная форма

Опубликовано Автор: Соловьёва Мария Андреевна

Тип 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.

  1. В 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: ожидается отсутствие синтаксических ошибок.
  2. Создайте страницу командой 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: гость видит сообщение о правах, а не форму.
  3. Откройте 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 во втором терминале покажет новую строку.
  4. Для отрицательной проверки отправьте без входа curl -i -X POST -d "action=lab_note_create&note_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 после долгой паузы? Обновите страницу формы и отправьте её заново; не копируйте старый токен.

Куда заглянуть дальше