Как добавить произвольное поле в быстрое редактирование

Вот несколько шагов для создания пользовательского блока быстрого редактирования и пользовательской колонки:

1. Создать пользовательский мета-ключ (предполагается, что у вас уже есть один)
2. Добавить заголовок и данные пользовательской колонки в админке (предполагается, что вы хотите отображать пользовательский мета-ключ в колонке, если нет, вы можете немного изменить логику для достижения того же эффекта, так как принцип остается тем же)
3. Добавить блок быстрого редактирования
4. Добавить логику сохранения
5. Загрузить скрипт для модификации оригинальной функции inline-edit-post, чтобы поддерживать пользовательские мета-значения
6. Подготовить файл скрипта

В этом примере мы добавим поле быстрого редактирования для типа записи Страница. Следующий код проверен на работоспособность при размещении в functions.php.

1. Создать пользовательский мета-ключ (предполагается, что у вас уже есть один)

Я подготовил пользовательский мета-ключ remark для типа записи page

2. Добавить заголовок и данные пользовательской колонки в админке

Для пользовательских типов записей можно использовать:

Добавить заголовок колонки

• Для конкретного Screen ID manage_{$screen->id}_columns
• Конкретно для Страниц manage_pages_columns
• Для общих случаев (обычные записи или пользовательские типы записей) manage_posts_custom_column или для конкретного типа записи manage_{$post->post_type}_posts_custom_column для добавления данных в колонку

Добавить содержимое колонки

• Общий случай (обычные записи или пользовательские типы записей) manage_posts_columns с проверкой типа записи через аргумент post_type или для конкретного типа записи manage_{$post_type}_posts_columns для добавления заголовка колонки

Ниже приведен пример для типа записи Страница, а также пользовательского типа записи + стандартного Поста в качестве примера настройки для нескольких типов записей.

// добавить заголовок пользовательской колонки для пользовательского мета-значения
add_filter('manage_edit-page_columns', 'ws365150_add_custom_columns_title' );
function ws365150_add_custom_columns_title( $columns ) {
    $columns['page_remark'] = 'Примечание'; // позже можно использовать __() для поддержки перевода
    
    return $columns;
}
    
// добавить данные в пользовательскую колонку с пользовательским мета-значением
add_action('manage_pages_custom_column', 'ws365150_add_custom_column_data', 10, 2 );
function ws365150_add_custom_column_data( $column_name, $post_id ) {
    switch ( $column_name ) {
        case 'page_remark':
            echo get_post_meta( $post_id, 'remark', true );
            break;
        
        default:
            break;
    }
}

Ниже приведен пример для пользовательского типа записи episode + стандартного Поста с мета-ключом summary

// добавить заголовок пользовательской колонки для пользовательского мета-значения
// 'manage_pages_columns' или 'manage_edit-post_columns' - оба варианта работают
add_filter('manage_posts_columns', 'ws365150_add_custom_columns_title_pt', 10, 2 );
function ws365150_add_custom_columns_title_pt( $columns, $post_type ) {
    switch ( $post_type ) {
        case 'post':
        case 'episode':
            $columns['ws365150_summary'] = 'Краткое описание'; // позже можно использовать __() для поддержки перевода
            break;
        
        default:
            
            break;
    }
    
    return $columns;
}
    
// добавить данные в пользовательскую колонку с пользовательским мета-значением для пользовательских типов записей
add_action('manage_posts_custom_column', 'ws365150_add_custom_column_data_pt', 10, 2 );
function ws365150_add_custom_column_data_pt( $column_name, $post_id ) {
    switch ( $column_name ) {
        case 'ws365150_summary': // указано для этой колонки, назначенной в заголовке
            echo get_post_meta( $post_id, 'summary', true );
            break;
        
        default:
            break;
    }
}

3. Добавить блок быстрого редактирования

// для страниц
add_action( 'quick_edit_custom_box', 'ws365150_custom_edit_box', 10, 3 );
function ws365150_custom_edit_box( $column_name, $post_type, $taxonomy ) {
    global $post;

    switch ( $post_type ) {
        case 'page':

        if( $column_name === 'page_remark' ): // тот же заголовок колонки, что и в предыдущем шаге
        ?>
                <?php // echo get_post_meta( $post->ID, 'remark', true ); ?>
            <fieldset class="inline-edit-col-right" id="#edit-">
                <div class="inline-edit-col">
                    <label>
                        <span class="title">Примечание</span>
                        <span class="input-text-wrap"><input type="text" name="remark" class="inline-edit-menu-order-input" value=""></span>
                    </label>
                </div>
            </fieldset>
            <?php
        endif;
            // echo 'custom page field';
            break;
        
        default:
            break;
    }
}

