Обработка POST-запросов WordPress Way

 http://www.example.com/wp-admin/admin-post.php?action=foobar&data=test 

Все вышеперечисленные четыре крючка все еще доступны для использования.

Обладая этими знаниями, мы можем легко подключиться к соответствующим действиям, чтобы обработать отправку контактной формы, фактически не связываясь с нашим шаблоном темы.

Доказательство концепции

Давайте возьмем контактную форму в качестве примера. Самый простой способ сделать это (не рекомендуется) — возможно, создать пользовательский шаблон страницы на основе базового page.php , жестко закодировать форму и выполнить обработку в этом файле. Примерно так это выглядит:

 <?php /* * Template Name: Contact Page */ get_header(); if ( ! empty( $_POST ) ) { // Sanitize the POST field // Generate email content // Send to appropriate email } ?> <div id="content"> <form action="" method="post"> <label for="fullname">Full Name</label> <input type="text" name="fullname" id="fullname" required> <label for="email">Email Address</label> <input type="email" name="email" id="email" required> <label for="message">Your Message</label> <textarea name="message" id="message"></textarea> <input type="submit" value="Send My Message"> </form> </div> <?php get_footer(); 

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

Чтобы полностью использовать управляемую событиями природу WordPress, а также обеспечить разделение admin-post.php , мы можем использовать предоставленный admin-post.php . Преобразование существующей формы, чтобы сделать ее совместимой с admin-post.php , также довольно просто.

Сначала мы изменим эту строку с:

 <form action="" method="post"> 

чтобы:

 <form action="<?php echo esc_url( admin_url('admin-post.php') ); ?>" method="post"> 

Чтобы создать правильный URL-адрес, указывающий на admin-post.php , мы используем встроенную функцию admin_url . Это обеспечит правильность нашего URL-адреса в отношении текущего сайта, который работает.

Нам также нужно добавить скрытый ввод action чтобы мы могли активировать более специфическую ловушку, связанную с отправкой контактной формы. Давайте использовать пример contact_form для значения action .

Мы добавляем эту строку где-то между <form> .

 <input type="hidden" name="action" value="contact_form"> 

Вот так выглядит шаблон страницы после модификации:

 <?php /* * Template Name: Contact Page */ get_header(); ?> <div id="content"> <form action="<?php echo esc_url( admin_url('admin-post.php') ); ?>" method="post"> <label for="fullname">Full Name</label> <input type="text" name="fullname" id="fullname" required> <label for="email">Email Address</label> <input type="email" name="email" id="email" required> <label for="message">Your Message</label> <textarea name="message" id="message"></textarea> <input type="hidden" name="action" value="contact_form"> <input type="submit" value="Send My Message"> </form> </div> <?php get_footer(); 

Обратите внимание, что мы удаляем функцию обработки POST поверх шаблона, так как позже мы собираемся подключиться к этому действию.

Фактическая обработка запроса POST

Для этой части у нас есть два варианта, и выбор любого из них — это нормально. Мы можем либо подключиться к admin_post_* через functions.php нашей темы, либо мы можем создать простой плагин для обработки контактной формы. Давайте просто закодируем это в functions.php для простоты.

Помните, что у нас есть настраиваемое действие contact_form в форме, поэтому по праву нам будут доступны следующие четыре хука:

• admin_post_nopriv
• admin_post_nopriv_contact_form
• admin_post
• admin_post_contact_form

Откройте файл functions.php вашей текущей темы и добавьте эти строки в:

 function prefix_send_email_to_admin() { /** * At this point, $_GET/$_POST variable are available * * We can do our normal processing here */ // Sanitize the POST field // Generate email content // Send to appropriate email } add_action( 'admin_post_nopriv_contact_form', 'prefix_send_email_to_admin` ); add_action( 'admin_post_contact_form', 'prefix_send_email_to_admin` ); 

Поскольку мы хотим обрабатывать отправку формы одинаково, независимо от того, вошел ли пользователь в данный момент в системе или нет, мы указываем на одну и ту же функцию обратного вызова для admin_post_nopriv_contact_form и admin_post_contact_form . Фактическая функция обратного вызова prefix_send_email_to_admin будет вашим основным пунктом для обработки данных.

Вывод

admin-post.php — полезный скрытый драгоценный камень, содержащийся в ядре WordPress. Используя его, мы можем сохранить разделение проблем между фактическим шаблоном и несвязанным кодом, который не нужен для отображения, разделенным путем подключения к соответствующим обработчикам.

Получите нужные права доступа к файлам на вашем сайте WordPress с помощью нашего учебника.