* This file contains the functions needed for the inline editing of posts.
* @output wp-admin/js/inline-edit-post.js
/* global ajaxurl, typenow, inlineEditPost */
window.wp = window.wp || {};
* Manages the quick edit and bulk edit windows for editing posts or pages.
* @namespace inlineEditPost
* @property {string} type The type of inline editor.
* @property {string} what The prefix before the post ID.
window.inlineEditPost = {
* Initializes the inline and bulk post editor.
* Binds event handlers to the Escape key to close the inline editor
* and to the save and close buttons. Changes DOM to be ready for inline
* editing. Adds event handler to bulk edit.
* @memberof inlineEditPost
var t = this, qeRow = $('#inline-edit'), bulkRow = $('#bulk-edit');
t.type = $('table.widefat').hasClass('pages') ? 'page' : 'post';
* Binds the Escape key to revert the changes and close the quick editor.
* @return {boolean} The result of revert.
qeRow.on( 'keyup', function(e){
// Revert changes if Escape key is pressed.
return inlineEditPost.revert();
* Binds the Escape key to revert the changes and close the bulk editor.
* @return {boolean} The result of revert.
bulkRow.on( 'keyup', function(e){
// Revert changes if Escape key is pressed.
return inlineEditPost.revert();
* Reverts changes and close the quick editor if the cancel button is clicked.
* @return {boolean} The result of revert.
$( '.cancel', qeRow ).on( 'click', function() {
return inlineEditPost.revert();
* Saves changes in the quick editor if the save(named: update) button is clicked.
* @return {boolean} The result of save.
$( '.save', qeRow ).on( 'click', function() {
return inlineEditPost.save(this);
* If Enter is pressed, and the target is not the cancel button, save the post.
* @return {boolean} The result of save.
$('td', qeRow).on( 'keydown', function(e){
if ( e.which === 13 && ! $( e.target ).hasClass( 'cancel' ) ) {
return inlineEditPost.save(this);
* Reverts changes and close the bulk editor if the cancel button is clicked.
* @return {boolean} The result of revert.
$( '.cancel', bulkRow ).on( 'click', function() {
return inlineEditPost.revert();
* Disables the password input field when the private post checkbox is checked.
$('#inline-edit .inline-edit-private input[value="private"]').on( 'click', function(){
var pw = $('input.inline-edit-password-input');
if ( $(this).prop('checked') ) {
pw.val('').prop('disabled', true);
pw.prop('disabled', false);
* Binds click event to the .editinline button which opens the quick editor.
$( '#the-list' ).on( 'click', '.editinline', function() {
$( this ).attr( 'aria-expanded', 'true' );
inlineEditPost.edit( this );
// Clone quick edit categories for the bulk editor.
var beCategories = $( '#inline-edit fieldset.inline-edit-categories' ).clone();
// Make "id" attributes globally unique.
beCategories.find( '*[id]' ).each( function() {
this.id = 'bulk-edit-' + this.id;
$('#bulk-edit').find('fieldset:first').after(
).siblings( 'fieldset:last' ).prepend(
$( '#inline-edit .inline-edit-tags-wrap' ).clone()
$('select[name="_status"] option[value="future"]', bulkRow).remove();
* Adds onclick events to the apply buttons.
$('#doaction').on( 'click', function(e){
$itemsSelected = $( '#posts-filter .check-column input[type="checkbox"]:checked' );
if ( $itemsSelected.length < 1 ) {
t.whichBulkButtonId = $( this ).attr( 'id' );
n = t.whichBulkButtonId.substr( 2 );
if ( 'edit' === $( 'select[name="' + n + '"]' ).val() ) {
} else if ( $('form#posts-filter tr.inline-editor').length > 0 ) {
* Toggles the quick edit window, hiding it when it's active and showing it when
* @memberof inlineEditPost
* @param {Object} el Element within a post table row.
$( t.what + t.getId( el ) ).css( 'display' ) === 'none' ? t.revert() : t.edit( el );
* Creates the bulk editor row to edit multiple posts at once.
* @memberof inlineEditPost
var te = '', type = this.type, c = true;
var checkedPosts = $( 'tbody th.check-column input[type="checkbox"]:checked' );
$( '#bulk-edit td' ).attr( 'colspan', $( 'th:visible, td:visible', '.widefat:first thead' ).length );
// Insert the editor at the top of the table with an empty row above to maintain zebra striping.
$('table.widefat tbody').prepend( $('#bulk-edit') ).prepend('<tr class="hidden"></tr>');
$('#bulk-edit').addClass('inline-editor').show();
* Create a HTML div with the title and a link(delete-icon) for each selected
* Get the selected posts based on the checked checkboxes in the post table.
$( 'tbody th.check-column input[type="checkbox"]' ).each( function() {
// If the checkbox for a post is selected, add the post to the edit list.
if ( $(this).prop('checked') ) {
var id = $( this ).val(),
theTitle = $( '#inline_' + id + ' .post_title' ).html() || wp.i18n.__( '(no title)' ),
buttonVisuallyHiddenText = wp.i18n.sprintf(
/* translators: %s: Post title. */
wp.i18n.__( 'Remove “%s” from Bulk Edit' ),
te += '<li class="ntdelitem"><button type="button" id="_' + id + '" class="button-link ntdelbutton"><span class="screen-reader-text">' + buttonVisuallyHiddenText + '</span></button><span class="ntdeltitle" aria-hidden="true">' + theTitle + '</span></li>';
// If no checkboxes where checked, just hide the quick/bulk edit rows.
// Populate the list of items to bulk edit.
$( '#bulk-titles' ).html( '<ul id="bulk-titles-list" role="list">' + te + '</ul>' );
// Gather up some statistics on which of these checked posts are in which categories.
checkedPosts.each( function() {
var id = $( this ).val();
var checked = $( '#category_' + id ).text().split( ',' );
checked.map( function( cid ) {
categories[ cid ] || ( categories[ cid ] = 0 );
// Just record that this category is checked.
// Compute initial states.
$( '.inline-edit-categories input[name="post_category[]"]' ).each( function() {
if ( categories[ $( this ).val() ] == checkedPosts.length ) {
// If the number of checked categories matches the number of selected posts, then all posts are in this category.
$( this ).prop( 'checked', true );
} else if ( categories[ $( this ).val() ] > 0 ) {
// If the number is less than the number of selected posts, then it's indeterminate.
$( this ).prop( 'indeterminate', true );
if ( ! $( this ).parent().find( 'input[name="indeterminate_post_category[]"]' ).length ) {
// Get the term label text.
var label = $( this ).parent().text();
// Set indeterminate states for the backend. Add accessible text for indeterminate inputs.
$( this ).after( '<input type="hidden" name="indeterminate_post_category[]" value="' + $( this ).val() + '">' ).attr( 'aria-label', label.trim() + ': ' + wp.i18n.__( 'Some selected posts have this category' ) );
$( '.inline-edit-categories input[name="post_category[]"]:indeterminate' ).on( 'change', function() {
// Remove accessible label text. Remove the indeterminate flags as there was a specific state change.
$( this ).removeAttr( 'aria-label' ).parent().find( 'input[name="indeterminate_post_category[]"]' ).remove();
$( '.inline-edit-save button' ).on( 'click', function() {
$( '.inline-edit-categories input[name="post_category[]"]' ).prop( 'indeterminate', false );
* Binds on click events to handle the list of items to bulk edit.
$( '#bulk-titles .ntdelbutton' ).click( function() {
id = $this.attr( 'id' ).substr( 1 ),
$prev = $this.parent().prev().children( '.ntdelbutton' ),
$next = $this.parent().next().children( '.ntdelbutton' );
$( 'input#cb-select-all-1, input#cb-select-all-2' ).prop( 'checked', false );
$( 'table.widefat input[value="' + id + '"]' ).prop( 'checked', false );
$( '#_' + id ).parent().remove();
wp.a11y.speak( wp.i18n.__( 'Item removed.' ), 'assertive' );
// Move focus to a proper place when items are removed.
} else if ( $prev.length ) {
$( '#bulk-titles-list' ).remove();
wp.a11y.speak( wp.i18n.__( 'All selected items have been removed. Select new items to use Bulk Actions.' ) );
// Enable auto-complete for tags when editing posts.
$( 'tr.inline-editor textarea[data-wp-taxonomy]' ).each( function ( i, element ) {
* While Quick Edit clones the form each time, Bulk Edit always re-uses
* the same form. Let's check if an autocomplete instance already exists.
if ( $( element ).autocomplete( 'instance' ) ) {
// jQuery equivalent of `continue` within an `each()` loop.
$( element ).wpTagsSuggest();
// Set initial focus on the Bulk Edit region.
$( '#bulk-edit .inline-edit-wrapper' ).attr( 'tabindex', '-1' ).focus();
// Scrolls to the top of the table where the editor is rendered.
$('html, body').animate( { scrollTop: 0 }, 'fast' );
* Creates a quick edit window for the post that has been clicked.
* @memberof inlineEditPost
* @param {number|Object} id The ID of the clicked post or an element within a post
* @return {boolean} Always returns false at the end of execution.
var t = this, fields, editRow, rowData, status, pageOpt, pageLevel, nextPage, pageLoop = true, nextLevel, f, val, pw;
if ( typeof(id) === 'object' ) {
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');
// Add the new edit row with an extra blank row underneath to maintain zebra striping.
editRow = $('#inline-edit').clone(true);
$( 'td', editRow ).attr( 'colspan', $( 'th:visible, td:visible', '.widefat:first thead' ).length );
// Remove the ID from the copied row and let the `for` attribute reference the hidden ID.
$( 'td', editRow ).find('#quick-edit-legend').removeAttr('id');
$( 'td', editRow ).find('p[id^="quick-edit-"]').removeAttr('id');
$(t.what+id).removeClass('is-expanded').hide().after(editRow).after('<tr class="hidden"></tr>');
// Populate fields in the quick edit window.
rowData = $('#inline_'+id);
if ( !$(':input[name="post_author"] option[value="' + $('.post_author', rowData).text() + '"]', editRow).val() ) {
// The post author no longer has edit capabilities, so we need to add them to the list of authors.
$(':input[name="post_author"]', editRow).prepend('<option value="' + $('.post_author', rowData).text() + '">' + $('#post-' + id + ' .author').text() + '</option>');
if ( $( ':input[name="post_author"] option', editRow ).length === 1 ) {
$('label.inline-edit-author', editRow).hide();
for ( f = 0; f < fields.length; f++ ) {
val = $('.'+fields[f], rowData);
* Replaces the image for a Twemoji(Twitter emoji) with it's alternate text.
* @return {string} Alternate text from the image.
val.find( 'img' ).replaceWith( function() { return this.alt; } );
$(':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 );
* Creates the select boxes for the categories.
$('.post_category', rowData).each(function(){
term_ids = $(this).text();
taxname = $(this).attr('id').replace('_'+id, '');
$('ul.'+taxname+'-checklist :checkbox', editRow).val(term_ids.split(','));
* Gets all the taxonomies for live auto-fill suggestions when typing the name
$('.tags_input', rowData).each(function(){
taxname = $(this).attr('id').replace('_' + id, ''),
textarea = $('textarea.tax_input_' + taxname, editRow),
comma = wp.i18n._x( ',', 'tag delimiter' ).trim();
// Ensure the textarea exists.
if ( ! textarea.length ) {
terms.find( 'img' ).replaceWith( function() { return this.alt; } );
terms = terms.replace(/,/g, comma);
textarea.wpTagsSuggest();
// Handle the post status.
var post_date_string = $(':input[name="aa"]').val() + '-' + $(':input[name="mm"]').val() + '-' + $(':input[name="jj"]').val();
post_date_string += ' ' + $(':input[name="hh"]').val() + ':' + $(':input[name="mn"]').val() + ':' + $(':input[name="ss"]').val();
var post_date = new Date( post_date_string );
status = $('._status', rowData).text();
if ( 'future' !== status && Date.now() > post_date ) {
$('select[name="_status"] option[value="future"]', editRow).remove();
$('select[name="_status"] option[value="publish"]', 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 );
// Remove the current page and children from the parent dropdown.
pageOpt = $('select[name="post_parent"] option[value="' + id + '"]', editRow);
if ( pageOpt.length > 0 ) {
pageLevel = pageOpt[0].className.split('-')[1];
nextPage = nextPage.next('option');
if ( nextPage.length === 0 ) {
nextLevel = nextPage[0].className.split('-')[1];
if ( nextLevel <= pageLevel ) {
$(editRow).attr('id', 'edit-'+id).addClass('inline-editor').show();
$('.ptitle', editRow).trigger( 'focus' );
* Saves the changes made in the quick edit window to the post.
* Ajax saving is only for Quick Edit and not for bulk edit.
* @param {number} id The ID for the post that has been changed.
* @return {boolean} False, so the form does not submit when pressing
* Enter on a focused field.
var params, fields, page = $('.post_status_page').val() || '';
if ( typeof(id) === 'object' ) {
$( 'table.widefat .spinner' ).addClass( 'is-active' );