// для Постов + пользовательских типов записей
add_action( 'quick_edit_custom_box', 'ws365150_custom_edit_box_pt', 10, 3 );
function ws365150_custom_edit_box_pt( $column_name, $post_type, $taxonomy ) {
    global $post;

    switch ( $post_type ) {
        case 'post':
        case 'episode':

        if( $column_name === 'ws365150_summary' ): // тот же заголовок колонки, что и в предыдущем шаге
        ?>
                <?php // echo get_post_meta( $post->ID, 'remark', true ); ?>
            <fieldset class="inline-edit-col-right" id="#edit-">
                <div class="inline-edit-col">
                    <label>
                        <span class="title">Краткое описание</span>
                        <span class="input-text-wrap"><input type="text" name="summary" class="inline-edit-menu-order-input" value=""></span>
                    </label>
                </div>
            </fieldset>
            <?php
        endif;
            // echo 'custom page field';
            break;
        
        default:
            break;
    }
}

4. Добавить логику сохранения

add_action( 'save_post', 'ws365150_update_custom_quickedit_box' );
function ws365150_update_custom_quickedit_box() {
    // здесь может быть любая логика проверки, опущена для простоты иллюстрации (nonce, наличие $_POST['remark'], сохранение через ajax и т.д.)
    
    // примечание для Страницы
    if( isset( $_POST ) && isset( $_POST['remark'] ) ) { // где remark определен в <input name="remark">
        update_post_meta($_POST['post_ID'], 'remark', $_POST['remark']);
    }

    // краткое описание для Поста, пользовательского типа записи
    if( isset( $_POST ) && isset( $_POST['summary'] ) ) { // где summary определен в <input name="summary">
        update_post_meta($_POST['post_ID'], 'summary', $_POST['summary']);
    }
    
    // для отладки в инспекторе, не обязательно, включение этого прервет сохранение, но можно увидеть ответ ajax
    // wp_send_json_success( array(
    //  'message' => 'Save test!',
    //  'post_data' => $_POST,
    // ) );
    return; // завершить вызов функции
}

5. Загрузить скрипт для модификации оригинальной функции inline-edit-post

add_action( 'admin_enqueue_scripts', function( $page ) {

    // добавить логику проверки страницы, это простой пример, можно проверять тип записи и т.д...
    if ( 'edit.php' != $page ) {
        return;
    }
    
    wp_enqueue_script( 'custom-quickedit-box', get_stylesheet_directory_uri() . '/ws365150_custom_quickedit_box.js', array( 'jquery', 'inline-edit-post' ) );
});

6. Подготовить файл скрипта (ws365150_custom_quickedit_box.js, при тестировании вышеуказанного кода разместите в папке темы)

