sergiotarxz/Wordpress
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Editor: Improve post.js documentation.

Browse Source 
Props jipmoors, boblinthorst.
Fixes #38118.

git-svn-id: https://develop.svn.wordpress.org/trunk@38637 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov 2016-09-21 08:56:28 +00:00
parent 2515aab673
commit 9ee1f662cb
1 changed files with 421 additions and 195 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

346
src/wp-admin/js/post.js
View File

@ -1,18 +1,42 @@
/* global postL10n, ajaxurl, wpAjax, setPostThumbnailL10n, postboxes, pagenow, tinymce, alert, deleteUserSetting */ /* global postL10n, ajaxurl, wpAjax, setPostThumbnailL10n, postboxes, pagenow, tinymce, alert, deleteUserSetting */
/* global theList:true, theExtraList:true, getUserSetting, setUserSetting, commentReply */ /* global theList:true, theExtraList:true, getUserSetting, setUserSetting, commentReply */
/**
* Contains all dynamic functionality needed on post and term pages.
*
* @summary Control page and term functionality.
*/
var commentsBox, WPSetThumbnailHTML, WPSetThumbnailID, WPRemoveThumbnail, wptitlehint, makeSlugeditClickable, editPermalink; var commentsBox, WPSetThumbnailHTML, WPSetThumbnailID, WPRemoveThumbnail, wptitlehint, makeSlugeditClickable, editPermalink;
// Back-compat: prevent fatal errors // Backwards compatibility: prevent fatal errors.
makeSlugeditClickable = editPermalink = function(){}; makeSlugeditClickable = editPermalink = function(){};
// Make sure the wp object exists.
window.wp = window.wp || {}; window.wp = window.wp || {};
( function( $ ) { ( function( $ ) {
var titleHasFocus = false; var titleHasFocus = false;
commentsBox = { /**
* Control loading of comments on the post and term edit pages.
*
* @type {{st: number, get: commentsBox.get, load: commentsBox.load}}
*
* @namespace commentsBox
*/
commentsBox = {
// Comment offset to use when fetching new comments.
st : 0, st : 0,
/**
* Fetch comments using AJAX and display them in the box.
*
* @param {int} total Total number of comments for this post.
* @param {int} num Optional. Number of comments to fetch, defaults to 20.
* @returns {boolean} Always returns false.
*
* @memberof commentsBox
*/
get : function(total, num) { get : function(total, num) {
var st = this.st, data; var st = this.st, data;
if ( ! num ) if ( ! num )
@ -31,7 +55,9 @@ commentsBox = {
'number' : num 'number' : num
}; };
$.post(ajaxurl, data, $.post(
ajaxurl,
data,
function(r) { function(r) {
r = wpAjax.parseAjaxResponse(r); r = wpAjax.parseAjaxResponse(r);
$('#commentsdiv .widefat').show(); $('#commentsdiv .widefat').show();
@ -43,6 +69,7 @@ commentsBox = {
theList = theExtraList = null; theList = theExtraList = null;
$( 'a[className*=\':\']' ).unbind(); $( 'a[className*=\':\']' ).unbind();
// If the offset is over the total number of comments we cannot fetch any more, so hide the button.
if ( commentsBox.st > commentsBox.total ) if ( commentsBox.st > commentsBox.total )
$('#show-comments').hide(); $('#show-comments').hide();
else else
@ -61,27 +88,61 @@ commentsBox = {
return false; return false;
}, },
/**
* Load the next batch of comments.
*
* @param {int} total Total number of comments to load.
*
* @memberof commentsBox
*/
load: function(total){ load: function(total){
this.st = jQuery('#the-comment-list tr.comment:visible').length; this.st = jQuery('#the-comment-list tr.comment:visible').length;
this.get(total); this.get(total);
} }
}; };
WPSetThumbnailHTML = function(html){ /**
* Overwrite the content of the Featured Image postbox
*
* @param {string} html New HTML to be displayed in the content area of the postbox.
*
* @global
*/
WPSetThumbnailHTML = function(html){
$('.inside', '#postimagediv').html(html); $('.inside', '#postimagediv').html(html);
}; };
WPSetThumbnailID = function(id){ /**
* Set the Image ID of the Featured Image
*
* @param {int} id The post_id of the image to use as Featured Image.
*
* @global
*/
WPSetThumbnailID = function(id){
var field = $('input[value="_thumbnail_id"]', '#list-table'); var field = $('input[value="_thumbnail_id"]', '#list-table');
if ( field.length > 0 ) { if ( field.length > 0 ) {
$('#meta\\[' + field.attr('id').match(/[0-9]+/) + '\\]\\[value\\]').text(id); $('#meta\\[' + field.attr('id').match(/[0-9]+/) + '\\]\\[value\\]').text(id);
} }
}; };
WPRemoveThumbnail = function(nonce){ /**
* Remove the Featured Image
*
* @param {string} nonce Nonce to use in the request.
*
* @global
*/
WPRemoveThumbnail = function(nonce){
$.post(ajaxurl, { $.post(ajaxurl, {
action: 'set-post-thumbnail', post_id: $( '#post_ID' ).val(), thumbnail_id: -1, _ajax_nonce: nonce, cookie: encodeURIComponent( document.cookie ) action: 'set-post-thumbnail', post_id: $( '#post_ID' ).val(), thumbnail_id: -1, _ajax_nonce: nonce, cookie: encodeURIComponent( document.cookie )
}, function(str){ },
/**
* Handle server response
*
* @param {string} str Response, will be '0' when an error occured otherwise contains link to add Featured Image.
*/
function(str){
if ( str == '0' ) { if ( str == '0' ) {
alert( setPostThumbnailL10n.error ); alert( setPostThumbnailL10n.error );
} else { } else {
@ -89,9 +150,17 @@ WPRemoveThumbnail = function(nonce){
} }
} }
); );
}; };
$(document).on( 'heartbeat-send.refresh-lock', function( e, data ) { /**
* Heartbeat locks.
*
* Used to lock editing of an object by only one user at a time.
*
* When the user does not send a heartbeat in a heartbeat-time
* the user is no longer editing and another user can start editing.
*/
$(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
var lock = $('#active_post_lock').val(), var lock = $('#active_post_lock').val(),
post_id = $('#post_ID').val(), post_id = $('#post_ID').val(),
send = {}; send = {};
@ -106,20 +175,20 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
data['wp-refresh-post-lock'] = send; data['wp-refresh-post-lock'] = send;
}).on( 'heartbeat-tick.refresh-lock', function( e, data ) { }).on( 'heartbeat-tick.refresh-lock', function( e, data ) {
// Post locks: update the lock string or show the dialog if somebody has taken over editing // Post locks: update the lock string or show the dialog if somebody has taken over editing.
var received, wrap, avatar; var received, wrap, avatar;
if ( data['wp-refresh-post-lock'] ) { if ( data['wp-refresh-post-lock'] ) {
received = data['wp-refresh-post-lock']; received = data['wp-refresh-post-lock'];
if ( received.lock_error ) { if ( received.lock_error ) {
// show "editing taken over" message // Show "editing taken over" message.
wrap = $('#post-lock-dialog'); wrap = $('#post-lock-dialog');
if ( wrap.length && ! wrap.is(':visible') ) { if ( wrap.length && ! wrap.is(':visible') ) {
if ( wp.autosave ) { if ( wp.autosave ) {
// Save the latest changes and disable // Save the latest changes and disable.
$(document).one( 'heartbeat-tick', function() { $(document).one( 'heartbeat-tick', function() {
wp.autosave.server.suspend(); wp.autosave.server.suspend();
wrap.removeClass('saving').addClass('saved'); wrap.removeClass('saving').addClass('saved');
@ -142,11 +211,14 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
$('#active_post_lock').val( received.new_lock ); $('#active_post_lock').val( received.new_lock );
} }
} }
}).on( 'before-autosave.update-post-slug', function() { }).on( 'before-autosave.update-post-slug', function() {
titleHasFocus = document.activeElement && document.activeElement.id === 'title'; titleHasFocus = document.activeElement && document.activeElement.id === 'title';
}).on( 'after-autosave.update-post-slug', function() { }).on( 'after-autosave.update-post-slug', function() {
// Create slug area only if not already there
// and the title field was not focused (user was not typing a title) when autosave ran /*
* Create slug area only if not already there
* and the title field was not focused (user was not typing a title) when autosave ran.
*/
if ( ! $('#edit-slug-box > *').length && ! titleHasFocus ) { if ( ! $('#edit-slug-box > *').length && ! titleHasFocus ) {
$.post( ajaxurl, { $.post( ajaxurl, {
action: 'sample-permalink', action: 'sample-permalink',
@ -161,13 +233,19 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
} }
); );
} }
}); });
}(jQuery)); }(jQuery));
/**
* Heartbeat refresh nonces.
*/
(function($) { (function($) {
var check, timeout; var check, timeout;
/**
* Only allow to check for nonce refresh every 30 seconds.
*/
function schedule() { function schedule() {
check = false; check = false;
window.clearTimeout( timeout ); window.clearTimeout( timeout );
@ -205,6 +283,9 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
}); });
}(jQuery)); }(jQuery));
/**
* All post and postbox controls and functionality.
*/
jQuery(document).ready( function($) { jQuery(document).ready( function($) {
var stamp, visibility, $submitButtons, updateVisibility, updateText, var stamp, visibility, $submitButtons, updateVisibility, updateText,
sticky = '', sticky = '',
@ -220,32 +301,37 @@ jQuery(document).ready( function($) {
postboxes.add_postbox_toggles(pagenow); postboxes.add_postbox_toggles(pagenow);
// Clear the window name. Otherwise if this is a former preview window where the user navigated to edit another post, /*
// and the first post is still being edited, clicking Preview there will use this window to show the preview. * Clear the window name. Otherwise if this is a former preview window where the user navigated to edit another post,
* and the first post is still being edited, clicking Preview there will use this window to show the preview.
*/
window.name = ''; window.name = '';
// Post locks: contain focus inside the dialog. If the dialog is shown, focus the first item. // Post locks: contain focus inside the dialog. If the dialog is shown, focus the first item.
$('#post-lock-dialog .notification-dialog').on( 'keydown', function(e) { $('#post-lock-dialog .notification-dialog').on( 'keydown', function(e) {
// Don't do anything when [tab] is pressed.
if ( e.which != 9 ) if ( e.which != 9 )
return; return;
var target = $(e.target); var target = $(e.target);
// [shift] + [tab] on first tab cycles back to last tab.
if ( target.hasClass('wp-tab-first') && e.shiftKey ) { if ( target.hasClass('wp-tab-first') && e.shiftKey ) {
$(this).find('.wp-tab-last').focus(); $(this).find('.wp-tab-last').focus();
e.preventDefault(); e.preventDefault();
// [tab] on last tab cycles back to first tab.
} else if ( target.hasClass('wp-tab-last') && ! e.shiftKey ) { } else if ( target.hasClass('wp-tab-last') && ! e.shiftKey ) {
$(this).find('.wp-tab-first').focus(); $(this).find('.wp-tab-first').focus();
e.preventDefault(); e.preventDefault();
} }
}).filter(':visible').find('.wp-tab-first').focus(); }).filter(':visible').find('.wp-tab-first').focus();
// Set the heartbeat interval to 15 sec. if post lock dialogs are enabled // Set the heartbeat interval to 15 sec. if post lock dialogs are enabled.
if ( wp.heartbeat && $('#post-lock-dialog').length ) { if ( wp.heartbeat && $('#post-lock-dialog').length ) {
wp.heartbeat.interval( 15 ); wp.heartbeat.interval( 15 );
} }
// The form is being submitted by the user // The form is being submitted by the user.
$submitButtons = $submitpost.find( ':submit, a.submitdelete, #post-preview' ).on( 'click.edit-post', function( event ) { $submitButtons = $submitpost.find( ':submit, a.submitdelete, #post-preview' ).on( 'click.edit-post', function( event ) {
var $button = $(this); var $button = $(this);
@ -265,7 +351,7 @@ jQuery(document).ready( function($) {
return; return;
} }
// Stop autosave // Stop auto save.
if ( wp.autosave ) { if ( wp.autosave ) {
wp.autosave.server.suspend(); wp.autosave.server.suspend();
} }
@ -350,7 +436,7 @@ jQuery(document).ready( function($) {
} }
}); });
// Autosave new posts after a title is typed // Auto save new posts after a title is typed.
if ( $( '#auto_draft' ).val() ) { if ( $( '#auto_draft' ).val() ) {
$( '#title' ).blur( function() { $( '#title' ).blur( function() {
var cancel; var cancel;
@ -359,7 +445,7 @@ jQuery(document).ready( function($) {
return; return;
} }
// Cancel the autosave when the blur was triggered by the user submitting the form // Cancel the auto save when the blur was triggered by the user submitting the form.
$('form#post').one( 'submit', function() { $('form#post').one( 'submit', function() {
cancel = true; cancel = true;
}); });
@ -388,6 +474,10 @@ jQuery(document).ready( function($) {
} }
}); });
/*
* When the user is trying to load another page, or reloads current page
* show a confirmation dialog when there are unsaved changes.
*/
$(window).on( 'beforeunload.edit-post', function() { $(window).on( 'beforeunload.edit-post', function() {
var editor = typeof tinymce !== 'undefined' && tinymce.get('content'); var editor = typeof tinymce !== 'undefined' && tinymce.get('content');
@ -401,8 +491,10 @@ jQuery(document).ready( function($) {
return; return;
} }
// Unload is triggered (by hand) on removing the Thickbox iframe. /*
// Make sure we process only the main document unload. * Unload is triggered (by hand) on removing the Thickbox iframe.
* Make sure we process only the main document unload.
*/
if ( event.target && event.target.nodeName != '#document' ) { if ( event.target && event.target.nodeName != '#document' ) {
return; return;
} }
@ -435,7 +527,7 @@ jQuery(document).ready( function($) {
}); });
}); });
// multi-taxonomies // Multiple Taxonomies.
if ( $('#tagsdiv-post_tag').length ) { if ( $('#tagsdiv-post_tag').length ) {
window.tagBox && window.tagBox.init(); window.tagBox && window.tagBox.init();
} else { } else {
@ -447,7 +539,7 @@ jQuery(document).ready( function($) {
}); });
} }
// categories // Handle categories.
$('.categorydiv').each( function(){ $('.categorydiv').each( function(){
var this_id = $(this).attr('id'), catAddBefore, catAddAfter, taxonomyParts, taxonomy, settingName; var this_id = $(this).attr('id'), catAddBefore, catAddAfter, taxonomyParts, taxonomy, settingName;
@ -455,8 +547,10 @@ jQuery(document).ready( function($) {
taxonomyParts.shift(); taxonomyParts.shift();
taxonomy = taxonomyParts.join('-'); taxonomy = taxonomyParts.join('-');
settingName = taxonomy + '_tab'; settingName = taxonomy + '_tab';
if ( taxonomy == 'category' )
if ( taxonomy == 'category' ) {
settingName = 'cats'; settingName = 'cats';
}
// TODO: move to jQuery 1.3+, support for multiple hierarchical taxonomies, see wp-lists.js // TODO: move to jQuery 1.3+, support for multiple hierarchical taxonomies, see wp-lists.js
$('a', '#' + taxonomy + '-tabs').click( function( e ) { $('a', '#' + taxonomy + '-tabs').click( function( e ) {
@ -465,34 +559,62 @@ jQuery(document).ready( function($) {
$(this).parent().addClass('tabs').siblings('li').removeClass('tabs'); $(this).parent().addClass('tabs').siblings('li').removeClass('tabs');
$('#' + taxonomy + '-tabs').siblings('.tabs-panel').hide(); $('#' + taxonomy + '-tabs').siblings('.tabs-panel').hide();
$(t).show(); $(t).show();
if ( '#' + taxonomy + '-all' == t ) if ( '#' + taxonomy + '-all' == t ) {
deleteUserSetting( settingName ); deleteUserSetting( settingName );
else } else {
setUserSetting( settingName, 'pop' ); setUserSetting( settingName, 'pop' );
}
}); });
if ( getUserSetting( settingName ) ) if ( getUserSetting( settingName ) )
$('a[href="#' + taxonomy + '-pop"]', '#' + taxonomy + '-tabs').click(); $('a[href="#' + taxonomy + '-pop"]', '#' + taxonomy + '-tabs').click();
// Ajax Cat // Add category button controls.
$( '#new' + taxonomy ).one( 'focus', function() { $( this ).val( '' ).removeClass( 'form-input-tip' ); } ); $('#new' + taxonomy).one( 'focus', function() {
$( this ).val( '' ).removeClass( 'form-input-tip' );
});
// On [enter] submit the taxonomy.
$('#new' + taxonomy).keypress( function(event){ $('#new' + taxonomy).keypress( function(event){
if( 13 === event.keyCode ) { if( 13 === event.keyCode ) {
event.preventDefault(); event.preventDefault();
$('#' + taxonomy + '-add-submit').click(); $('#' + taxonomy + '-add-submit').click();
} }
}); });
$('#' + taxonomy + '-add-submit').click( function(){ $('#new' + taxonomy).focus(); });
// After submitting a new taxonomy, re-focus the input field.
$('#' + taxonomy + '-add-submit').click( function() {
$('#new' + taxonomy).focus();
});
/**
* Before adding a new taxonomy, disable submit button.
*
* @param {Object} s Taxonomy object which will be added.
*
* @returns {Object}
*/
catAddBefore = function( s ) { catAddBefore = function( s ) {
if ( !$('#new'+taxonomy).val() ) if ( !$('#new'+taxonomy).val() ) {
return false; return false;
}
s.data += '&' + $( ':checked', '#'+taxonomy+'checklist' ).serialize(); s.data += '&' + $( ':checked', '#'+taxonomy+'checklist' ).serialize();
$( '#' + taxonomy + '-add-submit' ).prop( 'disabled', true ); $( '#' + taxonomy + '-add-submit' ).prop( 'disabled', true );
return s; return s;
}; };
/**
* Re-enable submit button after a taxonomy has been added.
*
* Re-enable submit button.
* If the taxonomy has a parent place the taxonomy underneath the parent.
*
* @param {Object} r Response.
* @param {Object} s Taxonomy data.
*
* @returns void
*/
catAddAfter = function( r, s ) { catAddAfter = function( r, s ) {
var sup, drop = $('#new'+taxonomy+'_parent'); var sup, drop = $('#new'+taxonomy+'_parent');
@ -510,6 +632,7 @@ jQuery(document).ready( function($) {
addAfter: catAddAfter addAfter: catAddAfter
}); });
// Add new taxonomy button toggles input form visibility.
$('#' + taxonomy + '-add-toggle').click( function( e ) { $('#' + taxonomy + '-add-toggle').click( function( e ) {
e.preventDefault(); e.preventDefault();
$('#' + taxonomy + '-adder').toggleClass( 'wp-hidden-children' ); $('#' + taxonomy + '-adder').toggleClass( 'wp-hidden-children' );
@ -517,6 +640,7 @@ jQuery(document).ready( function($) {
$('#new'+taxonomy).focus(); $('#new'+taxonomy).focus();
}); });
// Sync checked items between "All {taxonomy}" and "Most used" lists.
$('#' + taxonomy + 'checklist, #' + taxonomy + 'checklist-pop').on( 'click', 'li.popular-category > label input[type="checkbox"]', function() { $('#' + taxonomy + 'checklist, #' + taxonomy + 'checklist-pop').on( 'click', 'li.popular-category > label input[type="checkbox"]', function() {
var t = $(this), c = t.is(':checked'), id = t.val(); var t = $(this), c = t.is(':checked'), id = t.val();
if ( id && t.parents('#taxonomy-'+taxonomy).length ) if ( id && t.parents('#taxonomy-'+taxonomy).length )
@ -525,29 +649,51 @@ jQuery(document).ready( function($) {
}); // end cats }); // end cats
// Custom Fields // Custom Fields postbox.
if ( $('#postcustom').length ) { if ( $('#postcustom').length ) {
$( '#the-list' ).wpList( { addAfter: function() { $( '#the-list' ).wpList( {
$('table#list-table').show(); /**
}, addBefore: function( s ) { * Add current post_ID to request to fetch custom fields
*
* @param {Object} s Request object.
*
* @returns {Object} Data modified with post_ID attached.
*/
addBefore: function( s ) {
s.data += '&post_id=' + $('#post_ID').val(); s.data += '&post_id=' + $('#post_ID').val();
return s; return s;
},
/**
* Show the listing of custom fields after fetching.
*/
addAfter: function() {
$('table#list-table').show();
} }
}); });
} }
// submitdiv /*
* Publish Post box (#submitdiv)
*/
if ( $('#submitdiv').length ) { if ( $('#submitdiv').length ) {
stamp = $('#timestamp').html(); stamp = $('#timestamp').html();
visibility = $('#post-visibility-display').html(); visibility = $('#post-visibility-display').html();
/**
* When the visibility of a post changes sub-options should be shown or hidden.
*
* @returns void
*/
updateVisibility = function() { updateVisibility = function() {
// Show sticky for public posts.
if ( $postVisibilitySelect.find('input:radio:checked').val() != 'public' ) { if ( $postVisibilitySelect.find('input:radio:checked').val() != 'public' ) {
$('#sticky').prop('checked', false); $('#sticky').prop('checked', false);
$('#sticky-span').hide(); $('#sticky-span').hide();
} else { } else {
$('#sticky-span').show(); $('#sticky-span').show();
} }
// Show password input field for password protected post.
if ( $postVisibilitySelect.find('input:radio:checked').val() != 'password' ) { if ( $postVisibilitySelect.find('input:radio:checked').val() != 'password' ) {
$('#password-span').hide(); $('#password-span').hide();
} else { } else {
@ -555,6 +701,11 @@ jQuery(document).ready( function($) {
} }
}; };
/**
* Make sure all labels represent the current settings.
*
* @returns {boolean} False when an invalid timestamp has been selected, otherwise True.
*/
updateText = function() { updateText = function() {
if ( ! $timestampdiv.length ) if ( ! $timestampdiv.length )
@ -568,6 +719,7 @@ jQuery(document).ready( function($) {
originalDate = new Date( $('#hidden_aa').val(), $('#hidden_mm').val() -1, $('#hidden_jj').val(), $('#hidden_hh').val(), $('#hidden_mn').val() ); originalDate = new Date( $('#hidden_aa').val(), $('#hidden_mm').val() -1, $('#hidden_jj').val(), $('#hidden_hh').val(), $('#hidden_mn').val() );
currentDate = new Date( $('#cur_aa').val(), $('#cur_mm').val() -1, $('#cur_jj').val(), $('#cur_hh').val(), $('#cur_mn').val() ); currentDate = new Date( $('#cur_aa').val(), $('#cur_mm').val() -1, $('#cur_jj').val(), $('#cur_hh').val(), $('#cur_mn').val() );
// Catch unexpected date problems.
if ( attemptedDate.getFullYear() != aa || (1 + attemptedDate.getMonth()) != mm || attemptedDate.getDate() != jj || attemptedDate.getMinutes() != mn ) { if ( attemptedDate.getFullYear() != aa || (1 + attemptedDate.getMonth()) != mm || attemptedDate.getDate() != jj || attemptedDate.getMinutes() != mn ) {
$timestampdiv.find('.timestamp-wrap').addClass('form-invalid'); $timestampdiv.find('.timestamp-wrap').addClass('form-invalid');
return false; return false;
@ -575,6 +727,7 @@ jQuery(document).ready( function($) {
$timestampdiv.find('.timestamp-wrap').removeClass('form-invalid'); $timestampdiv.find('.timestamp-wrap').removeClass('form-invalid');
} }
// Determine what the publish should be depending on the date and post status.
if ( attemptedDate > currentDate && $('#original_post_status').val() != 'future' ) { if ( attemptedDate > currentDate && $('#original_post_status').val() != 'future' ) {
publishOn = postL10n.publishOnFuture; publishOn = postL10n.publishOnFuture;
$('#publish').val( postL10n.schedule ); $('#publish').val( postL10n.schedule );
@ -585,7 +738,10 @@ jQuery(document).ready( function($) {
publishOn = postL10n.publishOnPast; publishOn = postL10n.publishOnPast;
$('#publish').val( postL10n.update ); $('#publish').val( postL10n.update );
} }
if ( originalDate.toUTCString() == attemptedDate.toUTCString() ) { //hack
// If the date is the same, set it to trigger update events.
if ( originalDate.toUTCString() == attemptedDate.toUTCString() ) {
// Re-set to the current value.
$('#timestamp').html(stamp); $('#timestamp').html(stamp);
} else { } else {
$('#timestamp').html( $('#timestamp').html(
@ -600,6 +756,7 @@ jQuery(document).ready( function($) {
); );
} }
// Add "privately published" to post status when applies.
if ( $postVisibilitySelect.find('input:radio:checked').val() == 'private' ) { if ( $postVisibilitySelect.find('input:radio:checked').val() == 'private' ) {
$('#publish').val( postL10n.update ); $('#publish').val( postL10n.update );
if ( 0 === optPublish.length ) { if ( 0 === optPublish.length ) {
@ -621,7 +778,11 @@ jQuery(document).ready( function($) {
if ( postStatus.is(':hidden') ) if ( postStatus.is(':hidden') )
$('#misc-publishing-actions .edit-post-status').show(); $('#misc-publishing-actions .edit-post-status').show();
} }
// Update "Status:" to currently selected status.
$('#post-status-display').html($('option:selected', postStatus).text()); $('#post-status-display').html($('option:selected', postStatus).text());
// Show or hide the "Save Draft" button.
if ( $('option:selected', postStatus).val() == 'private' || $('option:selected', postStatus).val() == 'publish' ) { if ( $('option:selected', postStatus).val() == 'private' || $('option:selected', postStatus).val() == 'publish' ) {
$('#save-post').hide(); $('#save-post').hide();
} else { } else {
@ -635,6 +796,7 @@ jQuery(document).ready( function($) {
return true; return true;
}; };
// Show the visibility options and hide the toggle button when opened.
$( '#visibility .edit-visibility').click( function( e ) { $( '#visibility .edit-visibility').click( function( e ) {
e.preventDefault(); e.preventDefault();
if ( $postVisibilitySelect.is(':hidden') ) { if ( $postVisibilitySelect.is(':hidden') ) {
@ -646,6 +808,7 @@ jQuery(document).ready( function($) {
} }
}); });
// Cancel visibility selection area and hide it from view.
$postVisibilitySelect.find('.cancel-post-visibility').click( function( event ) { $postVisibilitySelect.find('.cancel-post-visibility').click( function( event ) {
$postVisibilitySelect.slideUp('fast'); $postVisibilitySelect.slideUp('fast');
$('#visibility-radio-' + $('#hidden-post-visibility').val()).prop('checked', true); $('#visibility-radio-' + $('#hidden-post-visibility').val()).prop('checked', true);
@ -657,6 +820,7 @@ jQuery(document).ready( function($) {
event.preventDefault(); event.preventDefault();
}); });
// Set the selected visibility as current.
$postVisibilitySelect.find('.save-post-visibility').click( function( event ) { // crazyhorse - multiple ok cancels $postVisibilitySelect.find('.save-post-visibility').click( function( event ) { // crazyhorse - multiple ok cancels
$postVisibilitySelect.slideUp('fast'); $postVisibilitySelect.slideUp('fast');
$('#visibility .edit-visibility').show().focus(); $('#visibility .edit-visibility').show().focus();
@ -664,7 +828,7 @@ jQuery(document).ready( function($) {
if ( $postVisibilitySelect.find('input:radio:checked').val() != 'public' ) { if ( $postVisibilitySelect.find('input:radio:checked').val() != 'public' ) {
$('#sticky').prop('checked', false); $('#sticky').prop('checked', false);
} // WEAPON LOCKED }
if ( $('#sticky').prop('checked') ) { if ( $('#sticky').prop('checked') ) {
sticky = 'Sticky'; sticky = 'Sticky';
@ -676,10 +840,12 @@ jQuery(document).ready( function($) {
event.preventDefault(); event.preventDefault();
}); });
// When the selection changes, update labels.
$postVisibilitySelect.find('input:radio').change( function() { $postVisibilitySelect.find('input:radio').change( function() {
updateVisibility(); updateVisibility();
}); });
// Edit publish time click.
$timestampdiv.siblings('a.edit-timestamp').click( function( event ) { $timestampdiv.siblings('a.edit-timestamp').click( function( event ) {
if ( $timestampdiv.is( ':hidden' ) ) { if ( $timestampdiv.is( ':hidden' ) ) {
$timestampdiv.slideDown( 'fast', function() { $timestampdiv.slideDown( 'fast', function() {
@ -690,6 +856,7 @@ jQuery(document).ready( function($) {
event.preventDefault(); event.preventDefault();
}); });
// Cancel editing the publish time and hide the settings.
$timestampdiv.find('.cancel-timestamp').click( function( event ) { $timestampdiv.find('.cancel-timestamp').click( function( event ) {
$timestampdiv.slideUp('fast').siblings('a.edit-timestamp').show().focus(); $timestampdiv.slideUp('fast').siblings('a.edit-timestamp').show().focus();
$('#mm').val($('#hidden_mm').val()); $('#mm').val($('#hidden_mm').val());
@ -701,6 +868,7 @@ jQuery(document).ready( function($) {
event.preventDefault(); event.preventDefault();
}); });
// Save the changed timestamp.
$timestampdiv.find('.save-timestamp').click( function( event ) { // crazyhorse - multiple ok cancels $timestampdiv.find('.save-timestamp').click( function( event ) { // crazyhorse - multiple ok cancels
if ( updateText() ) { if ( updateText() ) {
$timestampdiv.slideUp('fast'); $timestampdiv.slideUp('fast');
@ -709,6 +877,7 @@ jQuery(document).ready( function($) {
event.preventDefault(); event.preventDefault();
}); });
// Cancel submit when an invalid timestamp has been selected.
$('#post').on( 'submit', function( event ) { $('#post').on( 'submit', function( event ) {
if ( ! updateText() ) { if ( ! updateText() ) {
event.preventDefault(); event.preventDefault();
@ -722,6 +891,7 @@ jQuery(document).ready( function($) {
} }
}); });
// Post Status edit click.
$postStatusSelect.siblings('a.edit-post-status').click( function( event ) { $postStatusSelect.siblings('a.edit-post-status').click( function( event ) {
if ( $postStatusSelect.is( ':hidden' ) ) { if ( $postStatusSelect.is( ':hidden' ) ) {
$postStatusSelect.slideDown( 'fast', function() { $postStatusSelect.slideDown( 'fast', function() {
@ -732,21 +902,31 @@ jQuery(document).ready( function($) {
event.preventDefault(); event.preventDefault();
}); });
// Save the Post Status changes and hide the options.
$postStatusSelect.find('.save-post-status').click( function( event ) { $postStatusSelect.find('.save-post-status').click( function( event ) {
$postStatusSelect.slideUp( 'fast' ).siblings( 'a.edit-post-status' ).show().focus(); $postStatusSelect.slideUp( 'fast' ).siblings( 'a.edit-post-status' ).show().focus();
updateText(); updateText();
event.preventDefault(); event.preventDefault();
}); });
// Cancel Post Status editing and hide the options.
$postStatusSelect.find('.cancel-post-status').click( function( event ) { $postStatusSelect.find('.cancel-post-status').click( function( event ) {
$postStatusSelect.slideUp( 'fast' ).siblings( 'a.edit-post-status' ).show().focus(); $postStatusSelect.slideUp( 'fast' ).siblings( 'a.edit-post-status' ).show().focus();
$('#post_status').val( $('#hidden_post_status').val() ); $('#post_status').val( $('#hidden_post_status').val() );
updateText(); updateText();
event.preventDefault(); event.preventDefault();
}); });
} // end submitdiv }
// permalink /**
* Handle the editing of the post_name. Create the required HTML elements and update the changes via AJAX.
*
* @summary Permalink aka slug aka post_name editing
*
* @global
*
* @returns void
*/
function editPermalink() { function editPermalink() {
var i, slug_value, var i, slug_value,
$el, revert_e, $el, revert_e,
@ -760,15 +940,19 @@ jQuery(document).ready( function($) {
buttonsOrig = buttons.html(), buttonsOrig = buttons.html(),
full = $('#editable-post-name-full'); full = $('#editable-post-name-full');
// Deal with Twemoji in the post-name // Deal with Twemoji in the post-name.
full.find( 'img' ).replaceWith( function() { return this.alt; } ); full.find( 'img' ).replaceWith( function() { return this.alt; } );
full = full.html(); full = full.html();
permalink.html( permalinkInner ); permalink.html( permalinkInner );
// Save current content to revert to when cancelling.
$el = $( '#editable-post-name' ); $el = $( '#editable-post-name' );
revert_e = $el.html(); revert_e = $el.html();
buttons.html( '<button type="button" class="save button button-small">' + postL10n.ok + '</button> <button type="button" class="cancel button-link">' + postL10n.cancel + '</button>' ); buttons.html( '<button type="button" class="save button button-small">' + postL10n.ok + '</button> <button type="button" class="cancel button-link">' + postL10n.cancel + '</button>' );
// Save permalink changes.
buttons.children( '.save' ).click( function() { buttons.children( '.save' ).click( function() {
var new_slug = $el.children( 'input' ).val(); var new_slug = $el.children( 'input' ).val();
@ -776,13 +960,17 @@ jQuery(document).ready( function($) {
buttons.children('.cancel').click(); buttons.children('.cancel').click();
return; return;
} }
$.post(ajaxurl, {
$.post(
ajaxurl,
{
action: 'sample-permalink', action: 'sample-permalink',
post_id: postId, post_id: postId,
new_slug: new_slug, new_slug: new_slug,
new_title: $('#title').val(), new_title: $('#title').val(),
samplepermalinknonce: $('#samplepermalinknonce').val() samplepermalinknonce: $('#samplepermalinknonce').val()
}, function(data) { },
function(data) {
var box = $('#edit-slug-box'); var box = $('#edit-slug-box');
box.html(data); box.html(data);
if (box.hasClass('hidden')) { if (box.hasClass('hidden')) {
@ -796,9 +984,11 @@ jQuery(document).ready( function($) {
real_slug.val(new_slug); real_slug.val(new_slug);
$( '.edit-slug' ).focus(); $( '.edit-slug' ).focus();
wp.a11y.speak( postL10n.permalinkSaved ); wp.a11y.speak( postL10n.permalinkSaved );
}); }
);
}); });
// Cancel editing of permalink.
buttons.children( '.cancel' ).click( function() { buttons.children( '.cancel' ).click( function() {
$('#view-post-btn').show(); $('#view-post-btn').show();
$el.html(revert_e); $el.html(revert_e);
@ -808,19 +998,21 @@ jQuery(document).ready( function($) {
$( '.edit-slug' ).focus(); $( '.edit-slug' ).focus();
}); });
// If more than 1/4th of 'full' is '%', make it empty.
for ( i = 0; i < full.length; ++i ) { for ( i = 0; i < full.length; ++i ) {
if ( '%' == full.charAt(i) ) if ( '%' == full.charAt(i) )
c++; c++;
} }
slug_value = ( c > full.length / 4 ) ? '' : full; slug_value = ( c > full.length / 4 ) ? '' : full;
$el.html( '<input type="text" id="new-post-slug" value="' + slug_value + '" autocomplete="off" />' ).children( 'input' ).keydown( function( e ) { $el.html( '<input type="text" id="new-post-slug" value="' + slug_value + '" autocomplete="off" />' ).children( 'input' ).keydown( function( e ) {
var key = e.which; var key = e.which;
// On enter, just save the new slug, don't save the post. // On [enter], just save the new slug, don't save the post.
if ( 13 === key ) { if ( 13 === key ) {
e.preventDefault(); e.preventDefault();
buttons.children( '.save' ).click(); buttons.children( '.save' ).click();
} }
// On [esc] cancel the editing.
if ( 27 === key ) { if ( 27 === key ) {
buttons.children( '.cancel' ).click(); buttons.children( '.cancel' ).click();
} }
@ -833,6 +1025,17 @@ jQuery(document).ready( function($) {
editPermalink(); editPermalink();
}); });
/**
* Add screen reader text to the title prompt when needed.
*
* @summary Title screen reader text handler.
*
* @param {string} id Optional. HTML ID to add the screen reader helper text to.
*
* @global
*
* @returns void
*/
wptitlehint = function(id) { wptitlehint = function(id) {
id = id || 'title'; id = id || 'title';
@ -859,19 +1062,24 @@ jQuery(document).ready( function($) {
wptitlehint(); wptitlehint();
// Resize the visual and text editors // Resize the WYSIWYG and plain text editors.
( function() { ( function() {
var editor, offset, mce, var editor, offset, mce,
$handle = $('#post-status-info'), $handle = $('#post-status-info'),
$postdivrich = $('#postdivrich'); $postdivrich = $('#postdivrich');
// No point for touch devices // If there are no textareas or we are on a touch device, we can't do anything.
if ( ! $textarea.length || 'ontouchstart' in window ) { if ( ! $textarea.length || 'ontouchstart' in window ) {
// Hide the resize handle // Hide the resize handle.
$('#content-resize-handle').hide(); $('#content-resize-handle').hide();
return; return;
} }
/**
* Handle drag event.
*
* @param {Object} event Event containing details about the drag.
*/
function dragging( event ) { function dragging( event ) {
if ( $postdivrich.hasClass( 'wp-editor-expand' ) ) { if ( $postdivrich.hasClass( 'wp-editor-expand' ) ) {
return; return;
@ -886,6 +1094,9 @@ jQuery(document).ready( function($) {
event.preventDefault(); event.preventDefault();
} }
/**
* When the dragging stopped make sure we return focus and do a sanity check on the height.
*/
function endDrag() { function endDrag() {
var height, toolbarHeight; var height, toolbarHeight;
@ -909,7 +1120,7 @@ jQuery(document).ready( function($) {
$document.off( '.wp-editor-resize' ); $document.off( '.wp-editor-resize' );
// sanity check // Sanity check: normalize height to stay within acceptable ranges.
if ( height && height > 50 && height < 5000 ) { if ( height && height > 50 && height < 5000 ) {
setUserSetting( 'ed_size', height ); setUserSetting( 'ed_size', height );
} }
@ -936,8 +1147,9 @@ jQuery(document).ready( function($) {
}).on( 'mouseup.wp-editor-resize', endDrag ); }).on( 'mouseup.wp-editor-resize', endDrag );
})(); })();
// TinyMCE specific handling of Post Format changes to reflect in the editor.
if ( typeof tinymce !== 'undefined' ) { if ( typeof tinymce !== 'undefined' ) {
// When changing post formats, change the editor body class // When changing post formats, change the editor body class.
$( '#post-formats-select input.post-format' ).on( 'change.set-editor-class', function() { $( '#post-formats-select input.post-format' ).on( 'change.set-editor-class', function() {
var editor, body, format = this.id; var editor, body, format = this.id;
@ -950,8 +1162,9 @@ jQuery(document).ready( function($) {
}); });
} }
// Save on pressing Ctrl/Command + S in the Text editor // Save on pressing [ctrl]/[command] + [s] in the Text editor.
$textarea.on( 'keydown.wp-autosave', function( event ) { $textarea.on( 'keydown.wp-autosave', function( event ) {
// Key [s] has code 83.
if ( event.which === 83 ) { if ( event.which === 83 ) {
if ( event.shiftKey || event.altKey || ( isMac && ( ! event.metaKey || event.ctrlKey ) ) || ( ! isMac && ! event.ctrlKey ) ) { if ( event.shiftKey || event.altKey || ( isMac && ( ! event.metaKey || event.ctrlKey ) ) || ( ! isMac && ! event.ctrlKey ) ) {
return; return;
@ -962,6 +1175,7 @@ jQuery(document).ready( function($) {
} }
}); });
// If the last status was auto-draft and the save is triggered, edit the current URL.
if ( $( '#original_post_status' ).val() === 'auto-draft' && window.history.replaceState ) { if ( $( '#original_post_status' ).val() === 'auto-draft' && window.history.replaceState ) {
var location; var location;
@ -975,6 +1189,9 @@ jQuery(document).ready( function($) {
} }
}); });
/**
* TinyMCE word count display
*/
( function( $, counter ) { ( function( $, counter ) {
$( function() { $( function() {
var $content = $( '#content' ), var $content = $( '#content' ),
@ -982,6 +1199,9 @@ jQuery(document).ready( function($) {
prevCount = 0, prevCount = 0,
contentEditor; contentEditor;
/**
* Get the word count from TinyMCE and display it
*/
function update() { function update() {
var text, count; var text, count;
@ -1000,6 +1220,12 @@ jQuery(document).ready( function($) {
prevCount = count; prevCount = count;
} }
/**
* Bind the word count update triggers.
*
* When a node change in the main TinyMCE editor has been triggered.
* When a key has been released in the plain text content editor.
*/
$( document ).on( 'tinymce-editor-init', function( event, editor ) { $( document ).on( 'tinymce-editor-init', function( event, editor ) {
if ( editor.id !== 'content' ) { if ( editor.id !== 'content' ) {
return; return;