angelovcom.net

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

wp-api.js (46983B)


      1 /**
      2  * @output wp-includes/js/wp-api.js
      3  */
      4 
      5 (function( window, undefined ) {
      6 
      7 	'use strict';
      8 
      9 	/**
     10 	 * Initialise the WP_API.
     11 	 */
     12 	function WP_API() {
     13 		/** @namespace wp.api.models */
     14 		this.models = {};
     15 		/** @namespace wp.api.collections */
     16 		this.collections = {};
     17 		/** @namespace wp.api.views */
     18 		this.views = {};
     19 	}
     20 
     21 	/** @namespace wp */
     22 	window.wp            = window.wp || {};
     23 	/** @namespace wp.api */
     24 	wp.api               = wp.api || new WP_API();
     25 	wp.api.versionString = wp.api.versionString || 'wp/v2/';
     26 
     27 	// Alias _includes to _.contains, ensuring it is available if lodash is used.
     28 	if ( ! _.isFunction( _.includes ) && _.isFunction( _.contains ) ) {
     29 	  _.includes = _.contains;
     30 	}
     31 
     32 })( window );
     33 
     34 (function( window, undefined ) {
     35 
     36 	'use strict';
     37 
     38 	var pad, r;
     39 
     40 	/** @namespace wp */
     41 	window.wp = window.wp || {};
     42 	/** @namespace wp.api */
     43 	wp.api = wp.api || {};
     44 	/** @namespace wp.api.utils */
     45 	wp.api.utils = wp.api.utils || {};
     46 
     47 	/**
     48 	 * Determine model based on API route.
     49 	 *
     50 	 * @param {string} route    The API route.
     51 	 *
     52 	 * @return {Backbone Model} The model found at given route. Undefined if not found.
     53 	 */
     54 	wp.api.getModelByRoute = function( route ) {
     55 		return _.find( wp.api.models, function( model ) {
     56 			return model.prototype.route && route === model.prototype.route.index;
     57 		} );
     58 	};
     59 
     60 	/**
     61 	 * Determine collection based on API route.
     62 	 *
     63 	 * @param {string} route    The API route.
     64 	 *
     65 	 * @return {Backbone Model} The collection found at given route. Undefined if not found.
     66 	 */
     67 	wp.api.getCollectionByRoute = function( route ) {
     68 		return _.find( wp.api.collections, function( collection ) {
     69 			return collection.prototype.route && route === collection.prototype.route.index;
     70 		} );
     71 	};
     72 
     73 
     74 	/**
     75 	 * ECMAScript 5 shim, adapted from MDN.
     76 	 * @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
     77 	 */
     78 	if ( ! Date.prototype.toISOString ) {
     79 		pad = function( number ) {
     80 			r = String( number );
     81 			if ( 1 === r.length ) {
     82 				r = '0' + r;
     83 			}
     84 
     85 			return r;
     86 		};
     87 
     88 		Date.prototype.toISOString = function() {
     89 			return this.getUTCFullYear() +
     90 				'-' + pad( this.getUTCMonth() + 1 ) +
     91 				'-' + pad( this.getUTCDate() ) +
     92 				'T' + pad( this.getUTCHours() ) +
     93 				':' + pad( this.getUTCMinutes() ) +
     94 				':' + pad( this.getUTCSeconds() ) +
     95 				'.' + String( ( this.getUTCMilliseconds() / 1000 ).toFixed( 3 ) ).slice( 2, 5 ) +
     96 				'Z';
     97 		};
     98 	}
     99 
    100 	/**
    101 	 * Parse date into ISO8601 format.
    102 	 *
    103 	 * @param {Date} date.
    104 	 */
    105 	wp.api.utils.parseISO8601 = function( date ) {
    106 		var timestamp, struct, i, k,
    107 			minutesOffset = 0,
    108 			numericKeys = [ 1, 4, 5, 6, 7, 10, 11 ];
    109 
    110 		/*
    111 		 * ES5 §15.9.4.2 states that the string should attempt to be parsed as a Date Time String Format string
    112 		 * before falling back to any implementation-specific date parsing, so that’s what we do, even if native
    113 		 * implementations could be faster.
    114 		 */
    115 		//              1 YYYY                2 MM       3 DD           4 HH    5 mm       6 ss        7 msec        8 Z 9 ±    10 tzHH    11 tzmm
    116 		if ( ( struct = /^(\d{4}|[+\-]\d{6})(?:-(\d{2})(?:-(\d{2}))?)?(?:T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{3}))?)?(?:(Z)|([+\-])(\d{2})(?::(\d{2}))?)?)?$/.exec( date ) ) ) {
    117 
    118 			// Avoid NaN timestamps caused by “undefined” values being passed to Date.UTC.
    119 			for ( i = 0; ( k = numericKeys[i] ); ++i ) {
    120 				struct[k] = +struct[k] || 0;
    121 			}
    122 
    123 			// Allow undefined days and months.
    124 			struct[2] = ( +struct[2] || 1 ) - 1;
    125 			struct[3] = +struct[3] || 1;
    126 
    127 			if ( 'Z' !== struct[8]  && undefined !== struct[9] ) {
    128 				minutesOffset = struct[10] * 60 + struct[11];
    129 
    130 				if ( '+' === struct[9] ) {
    131 					minutesOffset = 0 - minutesOffset;
    132 				}
    133 			}
    134 
    135 			timestamp = Date.UTC( struct[1], struct[2], struct[3], struct[4], struct[5] + minutesOffset, struct[6], struct[7] );
    136 		} else {
    137 			timestamp = Date.parse ? Date.parse( date ) : NaN;
    138 		}
    139 
    140 		return timestamp;
    141 	};
    142 
    143 	/**
    144 	 * Helper function for getting the root URL.
    145 	 * @return {[type]} [description]
    146 	 */
    147 	wp.api.utils.getRootUrl = function() {
    148 		return window.location.origin ?
    149 			window.location.origin + '/' :
    150 			window.location.protocol + '//' + window.location.host + '/';
    151 	};
    152 
    153 	/**
    154 	 * Helper for capitalizing strings.
    155 	 */
    156 	wp.api.utils.capitalize = function( str ) {
    157 		if ( _.isUndefined( str ) ) {
    158 			return str;
    159 		}
    160 		return str.charAt( 0 ).toUpperCase() + str.slice( 1 );
    161 	};
    162 
    163 	/**
    164 	 * Helper function that capitalizes the first word and camel cases any words starting
    165 	 * after dashes, removing the dashes.
    166 	 */
    167 	wp.api.utils.capitalizeAndCamelCaseDashes = function( str ) {
    168 		if ( _.isUndefined( str ) ) {
    169 			return str;
    170 		}
    171 		str = wp.api.utils.capitalize( str );
    172 
    173 		return wp.api.utils.camelCaseDashes( str );
    174 	};
    175 
    176 	/**
    177 	 * Helper function to camel case the letter after dashes, removing the dashes.
    178 	 */
    179 	wp.api.utils.camelCaseDashes = function( str ) {
    180 		return str.replace( /-([a-z])/g, function( g ) {
    181 			return g[ 1 ].toUpperCase();
    182 		} );
    183 	};
    184 
    185 	/**
    186 	 * Extract a route part based on negative index.
    187 	 *
    188 	 * @param {string}   route          The endpoint route.
    189 	 * @param {number}   part           The number of parts from the end of the route to retrieve. Default 1.
    190 	 *                                  Example route `/a/b/c`: part 1 is `c`, part 2 is `b`, part 3 is `a`.
    191 	 * @param {string}  [versionString] Version string, defaults to `wp.api.versionString`.
    192 	 * @param {boolean} [reverse]       Whether to reverse the order when extracting the route part. Optional, default false.
    193 	 */
    194 	wp.api.utils.extractRoutePart = function( route, part, versionString, reverse ) {
    195 		var routeParts;
    196 
    197 		part = part || 1;
    198 		versionString = versionString || wp.api.versionString;
    199 
    200 		// Remove versions string from route to avoid returning it.
    201 		if ( 0 === route.indexOf( '/' + versionString ) ) {
    202 			route = route.substr( versionString.length + 1 );
    203 		}
    204 
    205 		routeParts = route.split( '/' );
    206 		if ( reverse ) {
    207 			routeParts = routeParts.reverse();
    208 		}
    209 		if ( _.isUndefined( routeParts[ --part ] ) ) {
    210 			return '';
    211 		}
    212 		return routeParts[ part ];
    213 	};
    214 
    215 	/**
    216 	 * Extract a parent name from a passed route.
    217 	 *
    218 	 * @param {string} route The route to extract a name from.
    219 	 */
    220 	wp.api.utils.extractParentName = function( route ) {
    221 		var name,
    222 			lastSlash = route.lastIndexOf( '_id>[\\d]+)/' );
    223 
    224 		if ( lastSlash < 0 ) {
    225 			return '';
    226 		}
    227 		name = route.substr( 0, lastSlash - 1 );
    228 		name = name.split( '/' );
    229 		name.pop();
    230 		name = name.pop();
    231 		return name;
    232 	};
    233 
    234 	/**
    235 	 * Add args and options to a model prototype from a route's endpoints.
    236 	 *
    237 	 * @param {Array}  routeEndpoints Array of route endpoints.
    238 	 * @param {Object} modelInstance  An instance of the model (or collection)
    239 	 *                                to add the args to.
    240 	 */
    241 	wp.api.utils.decorateFromRoute = function( routeEndpoints, modelInstance ) {
    242 
    243 		/**
    244 		 * Build the args based on route endpoint data.
    245 		 */
    246 		_.each( routeEndpoints, function( routeEndpoint ) {
    247 
    248 			// Add post and edit endpoints as model args.
    249 			if ( _.includes( routeEndpoint.methods, 'POST' ) || _.includes( routeEndpoint.methods, 'PUT' ) ) {
    250 
    251 				// Add any non-empty args, merging them into the args object.
    252 				if ( ! _.isEmpty( routeEndpoint.args ) ) {
    253 
    254 					// Set as default if no args yet.
    255 					if ( _.isEmpty( modelInstance.prototype.args ) ) {
    256 						modelInstance.prototype.args = routeEndpoint.args;
    257 					} else {
    258 
    259 						// We already have args, merge these new args in.
    260 						modelInstance.prototype.args = _.extend( modelInstance.prototype.args, routeEndpoint.args );
    261 					}
    262 				}
    263 			} else {
    264 
    265 				// Add GET method as model options.
    266 				if ( _.includes( routeEndpoint.methods, 'GET' ) ) {
    267 
    268 					// Add any non-empty args, merging them into the defaults object.
    269 					if ( ! _.isEmpty( routeEndpoint.args ) ) {
    270 
    271 						// Set as default if no defaults yet.
    272 						if ( _.isEmpty( modelInstance.prototype.options ) ) {
    273 							modelInstance.prototype.options = routeEndpoint.args;
    274 						} else {
    275 
    276 							// We already have options, merge these new args in.
    277 							modelInstance.prototype.options = _.extend( modelInstance.prototype.options, routeEndpoint.args );
    278 						}
    279 					}
    280 
    281 				}
    282 			}
    283 
    284 		} );
    285 
    286 	};
    287 
    288 	/**
    289 	 * Add mixins and helpers to models depending on their defaults.
    290 	 *
    291 	 * @param {Backbone Model} model          The model to attach helpers and mixins to.
    292 	 * @param {string}         modelClassName The classname of the constructed model.
    293 	 * @param {Object} 	       loadingObjects An object containing the models and collections we are building.
    294 	 */
    295 	wp.api.utils.addMixinsAndHelpers = function( model, modelClassName, loadingObjects ) {
    296 
    297 		var hasDate = false,
    298 
    299 			/**
    300 			 * Array of parseable dates.
    301 			 *
    302 			 * @type {string[]}.
    303 			 */
    304 			parseableDates = [ 'date', 'modified', 'date_gmt', 'modified_gmt' ],
    305 
    306 			/**
    307 			 * Mixin for all content that is time stamped.
    308 			 *
    309 			 * This mixin converts between mysql timestamps and JavaScript Dates when syncing a model
    310 			 * to or from the server. For example, a date stored as `2015-12-27T21:22:24` on the server
    311 			 * gets expanded to `Sun Dec 27 2015 14:22:24 GMT-0700 (MST)` when the model is fetched.
    312 			 *
    313 			 * @type {{toJSON: toJSON, parse: parse}}.
    314 			 */
    315 			TimeStampedMixin = {
    316 
    317 				/**
    318 				 * Prepare a JavaScript Date for transmitting to the server.
    319 				 *
    320 				 * This helper function accepts a field and Date object. It converts the passed Date
    321 				 * to an ISO string and sets that on the model field.
    322 				 *
    323 				 * @param {Date}   date   A JavaScript date object. WordPress expects dates in UTC.
    324 				 * @param {string} field  The date field to set. One of 'date', 'date_gmt', 'date_modified'
    325 				 *                        or 'date_modified_gmt'. Optional, defaults to 'date'.
    326 				 */
    327 				setDate: function( date, field ) {
    328 					var theField = field || 'date';
    329 
    330 					// Don't alter non-parsable date fields.
    331 					if ( _.indexOf( parseableDates, theField ) < 0 ) {
    332 						return false;
    333 					}
    334 
    335 					this.set( theField, date.toISOString() );
    336 				},
    337 
    338 				/**
    339 				 * Get a JavaScript Date from the passed field.
    340 				 *
    341 				 * WordPress returns 'date' and 'date_modified' in the timezone of the server as well as
    342 				 * UTC dates as 'date_gmt' and 'date_modified_gmt'. Draft posts do not include UTC dates.
    343 				 *
    344 				 * @param {string} field  The date field to set. One of 'date', 'date_gmt', 'date_modified'
    345 				 *                        or 'date_modified_gmt'. Optional, defaults to 'date'.
    346 				 */
    347 				getDate: function( field ) {
    348 					var theField   = field || 'date',
    349 						theISODate = this.get( theField );
    350 
    351 					// Only get date fields and non-null values.
    352 					if ( _.indexOf( parseableDates, theField ) < 0 || _.isNull( theISODate ) ) {
    353 						return false;
    354 					}
    355 
    356 					return new Date( wp.api.utils.parseISO8601( theISODate ) );
    357 				}
    358 			},
    359 
    360 			/**
    361 			 * Build a helper function to retrieve related model.
    362 			 *
    363 			 * @param {string} parentModel      The parent model.
    364 			 * @param {number} modelId          The model ID if the object to request
    365 			 * @param {string} modelName        The model name to use when constructing the model.
    366 			 * @param {string} embedSourcePoint Where to check the embedded object for _embed data.
    367 			 * @param {string} embedCheckField  Which model field to check to see if the model has data.
    368 			 *
    369 			 * @return {Deferred.promise}        A promise which resolves to the constructed model.
    370 			 */
    371 			buildModelGetter = function( parentModel, modelId, modelName, embedSourcePoint, embedCheckField ) {
    372 				var getModel, embeddedObjects, attributes, deferred;
    373 
    374 				deferred        = jQuery.Deferred();
    375 				embeddedObjects = parentModel.get( '_embedded' ) || {};
    376 
    377 				// Verify that we have a valid object id.
    378 				if ( ! _.isNumber( modelId ) || 0 === modelId ) {
    379 					deferred.reject();
    380 					return deferred;
    381 				}
    382 
    383 				// If we have embedded object data, use that when constructing the getModel.
    384 				if ( embeddedObjects[ embedSourcePoint ] ) {
    385 					attributes = _.findWhere( embeddedObjects[ embedSourcePoint ], { id: modelId } );
    386 				}
    387 
    388 				// Otherwise use the modelId.
    389 				if ( ! attributes ) {
    390 					attributes = { id: modelId };
    391 				}
    392 
    393 				// Create the new getModel model.
    394 				getModel = new wp.api.models[ modelName ]( attributes );
    395 
    396 				if ( ! getModel.get( embedCheckField ) ) {
    397 					getModel.fetch( {
    398 						success: function( getModel ) {
    399 							deferred.resolve( getModel );
    400 						},
    401 						error: function( getModel, response ) {
    402 							deferred.reject( response );
    403 						}
    404 					} );
    405 				} else {
    406 					// Resolve with the embedded model.
    407 					deferred.resolve( getModel );
    408 				}
    409 
    410 				// Return a promise.
    411 				return deferred.promise();
    412 			},
    413 
    414 			/**
    415 			 * Build a helper to retrieve a collection.
    416 			 *
    417 			 * @param {string} parentModel      The parent model.
    418 			 * @param {string} collectionName   The name to use when constructing the collection.
    419 			 * @param {string} embedSourcePoint Where to check the embedded object for _embed data.
    420 			 * @param {string} embedIndex       An additional optional index for the _embed data.
    421 			 *
    422 			 * @return {Deferred.promise} A promise which resolves to the constructed collection.
    423 			 */
    424 			buildCollectionGetter = function( parentModel, collectionName, embedSourcePoint, embedIndex ) {
    425 				/**
    426 				 * Returns a promise that resolves to the requested collection
    427 				 *
    428 				 * Uses the embedded data if available, otherwise fetches the
    429 				 * data from the server.
    430 				 *
    431 				 * @return {Deferred.promise} promise Resolves to a wp.api.collections[ collectionName ]
    432 				 * collection.
    433 				 */
    434 				var postId, embeddedObjects, getObjects,
    435 					classProperties = '',
    436 					properties      = '',
    437 					deferred        = jQuery.Deferred();
    438 
    439 				postId          = parentModel.get( 'id' );
    440 				embeddedObjects = parentModel.get( '_embedded' ) || {};
    441 
    442 				// Verify that we have a valid post ID.
    443 				if ( ! _.isNumber( postId ) || 0 === postId ) {
    444 					deferred.reject();
    445 					return deferred;
    446 				}
    447 
    448 				// If we have embedded getObjects data, use that when constructing the getObjects.
    449 				if ( ! _.isUndefined( embedSourcePoint ) && ! _.isUndefined( embeddedObjects[ embedSourcePoint ] ) ) {
    450 
    451 					// Some embeds also include an index offset, check for that.
    452 					if ( _.isUndefined( embedIndex ) ) {
    453 
    454 						// Use the embed source point directly.
    455 						properties = embeddedObjects[ embedSourcePoint ];
    456 					} else {
    457 
    458 						// Add the index to the embed source point.
    459 						properties = embeddedObjects[ embedSourcePoint ][ embedIndex ];
    460 					}
    461 				} else {
    462 
    463 					// Otherwise use the postId.
    464 					classProperties = { parent: postId };
    465 				}
    466 
    467 				// Create the new getObjects collection.
    468 				getObjects = new wp.api.collections[ collectionName ]( properties, classProperties );
    469 
    470 				// If we didn’t have embedded getObjects, fetch the getObjects data.
    471 				if ( _.isUndefined( getObjects.models[0] ) ) {
    472 					getObjects.fetch( {
    473 						success: function( getObjects ) {
    474 
    475 							// Add a helper 'parent_post' attribute onto the model.
    476 							setHelperParentPost( getObjects, postId );
    477 							deferred.resolve( getObjects );
    478 						},
    479 						error: function( getModel, response ) {
    480 							deferred.reject( response );
    481 						}
    482 					} );
    483 				} else {
    484 
    485 					// Add a helper 'parent_post' attribute onto the model.
    486 					setHelperParentPost( getObjects, postId );
    487 					deferred.resolve( getObjects );
    488 				}
    489 
    490 				// Return a promise.
    491 				return deferred.promise();
    492 
    493 			},
    494 
    495 			/**
    496 			 * Set the model post parent.
    497 			 */
    498 			setHelperParentPost = function( collection, postId ) {
    499 
    500 				// Attach post_parent id to the collection.
    501 				_.each( collection.models, function( model ) {
    502 					model.set( 'parent_post', postId );
    503 				} );
    504 			},
    505 
    506 			/**
    507 			 * Add a helper function to handle post Meta.
    508 			 */
    509 			MetaMixin = {
    510 
    511 				/**
    512 				 * Get meta by key for a post.
    513 				 *
    514 				 * @param {string} key The meta key.
    515 				 *
    516 				 * @return {Object} The post meta value.
    517 				 */
    518 				getMeta: function( key ) {
    519 					var metas = this.get( 'meta' );
    520 					return metas[ key ];
    521 				},
    522 
    523 				/**
    524 				 * Get all meta key/values for a post.
    525 				 *
    526 				 * @return {Object} The post metas, as a key value pair object.
    527 				 */
    528 				getMetas: function() {
    529 					return this.get( 'meta' );
    530 				},
    531 
    532 				/**
    533 				 * Set a group of meta key/values for a post.
    534 				 *
    535 				 * @param {Object} meta The post meta to set, as key/value pairs.
    536 				 */
    537 				setMetas: function( meta ) {
    538 					var metas = this.get( 'meta' );
    539 					_.extend( metas, meta );
    540 					this.set( 'meta', metas );
    541 				},
    542 
    543 				/**
    544 				 * Set a single meta value for a post, by key.
    545 				 *
    546 				 * @param {string} key   The meta key.
    547 				 * @param {Object} value The meta value.
    548 				 */
    549 				setMeta: function( key, value ) {
    550 					var metas = this.get( 'meta' );
    551 					metas[ key ] = value;
    552 					this.set( 'meta', metas );
    553 				}
    554 			},
    555 
    556 			/**
    557 			 * Add a helper function to handle post Revisions.
    558 			 */
    559 			RevisionsMixin = {
    560 				getRevisions: function() {
    561 					return buildCollectionGetter( this, 'PostRevisions' );
    562 				}
    563 			},
    564 
    565 			/**
    566 			 * Add a helper function to handle post Tags.
    567 			 */
    568 			TagsMixin = {
    569 
    570 				/**
    571 				 * Get the tags for a post.
    572 				 *
    573 				 * @return {Deferred.promise} promise Resolves to an array of tags.
    574 				 */
    575 				getTags: function() {
    576 					var tagIds = this.get( 'tags' ),
    577 						tags  = new wp.api.collections.Tags();
    578 
    579 					// Resolve with an empty array if no tags.
    580 					if ( _.isEmpty( tagIds ) ) {
    581 						return jQuery.Deferred().resolve( [] );
    582 					}
    583 
    584 					return tags.fetch( { data: { include: tagIds } } );
    585 				},
    586 
    587 				/**
    588 				 * Set the tags for a post.
    589 				 *
    590 				 * Accepts an array of tag slugs, or a Tags collection.
    591 				 *
    592 				 * @param {Array|Backbone.Collection} tags The tags to set on the post.
    593 				 *
    594 				 */
    595 				setTags: function( tags ) {
    596 					var allTags, newTag,
    597 						self = this,
    598 						newTags = [];
    599 
    600 					if ( _.isString( tags ) ) {
    601 						return false;
    602 					}
    603 
    604 					// If this is an array of slugs, build a collection.
    605 					if ( _.isArray( tags ) ) {
    606 
    607 						// Get all the tags.
    608 						allTags = new wp.api.collections.Tags();
    609 						allTags.fetch( {
    610 							data:    { per_page: 100 },
    611 							success: function( alltags ) {
    612 
    613 								// Find the passed tags and set them up.
    614 								_.each( tags, function( tag ) {
    615 									newTag = new wp.api.models.Tag( alltags.findWhere( { slug: tag } ) );
    616 
    617 									// Tie the new tag to the post.
    618 									newTag.set( 'parent_post', self.get( 'id' ) );
    619 
    620 									// Add the new tag to the collection.
    621 									newTags.push( newTag );
    622 								} );
    623 								tags = new wp.api.collections.Tags( newTags );
    624 								self.setTagsWithCollection( tags );
    625 							}
    626 						} );
    627 
    628 					} else {
    629 						this.setTagsWithCollection( tags );
    630 					}
    631 				},
    632 
    633 				/**
    634 				 * Set the tags for a post.
    635 				 *
    636 				 * Accepts a Tags collection.
    637 				 *
    638 				 * @param {Array|Backbone.Collection} tags The tags to set on the post.
    639 				 *
    640 				 */
    641 				setTagsWithCollection: function( tags ) {
    642 
    643 					// Pluck out the category IDs.
    644 					this.set( 'tags', tags.pluck( 'id' ) );
    645 					return this.save();
    646 				}
    647 			},
    648 
    649 			/**
    650 			 * Add a helper function to handle post Categories.
    651 			 */
    652 			CategoriesMixin = {
    653 
    654 				/**
    655 				 * Get a the categories for a post.
    656 				 *
    657 				 * @return {Deferred.promise} promise Resolves to an array of categories.
    658 				 */
    659 				getCategories: function() {
    660 					var categoryIds = this.get( 'categories' ),
    661 						categories  = new wp.api.collections.Categories();
    662 
    663 					// Resolve with an empty array if no categories.
    664 					if ( _.isEmpty( categoryIds ) ) {
    665 						return jQuery.Deferred().resolve( [] );
    666 					}
    667 
    668 					return categories.fetch( { data: { include: categoryIds } } );
    669 				},
    670 
    671 				/**
    672 				 * Set the categories for a post.
    673 				 *
    674 				 * Accepts an array of category slugs, or a Categories collection.
    675 				 *
    676 				 * @param {Array|Backbone.Collection} categories The categories to set on the post.
    677 				 *
    678 				 */
    679 				setCategories: function( categories ) {
    680 					var allCategories, newCategory,
    681 						self = this,
    682 						newCategories = [];
    683 
    684 					if ( _.isString( categories ) ) {
    685 						return false;
    686 					}
    687 
    688 					// If this is an array of slugs, build a collection.
    689 					if ( _.isArray( categories ) ) {
    690 
    691 						// Get all the categories.
    692 						allCategories = new wp.api.collections.Categories();
    693 						allCategories.fetch( {
    694 							data:    { per_page: 100 },
    695 							success: function( allcats ) {
    696 
    697 								// Find the passed categories and set them up.
    698 								_.each( categories, function( category ) {
    699 									newCategory = new wp.api.models.Category( allcats.findWhere( { slug: category } ) );
    700 
    701 									// Tie the new category to the post.
    702 									newCategory.set( 'parent_post', self.get( 'id' ) );
    703 
    704 									// Add the new category to the collection.
    705 									newCategories.push( newCategory );
    706 								} );
    707 								categories = new wp.api.collections.Categories( newCategories );
    708 								self.setCategoriesWithCollection( categories );
    709 							}
    710 						} );
    711 
    712 					} else {
    713 						this.setCategoriesWithCollection( categories );
    714 					}
    715 
    716 				},
    717 
    718 				/**
    719 				 * Set the categories for a post.
    720 				 *
    721 				 * Accepts Categories collection.
    722 				 *
    723 				 * @param {Array|Backbone.Collection} categories The categories to set on the post.
    724 				 *
    725 				 */
    726 				setCategoriesWithCollection: function( categories ) {
    727 
    728 					// Pluck out the category IDs.
    729 					this.set( 'categories', categories.pluck( 'id' ) );
    730 					return this.save();
    731 				}
    732 			},
    733 
    734 			/**
    735 			 * Add a helper function to retrieve the author user model.
    736 			 */
    737 			AuthorMixin = {
    738 				getAuthorUser: function() {
    739 					return buildModelGetter( this, this.get( 'author' ), 'User', 'author', 'name' );
    740 				}
    741 			},
    742 
    743 			/**
    744 			 * Add a helper function to retrieve the featured media.
    745 			 */
    746 			FeaturedMediaMixin = {
    747 				getFeaturedMedia: function() {
    748 					return buildModelGetter( this, this.get( 'featured_media' ), 'Media', 'wp:featuredmedia', 'source_url' );
    749 				}
    750 			};
    751 
    752 		// Exit if we don't have valid model defaults.
    753 		if ( _.isUndefined( model.prototype.args ) ) {
    754 			return model;
    755 		}
    756 
    757 		// Go thru the parsable date fields, if our model contains any of them it gets the TimeStampedMixin.
    758 		_.each( parseableDates, function( theDateKey ) {
    759 			if ( ! _.isUndefined( model.prototype.args[ theDateKey ] ) ) {
    760 				hasDate = true;
    761 			}
    762 		} );
    763 
    764 		// Add the TimeStampedMixin for models that contain a date field.
    765 		if ( hasDate ) {
    766 			model = model.extend( TimeStampedMixin );
    767 		}
    768 
    769 		// Add the AuthorMixin for models that contain an author.
    770 		if ( ! _.isUndefined( model.prototype.args.author ) ) {
    771 			model = model.extend( AuthorMixin );
    772 		}
    773 
    774 		// Add the FeaturedMediaMixin for models that contain a featured_media.
    775 		if ( ! _.isUndefined( model.prototype.args.featured_media ) ) {
    776 			model = model.extend( FeaturedMediaMixin );
    777 		}
    778 
    779 		// Add the CategoriesMixin for models that support categories collections.
    780 		if ( ! _.isUndefined( model.prototype.args.categories ) ) {
    781 			model = model.extend( CategoriesMixin );
    782 		}
    783 
    784 		// Add the MetaMixin for models that support meta.
    785 		if ( ! _.isUndefined( model.prototype.args.meta ) ) {
    786 			model = model.extend( MetaMixin );
    787 		}
    788 
    789 		// Add the TagsMixin for models that support tags collections.
    790 		if ( ! _.isUndefined( model.prototype.args.tags ) ) {
    791 			model = model.extend( TagsMixin );
    792 		}
    793 
    794 		// Add the RevisionsMixin for models that support revisions collections.
    795 		if ( ! _.isUndefined( loadingObjects.collections[ modelClassName + 'Revisions' ] ) ) {
    796 			model = model.extend( RevisionsMixin );
    797 		}
    798 
    799 		return model;
    800 	};
    801 
    802 })( window );
    803 
    804 /* global wpApiSettings:false */
    805 
    806 // Suppress warning about parse function's unused "options" argument:
    807 /* jshint unused:false */
    808 (function() {
    809 
    810 	'use strict';
    811 
    812 	var wpApiSettings = window.wpApiSettings || {},
    813 	trashableTypes    = [ 'Comment', 'Media', 'Comment', 'Post', 'Page', 'Status', 'Taxonomy', 'Type' ];
    814 
    815 	/**
    816 	 * Backbone base model for all models.
    817 	 */
    818 	wp.api.WPApiBaseModel = Backbone.Model.extend(
    819 		/** @lends WPApiBaseModel.prototype  */
    820 		{
    821 
    822 			// Initialize the model.
    823 			initialize: function() {
    824 
    825 				/**
    826 				* Types that don't support trashing require passing ?force=true to delete.
    827 				*
    828 				*/
    829 				if ( -1 === _.indexOf( trashableTypes, this.name ) ) {
    830 					this.requireForceForDelete = true;
    831 				}
    832 			},
    833 
    834 			/**
    835 			 * Set nonce header before every Backbone sync.
    836 			 *
    837 			 * @param {string} method.
    838 			 * @param {Backbone.Model} model.
    839 			 * @param {{beforeSend}, *} options.
    840 			 * @return {*}.
    841 			 */
    842 			sync: function( method, model, options ) {
    843 				var beforeSend;
    844 
    845 				options = options || {};
    846 
    847 				// Remove date_gmt if null.
    848 				if ( _.isNull( model.get( 'date_gmt' ) ) ) {
    849 					model.unset( 'date_gmt' );
    850 				}
    851 
    852 				// Remove slug if empty.
    853 				if ( _.isEmpty( model.get( 'slug' ) ) ) {
    854 					model.unset( 'slug' );
    855 				}
    856 
    857 				if ( _.isFunction( model.nonce ) && ! _.isEmpty( model.nonce() ) ) {
    858 					beforeSend = options.beforeSend;
    859 
    860 					// @todo Enable option for jsonp endpoints.
    861 					// options.dataType = 'jsonp';
    862 
    863 					// Include the nonce with requests.
    864 					options.beforeSend = function( xhr ) {
    865 						xhr.setRequestHeader( 'X-WP-Nonce', model.nonce() );
    866 
    867 						if ( beforeSend ) {
    868 							return beforeSend.apply( this, arguments );
    869 						}
    870 					};
    871 
    872 					// Update the nonce when a new nonce is returned with the response.
    873 					options.complete = function( xhr ) {
    874 						var returnedNonce = xhr.getResponseHeader( 'X-WP-Nonce' );
    875 
    876 						if ( returnedNonce && _.isFunction( model.nonce ) && model.nonce() !== returnedNonce ) {
    877 							model.endpointModel.set( 'nonce', returnedNonce );
    878 						}
    879 					};
    880 				}
    881 
    882 				// Add '?force=true' to use delete method when required.
    883 				if ( this.requireForceForDelete && 'delete' === method ) {
    884 					model.url = model.url() + '?force=true';
    885 				}
    886 				return Backbone.sync( method, model, options );
    887 			},
    888 
    889 			/**
    890 			 * Save is only allowed when the PUT OR POST methods are available for the endpoint.
    891 			 */
    892 			save: function( attrs, options ) {
    893 
    894 				// Do we have the put method, then execute the save.
    895 				if ( _.includes( this.methods, 'PUT' ) || _.includes( this.methods, 'POST' ) ) {
    896 
    897 					// Proxy the call to the original save function.
    898 					return Backbone.Model.prototype.save.call( this, attrs, options );
    899 				} else {
    900 
    901 					// Otherwise bail, disallowing action.
    902 					return false;
    903 				}
    904 			},
    905 
    906 			/**
    907 			 * Delete is only allowed when the DELETE method is available for the endpoint.
    908 			 */
    909 			destroy: function( options ) {
    910 
    911 				// Do we have the DELETE method, then execute the destroy.
    912 				if ( _.includes( this.methods, 'DELETE' ) ) {
    913 
    914 					// Proxy the call to the original save function.
    915 					return Backbone.Model.prototype.destroy.call( this, options );
    916 				} else {
    917 
    918 					// Otherwise bail, disallowing action.
    919 					return false;
    920 				}
    921 			}
    922 
    923 		}
    924 	);
    925 
    926 	/**
    927 	 * API Schema model. Contains meta information about the API.
    928 	 */
    929 	wp.api.models.Schema = wp.api.WPApiBaseModel.extend(
    930 		/** @lends Schema.prototype  */
    931 		{
    932 			defaults: {
    933 				_links: {},
    934 				namespace: null,
    935 				routes: {}
    936 			},
    937 
    938 			initialize: function( attributes, options ) {
    939 				var model = this;
    940 				options = options || {};
    941 
    942 				wp.api.WPApiBaseModel.prototype.initialize.call( model, attributes, options );
    943 
    944 				model.apiRoot = options.apiRoot || wpApiSettings.root;
    945 				model.versionString = options.versionString || wpApiSettings.versionString;
    946 			},
    947 
    948 			url: function() {
    949 				return this.apiRoot + this.versionString;
    950 			}
    951 		}
    952 	);
    953 })();
    954 
    955 ( function() {
    956 
    957 	'use strict';
    958 
    959 	var wpApiSettings = window.wpApiSettings || {};
    960 
    961 	/**
    962 	 * Contains basic collection functionality such as pagination.
    963 	 */
    964 	wp.api.WPApiBaseCollection = Backbone.Collection.extend(
    965 		/** @lends BaseCollection.prototype  */
    966 		{
    967 
    968 			/**
    969 			 * Setup default state.
    970 			 */
    971 			initialize: function( models, options ) {
    972 				this.state = {
    973 					data: {},
    974 					currentPage: null,
    975 					totalPages: null,
    976 					totalObjects: null
    977 				};
    978 				if ( _.isUndefined( options ) ) {
    979 					this.parent = '';
    980 				} else {
    981 					this.parent = options.parent;
    982 				}
    983 			},
    984 
    985 			/**
    986 			 * Extend Backbone.Collection.sync to add nince and pagination support.
    987 			 *
    988 			 * Set nonce header before every Backbone sync.
    989 			 *
    990 			 * @param {string} method.
    991 			 * @param {Backbone.Model} model.
    992 			 * @param {{success}, *} options.
    993 			 * @return {*}.
    994 			 */
    995 			sync: function( method, model, options ) {
    996 				var beforeSend, success,
    997 					self = this;
    998 
    999 				options = options || {};
   1000 
   1001 				if ( _.isFunction( model.nonce ) && ! _.isEmpty( model.nonce() ) ) {
   1002 					beforeSend = options.beforeSend;
   1003 
   1004 					// Include the nonce with requests.
   1005 					options.beforeSend = function( xhr ) {
   1006 						xhr.setRequestHeader( 'X-WP-Nonce', model.nonce() );
   1007 
   1008 						if ( beforeSend ) {
   1009 							return beforeSend.apply( self, arguments );
   1010 						}
   1011 					};
   1012 
   1013 					// Update the nonce when a new nonce is returned with the response.
   1014 					options.complete = function( xhr ) {
   1015 						var returnedNonce = xhr.getResponseHeader( 'X-WP-Nonce' );
   1016 
   1017 						if ( returnedNonce && _.isFunction( model.nonce ) && model.nonce() !== returnedNonce ) {
   1018 							model.endpointModel.set( 'nonce', returnedNonce );
   1019 						}
   1020 					};
   1021 				}
   1022 
   1023 				// When reading, add pagination data.
   1024 				if ( 'read' === method ) {
   1025 					if ( options.data ) {
   1026 						self.state.data = _.clone( options.data );
   1027 
   1028 						delete self.state.data.page;
   1029 					} else {
   1030 						self.state.data = options.data = {};
   1031 					}
   1032 
   1033 					if ( 'undefined' === typeof options.data.page ) {
   1034 						self.state.currentPage  = null;
   1035 						self.state.totalPages   = null;
   1036 						self.state.totalObjects = null;
   1037 					} else {
   1038 						self.state.currentPage = options.data.page - 1;
   1039 					}
   1040 
   1041 					success = options.success;
   1042 					options.success = function( data, textStatus, request ) {
   1043 						if ( ! _.isUndefined( request ) ) {
   1044 							self.state.totalPages   = parseInt( request.getResponseHeader( 'x-wp-totalpages' ), 10 );
   1045 							self.state.totalObjects = parseInt( request.getResponseHeader( 'x-wp-total' ), 10 );
   1046 						}
   1047 
   1048 						if ( null === self.state.currentPage ) {
   1049 							self.state.currentPage = 1;
   1050 						} else {
   1051 							self.state.currentPage++;
   1052 						}
   1053 
   1054 						if ( success ) {
   1055 							return success.apply( this, arguments );
   1056 						}
   1057 					};
   1058 				}
   1059 
   1060 				// Continue by calling Backbone's sync.
   1061 				return Backbone.sync( method, model, options );
   1062 			},
   1063 
   1064 			/**
   1065 			 * Fetches the next page of objects if a new page exists.
   1066 			 *
   1067 			 * @param {data: {page}} options.
   1068 			 * @return {*}.
   1069 			 */
   1070 			more: function( options ) {
   1071 				options = options || {};
   1072 				options.data = options.data || {};
   1073 
   1074 				_.extend( options.data, this.state.data );
   1075 
   1076 				if ( 'undefined' === typeof options.data.page ) {
   1077 					if ( ! this.hasMore() ) {
   1078 						return false;
   1079 					}
   1080 
   1081 					if ( null === this.state.currentPage || this.state.currentPage <= 1 ) {
   1082 						options.data.page = 2;
   1083 					} else {
   1084 						options.data.page = this.state.currentPage + 1;
   1085 					}
   1086 				}
   1087 
   1088 				return this.fetch( options );
   1089 			},
   1090 
   1091 			/**
   1092 			 * Returns true if there are more pages of objects available.
   1093 			 *
   1094 			 * @return {null|boolean}
   1095 			 */
   1096 			hasMore: function() {
   1097 				if ( null === this.state.totalPages ||
   1098 					 null === this.state.totalObjects ||
   1099 					 null === this.state.currentPage ) {
   1100 					return null;
   1101 				} else {
   1102 					return ( this.state.currentPage < this.state.totalPages );
   1103 				}
   1104 			}
   1105 		}
   1106 	);
   1107 
   1108 } )();
   1109 
   1110 ( function() {
   1111 
   1112 	'use strict';
   1113 
   1114 	var Endpoint, initializedDeferreds = {},
   1115 		wpApiSettings = window.wpApiSettings || {};
   1116 
   1117 	/** @namespace wp */
   1118 	window.wp = window.wp || {};
   1119 
   1120 	/** @namespace wp.api */
   1121 	wp.api    = wp.api || {};
   1122 
   1123 	// If wpApiSettings is unavailable, try the default.
   1124 	if ( _.isEmpty( wpApiSettings ) ) {
   1125 		wpApiSettings.root = window.location.origin + '/wp-json/';
   1126 	}
   1127 
   1128 	Endpoint = Backbone.Model.extend(/** @lends Endpoint.prototype */{
   1129 		defaults: {
   1130 			apiRoot: wpApiSettings.root,
   1131 			versionString: wp.api.versionString,
   1132 			nonce: null,
   1133 			schema: null,
   1134 			models: {},
   1135 			collections: {}
   1136 		},
   1137 
   1138 		/**
   1139 		 * Initialize the Endpoint model.
   1140 		 */
   1141 		initialize: function() {
   1142 			var model = this, deferred;
   1143 
   1144 			Backbone.Model.prototype.initialize.apply( model, arguments );
   1145 
   1146 			deferred = jQuery.Deferred();
   1147 			model.schemaConstructed = deferred.promise();
   1148 
   1149 			model.schemaModel = new wp.api.models.Schema( null, {
   1150 				apiRoot:       model.get( 'apiRoot' ),
   1151 				versionString: model.get( 'versionString' ),
   1152 				nonce:         model.get( 'nonce' )
   1153 			} );
   1154 
   1155 			// When the model loads, resolve the promise.
   1156 			model.schemaModel.once( 'change', function() {
   1157 				model.constructFromSchema();
   1158 				deferred.resolve( model );
   1159 			} );
   1160 
   1161 			if ( model.get( 'schema' ) ) {
   1162 
   1163 				// Use schema supplied as model attribute.
   1164 				model.schemaModel.set( model.schemaModel.parse( model.get( 'schema' ) ) );
   1165 			} else if (
   1166 				! _.isUndefined( sessionStorage ) &&
   1167 				( _.isUndefined( wpApiSettings.cacheSchema ) || wpApiSettings.cacheSchema ) &&
   1168 				sessionStorage.getItem( 'wp-api-schema-model' + model.get( 'apiRoot' ) + model.get( 'versionString' ) )
   1169 			) {
   1170 
   1171 				// Used a cached copy of the schema model if available.
   1172 				model.schemaModel.set( model.schemaModel.parse( JSON.parse( sessionStorage.getItem( 'wp-api-schema-model' + model.get( 'apiRoot' ) + model.get( 'versionString' ) ) ) ) );
   1173 			} else {
   1174 				model.schemaModel.fetch( {
   1175 					/**
   1176 					 * When the server returns the schema model data, store the data in a sessionCache so we don't
   1177 					 * have to retrieve it again for this session. Then, construct the models and collections based
   1178 					 * on the schema model data.
   1179 					 *
   1180 					 * @ignore
   1181 					 */
   1182 					success: function( newSchemaModel ) {
   1183 
   1184 						// Store a copy of the schema model in the session cache if available.
   1185 						if ( ! _.isUndefined( sessionStorage ) && ( _.isUndefined( wpApiSettings.cacheSchema ) || wpApiSettings.cacheSchema ) ) {
   1186 							try {
   1187 								sessionStorage.setItem( 'wp-api-schema-model' + model.get( 'apiRoot' ) + model.get( 'versionString' ), JSON.stringify( newSchemaModel ) );
   1188 							} catch ( error ) {
   1189 
   1190 								// Fail silently, fixes errors in safari private mode.
   1191 							}
   1192 						}
   1193 					},
   1194 
   1195 					// Log the error condition.
   1196 					error: function( err ) {
   1197 						window.console.log( err );
   1198 					}
   1199 				} );
   1200 			}
   1201 		},
   1202 
   1203 		constructFromSchema: function() {
   1204 			var routeModel = this, modelRoutes, collectionRoutes, schemaRoot, loadingObjects,
   1205 
   1206 			/**
   1207 			 * Set up the model and collection name mapping options. As the schema is built, the
   1208 			 * model and collection names will be adjusted if they are found in the mapping object.
   1209 			 *
   1210 			 * Localizing a variable wpApiSettings.mapping will over-ride the default mapping options.
   1211 			 *
   1212 			 */
   1213 			mapping = wpApiSettings.mapping || {
   1214 				models: {
   1215 					'Categories':      'Category',
   1216 					'Comments':        'Comment',
   1217 					'Pages':           'Page',
   1218 					'PagesMeta':       'PageMeta',
   1219 					'PagesRevisions':  'PageRevision',
   1220 					'Posts':           'Post',
   1221 					'PostsCategories': 'PostCategory',
   1222 					'PostsRevisions':  'PostRevision',
   1223 					'PostsTags':       'PostTag',
   1224 					'Schema':          'Schema',
   1225 					'Statuses':        'Status',
   1226 					'Tags':            'Tag',
   1227 					'Taxonomies':      'Taxonomy',
   1228 					'Types':           'Type',
   1229 					'Users':           'User'
   1230 				},
   1231 				collections: {
   1232 					'PagesMeta':       'PageMeta',
   1233 					'PagesRevisions':  'PageRevisions',
   1234 					'PostsCategories': 'PostCategories',
   1235 					'PostsMeta':       'PostMeta',
   1236 					'PostsRevisions':  'PostRevisions',
   1237 					'PostsTags':       'PostTags'
   1238 				}
   1239 			},
   1240 
   1241 			modelEndpoints = routeModel.get( 'modelEndpoints' ),
   1242 			modelRegex     = new RegExp( '(?:.*[+)]|\/(' + modelEndpoints.join( '|' ) + '))$' );
   1243 
   1244 			/**
   1245 			 * Iterate thru the routes, picking up models and collections to build. Builds two arrays,
   1246 			 * one for models and one for collections.
   1247 			 */
   1248 			modelRoutes      = [];
   1249 			collectionRoutes = [];
   1250 			schemaRoot       = routeModel.get( 'apiRoot' ).replace( wp.api.utils.getRootUrl(), '' );
   1251 			loadingObjects   = {};
   1252 
   1253 			/**
   1254 			 * Tracking objects for models and collections.
   1255 			 */
   1256 			loadingObjects.models      = {};
   1257 			loadingObjects.collections = {};
   1258 
   1259 			_.each( routeModel.schemaModel.get( 'routes' ), function( route, index ) {
   1260 
   1261 				// Skip the schema root if included in the schema.
   1262 				if ( index !== routeModel.get( ' versionString' ) &&
   1263 						index !== schemaRoot &&
   1264 						index !== ( '/' + routeModel.get( 'versionString' ).slice( 0, -1 ) )
   1265 				) {
   1266 
   1267 					// Single items end with a regex, or a special case word.
   1268 					if ( modelRegex.test( index ) ) {
   1269 						modelRoutes.push( { index: index, route: route } );
   1270 					} else {
   1271 
   1272 						// Collections end in a name.
   1273 						collectionRoutes.push( { index: index, route: route } );
   1274 					}
   1275 				}
   1276 			} );
   1277 
   1278 			/**
   1279 			 * Construct the models.
   1280 			 *
   1281 			 * Base the class name on the route endpoint.
   1282 			 */
   1283 			_.each( modelRoutes, function( modelRoute ) {
   1284 
   1285 				// Extract the name and any parent from the route.
   1286 				var modelClassName,
   1287 					routeName  = wp.api.utils.extractRoutePart( modelRoute.index, 2, routeModel.get( 'versionString' ), true ),
   1288 					parentName = wp.api.utils.extractRoutePart( modelRoute.index, 1, routeModel.get( 'versionString' ), false ),
   1289 					routeEnd   = wp.api.utils.extractRoutePart( modelRoute.index, 1, routeModel.get( 'versionString' ), true );
   1290 
   1291 				// Clear the parent part of the rouite if its actually the version string.
   1292 				if ( parentName === routeModel.get( 'versionString' ) ) {
   1293 					parentName = '';
   1294 				}
   1295 
   1296 				// Handle the special case of the 'me' route.
   1297 				if ( 'me' === routeEnd ) {
   1298 					routeName = 'me';
   1299 				}
   1300 
   1301 				// If the model has a parent in its route, add that to its class name.
   1302 				if ( '' !== parentName && parentName !== routeName ) {
   1303 					modelClassName = wp.api.utils.capitalizeAndCamelCaseDashes( parentName ) + wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
   1304 					modelClassName = mapping.models[ modelClassName ] || modelClassName;
   1305 					loadingObjects.models[ modelClassName ] = wp.api.WPApiBaseModel.extend( {
   1306 
   1307 						// Return a constructed url based on the parent and id.
   1308 						url: function() {
   1309 							var url =
   1310 								routeModel.get( 'apiRoot' ) +
   1311 								routeModel.get( 'versionString' ) +
   1312 								parentName +  '/' +
   1313 									( ( _.isUndefined( this.get( 'parent' ) ) || 0 === this.get( 'parent' ) ) ?
   1314 										( _.isUndefined( this.get( 'parent_post' ) ) ? '' : this.get( 'parent_post' ) + '/' ) :
   1315 										this.get( 'parent' ) + '/' ) +
   1316 								routeName;
   1317 
   1318 							if ( ! _.isUndefined( this.get( 'id' ) ) ) {
   1319 								url +=  '/' + this.get( 'id' );
   1320 							}
   1321 							return url;
   1322 						},
   1323 
   1324 						// Track nonces on the Endpoint 'routeModel'.
   1325 						nonce: function() {
   1326 							return routeModel.get( 'nonce' );
   1327 						},
   1328 
   1329 						endpointModel: routeModel,
   1330 
   1331 						// Include a reference to the original route object.
   1332 						route: modelRoute,
   1333 
   1334 						// Include a reference to the original class name.
   1335 						name: modelClassName,
   1336 
   1337 						// Include the array of route methods for easy reference.
   1338 						methods: modelRoute.route.methods,
   1339 
   1340 						// Include the array of route endpoints for easy reference.
   1341 						endpoints: modelRoute.route.endpoints
   1342 					} );
   1343 				} else {
   1344 
   1345 					// This is a model without a parent in its route.
   1346 					modelClassName = wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
   1347 					modelClassName = mapping.models[ modelClassName ] || modelClassName;
   1348 					loadingObjects.models[ modelClassName ] = wp.api.WPApiBaseModel.extend( {
   1349 
   1350 						// Function that returns a constructed url based on the ID.
   1351 						url: function() {
   1352 							var url = routeModel.get( 'apiRoot' ) +
   1353 								routeModel.get( 'versionString' ) +
   1354 								( ( 'me' === routeName ) ? 'users/me' : routeName );
   1355 
   1356 							if ( ! _.isUndefined( this.get( 'id' ) ) ) {
   1357 								url +=  '/' + this.get( 'id' );
   1358 							}
   1359 							return url;
   1360 						},
   1361 
   1362 						// Track nonces at the Endpoint level.
   1363 						nonce: function() {
   1364 							return routeModel.get( 'nonce' );
   1365 						},
   1366 
   1367 						endpointModel: routeModel,
   1368 
   1369 						// Include a reference to the original route object.
   1370 						route: modelRoute,
   1371 
   1372 						// Include a reference to the original class name.
   1373 						name: modelClassName,
   1374 
   1375 						// Include the array of route methods for easy reference.
   1376 						methods: modelRoute.route.methods,
   1377 
   1378 						// Include the array of route endpoints for easy reference.
   1379 						endpoints: modelRoute.route.endpoints
   1380 					} );
   1381 				}
   1382 
   1383 				// Add defaults to the new model, pulled form the endpoint.
   1384 				wp.api.utils.decorateFromRoute(
   1385 					modelRoute.route.endpoints,
   1386 					loadingObjects.models[ modelClassName ],
   1387 					routeModel.get( 'versionString' )
   1388 				);
   1389 
   1390 			} );
   1391 
   1392 			/**
   1393 			 * Construct the collections.
   1394 			 *
   1395 			 * Base the class name on the route endpoint.
   1396 			 */
   1397 			_.each( collectionRoutes, function( collectionRoute ) {
   1398 
   1399 				// Extract the name and any parent from the route.
   1400 				var collectionClassName, modelClassName,
   1401 						routeName  = collectionRoute.index.slice( collectionRoute.index.lastIndexOf( '/' ) + 1 ),
   1402 						parentName = wp.api.utils.extractRoutePart( collectionRoute.index, 1, routeModel.get( 'versionString' ), false );
   1403 
   1404 				// If the collection has a parent in its route, add that to its class name.
   1405 				if ( '' !== parentName && parentName !== routeName && routeModel.get( 'versionString' ) !== parentName ) {
   1406 
   1407 					collectionClassName = wp.api.utils.capitalizeAndCamelCaseDashes( parentName ) + wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
   1408 					modelClassName      = mapping.models[ collectionClassName ] || collectionClassName;
   1409 					collectionClassName = mapping.collections[ collectionClassName ] || collectionClassName;
   1410 					loadingObjects.collections[ collectionClassName ] = wp.api.WPApiBaseCollection.extend( {
   1411 
   1412 						// Function that returns a constructed url passed on the parent.
   1413 						url: function() {
   1414 							return routeModel.get( 'apiRoot' ) + routeModel.get( 'versionString' ) +
   1415 								parentName + '/' +
   1416 								( ( _.isUndefined( this.parent ) || '' === this.parent ) ?
   1417 									( _.isUndefined( this.get( 'parent_post' ) ) ? '' : this.get( 'parent_post' ) + '/' ) :
   1418 									this.parent + '/' ) +
   1419 								routeName;
   1420 						},
   1421 
   1422 						// Specify the model that this collection contains.
   1423 						model: function( attrs, options ) {
   1424 							return new loadingObjects.models[ modelClassName ]( attrs, options );
   1425 						},
   1426 
   1427 						// Track nonces at the Endpoint level.
   1428 						nonce: function() {
   1429 							return routeModel.get( 'nonce' );
   1430 						},
   1431 
   1432 						endpointModel: routeModel,
   1433 
   1434 						// Include a reference to the original class name.
   1435 						name: collectionClassName,
   1436 
   1437 						// Include a reference to the original route object.
   1438 						route: collectionRoute,
   1439 
   1440 						// Include the array of route methods for easy reference.
   1441 						methods: collectionRoute.route.methods
   1442 					} );
   1443 				} else {
   1444 
   1445 					// This is a collection without a parent in its route.
   1446 					collectionClassName = wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
   1447 					modelClassName      = mapping.models[ collectionClassName ] || collectionClassName;
   1448 					collectionClassName = mapping.collections[ collectionClassName ] || collectionClassName;
   1449 					loadingObjects.collections[ collectionClassName ] = wp.api.WPApiBaseCollection.extend( {
   1450 
   1451 						// For the url of a root level collection, use a string.
   1452 						url: function() {
   1453 							return routeModel.get( 'apiRoot' ) + routeModel.get( 'versionString' ) + routeName;
   1454 						},
   1455 
   1456 						// Specify the model that this collection contains.
   1457 						model: function( attrs, options ) {
   1458 							return new loadingObjects.models[ modelClassName ]( attrs, options );
   1459 						},
   1460 
   1461 						// Track nonces at the Endpoint level.
   1462 						nonce: function() {
   1463 							return routeModel.get( 'nonce' );
   1464 						},
   1465 
   1466 						endpointModel: routeModel,
   1467 
   1468 						// Include a reference to the original class name.
   1469 						name: collectionClassName,
   1470 
   1471 						// Include a reference to the original route object.
   1472 						route: collectionRoute,
   1473 
   1474 						// Include the array of route methods for easy reference.
   1475 						methods: collectionRoute.route.methods
   1476 					} );
   1477 				}
   1478 
   1479 				// Add defaults to the new model, pulled form the endpoint.
   1480 				wp.api.utils.decorateFromRoute( collectionRoute.route.endpoints, loadingObjects.collections[ collectionClassName ] );
   1481 			} );
   1482 
   1483 			// Add mixins and helpers for each of the models.
   1484 			_.each( loadingObjects.models, function( model, index ) {
   1485 				loadingObjects.models[ index ] = wp.api.utils.addMixinsAndHelpers( model, index, loadingObjects );
   1486 			} );
   1487 
   1488 			// Set the routeModel models and collections.
   1489 			routeModel.set( 'models', loadingObjects.models );
   1490 			routeModel.set( 'collections', loadingObjects.collections );
   1491 
   1492 		}
   1493 
   1494 	} );
   1495 
   1496 	wp.api.endpoints = new Backbone.Collection();
   1497 
   1498 	/**
   1499 	 * Initialize the wp-api, optionally passing the API root.
   1500 	 *
   1501 	 * @param {Object} [args]
   1502 	 * @param {string} [args.nonce] The nonce. Optional, defaults to wpApiSettings.nonce.
   1503 	 * @param {string} [args.apiRoot] The api root. Optional, defaults to wpApiSettings.root.
   1504 	 * @param {string} [args.versionString] The version string. Optional, defaults to wpApiSettings.root.
   1505 	 * @param {Object} [args.schema] The schema. Optional, will be fetched from API if not provided.
   1506 	 */
   1507 	wp.api.init = function( args ) {
   1508 		var endpoint, attributes = {}, deferred, promise;
   1509 
   1510 		args                      = args || {};
   1511 		attributes.nonce          = _.isString( args.nonce ) ? args.nonce : ( wpApiSettings.nonce || '' );
   1512 		attributes.apiRoot        = args.apiRoot || wpApiSettings.root || '/wp-json';
   1513 		attributes.versionString  = args.versionString || wpApiSettings.versionString || 'wp/v2/';
   1514 		attributes.schema         = args.schema || null;
   1515 		attributes.modelEndpoints = args.modelEndpoints || [ 'me', 'settings' ];
   1516 		if ( ! attributes.schema && attributes.apiRoot === wpApiSettings.root && attributes.versionString === wpApiSettings.versionString ) {
   1517 			attributes.schema = wpApiSettings.schema;
   1518 		}
   1519 
   1520 		if ( ! initializedDeferreds[ attributes.apiRoot + attributes.versionString ] ) {
   1521 
   1522 			// Look for an existing copy of this endpoint.
   1523 			endpoint = wp.api.endpoints.findWhere( { 'apiRoot': attributes.apiRoot, 'versionString': attributes.versionString } );
   1524 			if ( ! endpoint ) {
   1525 				endpoint = new Endpoint( attributes );
   1526 			}
   1527 			deferred = jQuery.Deferred();
   1528 			promise = deferred.promise();
   1529 
   1530 			endpoint.schemaConstructed.done( function( resolvedEndpoint ) {
   1531 				wp.api.endpoints.add( resolvedEndpoint );
   1532 
   1533 				// Map the default endpoints, extending any already present items (including Schema model).
   1534 				wp.api.models      = _.extend( wp.api.models, resolvedEndpoint.get( 'models' ) );
   1535 				wp.api.collections = _.extend( wp.api.collections, resolvedEndpoint.get( 'collections' ) );
   1536 				deferred.resolve( resolvedEndpoint );
   1537 			} );
   1538 			initializedDeferreds[ attributes.apiRoot + attributes.versionString ] = promise;
   1539 		}
   1540 		return initializedDeferreds[ attributes.apiRoot + attributes.versionString ];
   1541 	};
   1542 
   1543 	/**
   1544 	 * Construct the default endpoints and add to an endpoints collection.
   1545 	 */
   1546 
   1547 	// The wp.api.init function returns a promise that will resolve with the endpoint once it is ready.
   1548 	wp.api.loadPromise = wp.api.init();
   1549 
   1550 } )();