( function( $, wp ) {
    // копия оригинальной функции из inline-post-edit.js для переопределения
    // на самом деле не обязательно создавать псевдоним объекта, однако его создание может служить заметкой и маркером переопределения для последующего обслуживания
    window.customInlineEditPost = window.inlineEditPost;

    // переопределение функции: добавление пользовательского мета-значения, основа взята из исходного кода
    customInlineEditPost.edit = function(id) {
            // console.log( 'custom edit' );
            var t = this, fields, editRow, rowData, status, pageOpt, pageLevel, nextPage, pageLoop = true, nextLevel, f, val, pw;
            t.revert();

            if ( typeof(id) === 'object' ) {
                id = t.getId(id);
            }

            fields = ['post_title', 'post_name', 'post_author', '_status', 'jj', 'mm', 'aa', 'hh', 'mn', 'ss', 'post_password', 'post_format', 'menu_order', 'page_template'];
            if ( t.type === 'page' ) {
                fields.push('post_parent');
            }

            // Добавляем новую строку редактирования с дополнительной пустой строкой под ней для сохранения зебровой раскраски.
            editRow = $('#inline-edit').clone(true);
            $( 'td', editRow ).attr( 'colspan', $( 'th:visible, td:visible', '.widefat:first thead' ).length );

            $(t.what+id).removeClass('is-expanded').hide().after(editRow).after('<tr class="hidden"></tr>');

            // Заполняем поля в окне быстрого редактирования.
            rowData = $('#inline_'+id);
            if ( !$(':input[name="post_author"] option[value="' + $('.post_author', rowData).text() + '"]', editRow).val() ) {

                // Автор записи больше не имеет прав на редактирование, поэтому нужно добавить его в список авторов.
                $(':input[name="post_author"]', editRow).prepend('<option value="' + $('.post_author', rowData).text() + '">' + $('#' + t.type + '-' + id + ' .author').text() + '</option>');
            }
            if ( $( ':input[name="post_author"] option', editRow ).length === 1 ) {
                $('label.inline-edit-author', editRow).hide();
            }

            // заполняем пользовательское мета-значение
            if ( $( ':input[name="remark"]', editRow ).length === 1 ) {
                $( ':input[name="remark"]', editRow ).val( $('#post-' + id + ' .page_remark').text() );
            }

            if ( $( ':input[name="summary"]', editRow ).length === 1 ) {
                $( ':input[name="summary"]', editRow ).val( $('#post-' + id + ' .ws365150_summary').text() );
            }

            for ( f = 0; f < fields.length; f++ ) {
                val = $('.'+fields[f], rowData);

                /**
                 * Заменяет изображение для Twemoji (Twitter emoji) на его альтернативный текст.
                 *
                 * @returns Альтернативный текст из изображения.
                 */
                val.find( 'img' ).replaceWith( function() { return this.alt; } );
                val = val.text();
                $(':input[name="' + fields[f] + '"]', editRow).val( val );
            }

            if ( $( '.comment_status', rowData ).text() === 'open' ) {
                $( 'input[name="comment_status"]', editRow ).prop( 'checked', true );
            }
            if ( $( '.ping_status', rowData ).text() === 'open' ) {
                $( 'input[name="ping_status"]', editRow ).prop( 'checked', true );
            }
            if ( $( '.sticky', rowData ).text() === 'sticky' ) {
                $( 'input[name="sticky"]', editRow ).prop( 'checked', true );
            }

            /**
             * Создает выпадающие списки для категорий.
             */
            $('.post_category', rowData).each(function(){
                var taxname,
                    term_ids = $(this).text();

                if ( term_ids ) {
                    taxname = $(this).attr('id').replace('_'+id, '');
                    $('ul.'+taxname+'-checklist :checkbox', editRow).val(term_ids.split(','));
                }
            });

            /**
             * Получает все таксономии для live auto-fill подсказок при вводе имени тега.
             */
            $('.tags_input', rowData).each(function(){
                var terms = $(this),
                    taxname = $(this).attr('id').replace('_' + id, ''),
                    textarea = $('textarea.tax_input_' + taxname, editRow),
                    comma = inlineEditL10n.comma;

                terms.find( 'img' ).replaceWith( function() { return this.alt; } );
                terms = terms.text();

                if ( terms ) {
                    if ( ',' !== comma ) {
                        terms = terms.replace(/,/g, comma);
                    }
                    textarea.val(terms);
                }

                textarea.wpTagsSuggest();
            });

            // Обрабатываем статус записи.
            status = $('._status', rowData).text();
            if ( 'future' !== status ) {
                $('select[name="_status"] option[value="future"]', editRow).remove();
            }

            pw = $( '.inline-edit-password-input' ).prop( 'disabled', false );
            if ( 'private' === status ) {
                $('input[name="keep_private"]', editRow).prop('checked', true);
                pw.val( '' ).prop( 'disabled', true );
            }

            // Удаляем текущую страницу и дочерние элементы из выпадающего списка родителя.
            pageOpt = $('select[name="post_parent"] option[value="' + id + '"]', editRow);
            if ( pageOpt.length > 0 ) {
                pageLevel = pageOpt[0].className.split('-')[1];
                nextPage = pageOpt;
                while ( pageLoop ) {
                    nextPage = nextPage.next('option');
                    if ( nextPage.length === 0 ) {
                        break;
                    }

                    nextLevel = nextPage[0].className.split('-')[1];

                    if ( nextLevel <= pageLevel ) {
                        pageLoop = false;
                    } else {
                        nextPage.remove();
                        nextPage = pageOpt;
                    }
                }
                pageOpt.remove();
            }

            $(editRow).attr('id', 'edit-'+id).addClass('inline-editor').show();
            $('.ptitle', editRow).focus();

            return false;
    };
})( jQuery, window.wp );

Вышеприведенный пример предназначен для быстрого редактирования с использованием хука quick_edit_custom_box, и вам также может потребоваться учесть массовое редактирование. Вы можете изучить больше, используя хук bulk_edit_custom_box.