Как добавить уведомление администратора при сохранении/обновлении записи

Создал класс-обертку для такого сценария. На самом деле, этот класс можно использовать в любом случае, связанном с отображением уведомлений. Я использую стандарты PSR, поэтому именование нетипично для кода WordPress.

class AdminNotice
{
    const NOTICE_FIELD = 'my_admin_notice_message';

    public function displayAdminNotice()
    {
        $option      = get_option(self::NOTICE_FIELD);
        $message     = isset($option['message']) ? $option['message'] : false;
        $noticeLevel = ! empty($option['notice-level']) ? $option['notice-level'] : 'notice-error';

        if ($message) {
            echo "<div class='notice {$noticeLevel} is-dismissible'><p>{$message}</p></div>";
            delete_option(self::NOTICE_FIELD);
        }
    }

    public static function displayError($message)
    {
        self::updateOption($message, 'notice-error');
    }

    public static function displayWarning($message)
    {
        self::updateOption($message, 'notice-warning');
    }

    public static function displayInfo($message)
    {
        self::updateOption($message, 'notice-info');
    }

    public static function displaySuccess($message)
    {
        self::updateOption($message, 'notice-success');
    }

    protected static function updateOption($message, $noticeLevel) {
        update_option(self::NOTICE_FIELD, [
            'message' => $message,
            'notice-level' => $noticeLevel
        ]);
    }
}

Использование:

add_action('admin_notices', [new AdminNotice(), 'displayAdminNotice']);
AdminNotice::displayError(__('Произошла ошибка, проверьте логи.'));

Уведомление отображается один раз.

В дополнение к ответу @jonathanbardo, который отлично работает, если вы хотите удалить аргумент запроса после загрузки новой страницы, вы можете использовать фильтр removable_query_args. Вы получаете массив имен аргументов, к которому можете добавить свой собственный аргумент. Затем WordPress позаботится об удалении всех аргументов из списка из URL.

public function __construct() {
    ...
    add_filter('removable_query_args', array($this, 'add_removable_arg'));
}

public function add_removable_arg($args) {
    array_push($args, 'my-query-arg');
    return $args;
}

Например:

'...post.php?post=1&my-query-arg=10'

Превратится в:

'...post.php?post=1'

Простое и элегантное решение на основе get_settings_errors().

function wpse152033_set_admin_notice($id, $message, $status = 'success') {
    set_transient('wpse152033' . '_' . $id, [
        'message' => $message,
        'status' => $status
    ], 30);
}

function wpse152033_get_admin_notice($id) {
    $transient = get_transient( 'wpse152033' . '_' . $id );
    if ( isset( $_GET['settings-updated'] ) && $_GET['settings-updated'] && $transient ) {
        delete_transient( 'wpse152033' . '_' . $id );
    }
    return $transient;
}

Использование

В обработчике POST-запроса:

wpse152033_set_admin_notice(get_current_user_id(), 'Привет, мир', 'error');
wp_redirect(add_query_arg('settings-updated', 'true',  wp_get_referer()));

Где вы хотите использовать уведомление администратора, обычно в хуке admin_notices.

$notice = $this->get_admin_notice(get_current_user_id());
if (!empty($notice) && is_array($notice)) {
    $status = array_key_exists('status', $notice) ? $notice['status'] : 'success';
    $message = array_key_exists('message', $notice) ? $notice['message'] : '';
    print '<div class="notice notice-'.$status.' is-dismissible">'.$message.'</div>';
}

Вы можете добиться этого, выполнив переадресацию и передав аргументы запроса с помощью фильтра redirect_post_location. Также есть redirect_term_location, который работает для таксономий/терминов.

Сначала добавьте действие admin_notices, которое всегда будет активным, но будет показывать уведомление только при определенных условиях.

add_action( 'admin_notices', 'general_admin_notice' );

function general_admin_notice(){
  global $pagenow;

  if ( 'post.php' === $pagenow && isset($_GET['post']) && 'custom_post_type' === get_post_type( $_GET['post'] ) ){

    if ( isset($_GET['empty'])) {
      
      // Преобразуем строку в массив, чтобы можно было перебирать элементы
      $terms_id = explode( ',', $_GET['empty'] );

      echo '<div class="notice notice-error is-dismissible">
                <p>';
                foreach ( $terms_id as $term_id ) {
                  $term = get_term( $term_id, 'custom_taxonomy' );
                  echo '<a href="'.get_term_link( $term ).'">'.$term->name.'</a>, ';
                }
              echo 'не заполнены данные по питательным веществам.</p>
            </div>';
      }
    }
}

Затем вам нужно выполнить переадресацию страницы после сохранения и передать аргумент запроса с помощью add_query_arg. В моем примере реализован динамический ввод, который отображается в административном уведомлении.

        if ( !empty($empty_error) ) {
            add_filter('redirect_post_location', function($loc) use ($empty_error) {
                trigger_error( $empty_error);
                return add_query_arg( 'empty', implode(',', $empty_error), $loc );
            }); 
        }

В моем случае я использую array_push для переменной $empty_error с ID термина. Административное уведомление затем покажет все термины, в которых возникла ошибка, со ссылкой на соответствующий термин.

Вы также можете использовать removable_query_args для удаления добавленных аргументов запроса, чтобы URL выглядел чище. Административное уведомление исчезнет при перезагрузке страницы.

add_filter('removable_query_args', 'add_removable_arg');

function add_removable_arg($args) {
    array_push($args, 'empty');
    return $args;
}