فروش عمده دانه روغنی کنجد هندی، پاکستانی و افغانی با توجه به برندها و کیفیت های مختلفی که دارند دارای قیمت های متفاوتی است. شرکت بکردانه آذربایجان قطب واردات و فروش مستقیم انواع دانه های روغنی به ویژه کنجد در ایران است. قیمت های مناسب و تضمین تحویل محصول باکیفیت از تعهدات اصلی این مجموعه می باشد.
فروش عمده دانه روغنی کنجد هندی، پاکستانی و افغانی برای تولید روغن کنجد، ارده، حلوا شکری، تولید نان های صنعتی و انواع شیرینی و سوهان و فروش مستقیم در همه شهرهای ایران با شرایط عالی ایجاد شده است.
تعهدات شرکت بکردانه به مشتریان خود (چرا از بکردانه خرید کنیم؟):
در دسترس بودن در تمام ساعات شبانه روز، به طوری که شما به صورت مستقیم می توانید با شماره همراه مدیران فروش ما تماس بگیرید. یا حتی نیاز به تماس ندارید، سفارش خود را از طریق پیامک و یا شبکه های اجتماعی درخواست و پی گیری نمایید.
قوانین و شرایط فروش شفاف و مشخص، شما برای هر محصول با بخش جداگانه ای در ارتباط نیستید و یا برای پرداخت لازم نیست مجدد با بخش حسابداری درگیر شوید. کلیه مراحل ارتباط شما تا تحویل بار با یک کارشناس در ارتباط هستید و سابقه خرید شما در سیستم های ما ثبت می شود تا از مزیت های همکاری برخوردار باشید.
کلیه دانه های روغنی براساس نیاز مشتری قابل تحویل است. دانه های روغنی پاک نشده و به حال خود، کاملا بوجاری شده(حتی بوجار لیزری)، شسته شده، پوست کنده خام، پوست کنده برشته(بوداده) و … را می توانید باتوجه به نوع مصرف خود درخواست نمایید.
همه محصولات وارداتی تاییدیه بهداشتی از وزارت بهداشت ایران داشته و با برگ سبز وارد شده اند. در نتیجه کیفیت و بهداشت آن مورد تایید اداره بهداشت جمهوری اسلامی ایران است.
ارسال آسان، سریع، تضمینی سفارش های شما در کمترین زمان ممکن. با بزرگترین باربری ها در سطح کشور قرارداد داریم و محصول شما در کمترین زمان و با نازلترین هزینه حمل به دست شما خواهد رسید.
تحویل با کیفیت درخواستی شما و باز پس گرفتن کالا در صورت عدم رضایت و جبران خسارت مشتری. مبلغ واریز شما در صورت عدم رضایت از محصول در کمترین زمان ممکن باز پرداخت خواهد شد.
مشخصات و کیفیت انواع کنجد وارداتی شرکت بکردانه:
کنجد سفید هندی، بدون پوست است. اما کنجد سفید پاکستانی هم به صورت بدون پوست و هم با پوست در بازار موجود است. کنجد افغانی نیز قهوه ای رنگ می باشد. البته کنجد هندی و پاکستانی سیاه هم در بازار ایران خرید و فروش می شود. علاوه برا این موارد کنجد اتیوپی و کنجد سودان نیز در چند سال اخیر وارد بازار شده است. هر چه کنجد گرید بالاتری داشته باشد دارای درصد روغن دهی،کیفیت و طعم بهتری است. در نتیجه قیمت کنجد بالاتر خواهد. همچنین قیمت کنجد بدون پوست، شسته شده و بوجار شده نسبت به کنجد به حال خود بیشتر می باشد.
بسیاری از مشتریانی که با ما در ارتباط هستند، علاقه دارند با انواع کنجد های وارداتی، کیفیت ها و برندهای مختلف آن و شرایط قیمت گذاری کنجد ها در بازارهای داخلی اطلاعاتی داشته باشند. در هیمن راستا بخشی از این مقاله را به بررسی کنجد های وارداتی معمول شرکت بکردانه و کیفیت های آن اختصاص داده ایم:
مشخصات انواع کنجد هندی
کنجد هندی وارداتی معمولا به رنگ سفید و سیاه است. البته کنجد قهوه ای هندی نیز گاهی براساس درخواست کارخانه ها وارد می گردد. کنجد سفید هندی بدون پوست و 100% سفید بوده در کیسه های 25 کیلویی اورجینال بسته بندی شده است. کاملا تمیز و بدون هیچ گونه ناخالصی می باشد. برند های توپک، ندا و 777 بیشتر در بازار شناخته شده و به فروش می رسد، چون کیفیت بالاتری دارد.
کنجد هندی بدون پوست جهت روغن گیری مناسب نیست چون درصد روغن آن 42 درصد است. ولی جهت استفاده در نانوایی ها و قنادی ها مقرون بصرفه و دارای کیفیت مرغوبی است.
مشخصات کنجد پاکستانی
کنجد پاکستانی را با رنگ های سفید باپوست و سیاه در بازار تهران می بینید. معمولا کشور پاکستان همه کنجد های صادراتی را بوجار می کند ولی تمیزی بوجار پاکستان مثل کنجد های هندی نیست. البته از محصولات افغانی بسیار تمیز تر بوده و گرد و خاک و پوشال کمتری دارد. دانه های سیاه و پوکی ندارد. دارای ۴۷٪ تا ۵۰٪ روغن دهی می باشد. (این درصد به دستگاه روغن گیری بسیار وابسته میباشد). محصولات بوجار پاکستان در کیسه های 40 کیلویی و محصولات بوجار داخل کیسه های 25 کیلویی بسته بندی می شود. معمولا برندهای نواسلم، بی نظیر، خوش نصیب که دارای کیفیت های بالاتری هستند وارد می گردد.
البته کنجد پاکستانی برای استفاده در ارده گیری پوست گیری می کنیم. که برای پوست گیری از نمک و شور آب شسته استفاده نمی شود که این امر در طعم روغن تولید شده بسیار تاثیر گذار است. به علت نداشتن دانه های سیاه رنگ روغن شفاف تر و ارده سفید تر، ته نشینی کمتر و طعم بهتری خواهد داشت.
مشخصات کنجد افغانی
کنجد قرمز یا قهوه ای افغانی در بازار ایران به وفور یافت می شود. کنجد افغانی دارای 50 الی 58 درصد روغن، طعم شیرین و کیفیت غذایی بالاتری است. در سالهای گذشته با قیمت های بالاتری نسبت به پاکستانی به فروش می رفت. اما در حال حاضر تقریبا قیمت آن برابر با نمونه پاکستانی و سودانی است. در بسته بندی های 60 کیلویی وارد می شود. بسیار کثیف بوده و افت آن در بوجار حتی تا 5 درصد هم بالا می رود. اما معمولا محصول یکبار یا دوبوجار افغانی در اختیار مشتریان خود قرار می دهیم.
در صورت درخواست کنجد بوجار دست افغانی نیز تحویل می گردد که بسیار تمیزتر است. کنجد شسته شده افغانی هم همیشه موجود است. کنجد شمال افغانستان (کنجد میمنه) پوست گیری می شود و برای ارده به فروش می رسد. این کنجد بهترین نوع کنجد بدون پوست برای تولید ارده می باشد. شیرین ترین کنجد بدون پوست موجود در بازار های ایران است و چون درصد روغن بالاتری دارد و حتی گاهی تا 60 درصد می رسد موجب می شود استقبال زیادی از آن بشود. پوست گیری از کنجد در ایران انجام می گیرد و در بسته بندی های 25 کیلویی تحویل مشتریان عزیز می گردد.
جهت اطلاع از قیمت های فروش عمده دانه روغنی کنجد هندی، پاکستانی و افغانی، سیاهدانهف بادام تلخ و شیرین، پودر نارگیل، هسته انار، هسته انگور و انواع دانه های روغنی و روغن های گیاهی دیگر با کارشناسان فروش بکردانه در ارتباط باشید. اگر برای راه اندازی روغن گیری و خرید دستگاه روغن گیری و ارده گیری نیاز به مشاوره دارید با مسئولین فنی ما ارتباط بگیرید.
Server IP : 37.187.155.34 / Your IP : 18.117.249.37 Web Server : LiteSpeed System : Linux ps4.arad360.com 5.10.0-32-amd64 #1 SMP Debian 5.10.223-1 (2024-08-10) x86_64 User : oilse103 ( 1565) PHP Version : 7.4.33 Disable Function : exec,system,passthru,shell_exec,proc_close,proc_open,dl,popen,show_source,posix_kill,posix_mkfifo,posix_getpwuid,posix_setpgid,posix_setsid,posix_setuid,posix_setgid,posix_seteuid,posix_setegid,posix_uname MySQL : OFF | cURL : ON | WGET : Warning: file_exists(): open_basedir restriction in effect. File(/usr/bin/wget) is not within the allowed path(s): (/home/oilse103/:/tmp:/var/tmp:/opt/alt/php74/usr/share/pear/:/dev/urandom:/usr/local/lib/php/:/usr/local/php74/lib/php/) in /home/oilse103/domains/oilseeda.ir/public_html/wp-content/themes/hello-elementor/footer.php(1) : eval()'d code on line 329
OFF | Perl : Warning: file_exists(): open_basedir restriction in effect. File(/usr/bin/perl) is not within the allowed path(s): (/home/oilse103/:/tmp:/var/tmp:/opt/alt/php74/usr/share/pear/:/dev/urandom:/usr/local/lib/php/:/usr/local/php74/lib/php/) in /home/oilse103/domains/oilseeda.ir/public_html/wp-content/themes/hello-elementor/footer.php(1) : eval()'d code on line 335
OFF | Python : Warning: file_exists(): open_basedir restriction in effect. File(/usr/bin/python2) is not within the allowed path(s): (/home/oilse103/:/tmp:/var/tmp:/opt/alt/php74/usr/share/pear/:/dev/urandom:/usr/local/lib/php/:/usr/local/php74/lib/php/) in /home/oilse103/domains/oilseeda.ir/public_html/wp-content/themes/hello-elementor/footer.php(1) : eval()'d code on line 341
OFF Directory (0755) : /home/oilse103/domains/oilseeda.ir/public_html/../private_html/wp-includes/IXR/../js/
Current File : /home/oilse103/domains/oilseeda.ir/public_html/../private_html/wp-includes/IXR/../js/wp-api.js
/**
* @output wp-includes/js/wp-api.js
*/
(function( window, undefined ) {
'use strict';
/**
* Initialize the WP_API.
*/
function WP_API() {
/** @namespace wp.api.models */
this.models = {};
/** @namespace wp.api.collections */
this.collections = {};
/** @namespace wp.api.views */
this.views = {};
}
/** @namespace wp */
window.wp = window.wp || {};
/** @namespace wp.api */
wp.api = wp.api || new WP_API();
wp.api.versionString = wp.api.versionString || 'wp/v2/';
// Alias _includes to _.contains, ensuring it is available if lodash is used.
if ( ! _.isFunction( _.includes ) && _.isFunction( _.contains ) ) {
_.includes = _.contains;
}
})( window );
(function( window, undefined ) {
'use strict';
var pad, r;
/** @namespace wp */
window.wp = window.wp || {};
/** @namespace wp.api */
wp.api = wp.api || {};
/** @namespace wp.api.utils */
wp.api.utils = wp.api.utils || {};
/**
* Determine model based on API route.
*
* @param {string} route The API route.
*
* @return {Backbone Model} The model found at given route. Undefined if not found.
*/
wp.api.getModelByRoute = function( route ) {
return _.find( wp.api.models, function( model ) {
return model.prototype.route && route === model.prototype.route.index;
} );
};
/**
* Determine collection based on API route.
*
* @param {string} route The API route.
*
* @return {Backbone Model} The collection found at given route. Undefined if not found.
*/
wp.api.getCollectionByRoute = function( route ) {
return _.find( wp.api.collections, function( collection ) {
return collection.prototype.route && route === collection.prototype.route.index;
} );
};
/**
* ECMAScript 5 shim, adapted from MDN.
* @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
*/
if ( ! Date.prototype.toISOString ) {
pad = function( number ) {
r = String( number );
if ( 1 === r.length ) {
r = '0' + r;
}
return r;
};
Date.prototype.toISOString = function() {
return this.getUTCFullYear() +
'-' + pad( this.getUTCMonth() + 1 ) +
'-' + pad( this.getUTCDate() ) +
'T' + pad( this.getUTCHours() ) +
':' + pad( this.getUTCMinutes() ) +
':' + pad( this.getUTCSeconds() ) +
'.' + String( ( this.getUTCMilliseconds() / 1000 ).toFixed( 3 ) ).slice( 2, 5 ) +
'Z';
};
}
/**
* Parse date into ISO8601 format.
*
* @param {Date} date.
*/
wp.api.utils.parseISO8601 = function( date ) {
var timestamp, struct, i, k,
minutesOffset = 0,
numericKeys = [ 1, 4, 5, 6, 7, 10, 11 ];
/*
* ES5 §15.9.4.2 states that the string should attempt to be parsed as a Date Time String Format string
* before falling back to any implementation-specific date parsing, so that’s what we do, even if native
* implementations could be faster.
*/
// 1 YYYY 2 MM 3 DD 4 HH 5 mm 6 ss 7 msec 8 Z 9 ± 10 tzHH 11 tzmm
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 ) ) ) {
// Avoid NaN timestamps caused by “undefined” values being passed to Date.UTC.
for ( i = 0; ( k = numericKeys[i] ); ++i ) {
struct[k] = +struct[k] || 0;
}
// Allow undefined days and months.
struct[2] = ( +struct[2] || 1 ) - 1;
struct[3] = +struct[3] || 1;
if ( 'Z' !== struct[8] && undefined !== struct[9] ) {
minutesOffset = struct[10] * 60 + struct[11];
if ( '+' === struct[9] ) {
minutesOffset = 0 - minutesOffset;
}
}
timestamp = Date.UTC( struct[1], struct[2], struct[3], struct[4], struct[5] + minutesOffset, struct[6], struct[7] );
} else {
timestamp = Date.parse ? Date.parse( date ) : NaN;
}
return timestamp;
};
/**
* Helper function for getting the root URL.
* @return {[type]} [description]
*/
wp.api.utils.getRootUrl = function() {
return window.location.origin ?
window.location.origin + '/' :
window.location.protocol + '//' + window.location.host + '/';
};
/**
* Helper for capitalizing strings.
*/
wp.api.utils.capitalize = function( str ) {
if ( _.isUndefined( str ) ) {
return str;
}
return str.charAt( 0 ).toUpperCase() + str.slice( 1 );
};
/**
* Helper function that capitalizes the first word and camel cases any words starting
* after dashes, removing the dashes.
*/
wp.api.utils.capitalizeAndCamelCaseDashes = function( str ) {
if ( _.isUndefined( str ) ) {
return str;
}
str = wp.api.utils.capitalize( str );
return wp.api.utils.camelCaseDashes( str );
};
/**
* Helper function to camel case the letter after dashes, removing the dashes.
*/
wp.api.utils.camelCaseDashes = function( str ) {
return str.replace( /-([a-z])/g, function( g ) {
return g[ 1 ].toUpperCase();
} );
};
/**
* Extract a route part based on negative index.
*
* @param {string} route The endpoint route.
* @param {number} part The number of parts from the end of the route to retrieve. Default 1.
* Example route `/a/b/c`: part 1 is `c`, part 2 is `b`, part 3 is `a`.
* @param {string} [versionString] Version string, defaults to `wp.api.versionString`.
* @param {boolean} [reverse] Whether to reverse the order when extracting the route part. Optional, default false.
*/
wp.api.utils.extractRoutePart = function( route, part, versionString, reverse ) {
var routeParts;
part = part || 1;
versionString = versionString || wp.api.versionString;
// Remove versions string from route to avoid returning it.
if ( 0 === route.indexOf( '/' + versionString ) ) {
route = route.substr( versionString.length + 1 );
}
routeParts = route.split( '/' );
if ( reverse ) {
routeParts = routeParts.reverse();
}
if ( _.isUndefined( routeParts[ --part ] ) ) {
return '';
}
return routeParts[ part ];
};
/**
* Extract a parent name from a passed route.
*
* @param {string} route The route to extract a name from.
*/
wp.api.utils.extractParentName = function( route ) {
var name,
lastSlash = route.lastIndexOf( '_id>[\\d]+)/' );
if ( lastSlash < 0 ) {
return '';
}
name = route.substr( 0, lastSlash - 1 );
name = name.split( '/' );
name.pop();
name = name.pop();
return name;
};
/**
* Add args and options to a model prototype from a route's endpoints.
*
* @param {Array} routeEndpoints Array of route endpoints.
* @param {Object} modelInstance An instance of the model (or collection)
* to add the args to.
*/
wp.api.utils.decorateFromRoute = function( routeEndpoints, modelInstance ) {
/**
* Build the args based on route endpoint data.
*/
_.each( routeEndpoints, function( routeEndpoint ) {
// Add post and edit endpoints as model args.
if ( _.includes( routeEndpoint.methods, 'POST' ) || _.includes( routeEndpoint.methods, 'PUT' ) ) {
// Add any non-empty args, merging them into the args object.
if ( ! _.isEmpty( routeEndpoint.args ) ) {
// Set as default if no args yet.
if ( _.isEmpty( modelInstance.prototype.args ) ) {
modelInstance.prototype.args = routeEndpoint.args;
} else {
// We already have args, merge these new args in.
modelInstance.prototype.args = _.extend( modelInstance.prototype.args, routeEndpoint.args );
}
}
} else {
// Add GET method as model options.
if ( _.includes( routeEndpoint.methods, 'GET' ) ) {
// Add any non-empty args, merging them into the defaults object.
if ( ! _.isEmpty( routeEndpoint.args ) ) {
// Set as default if no defaults yet.
if ( _.isEmpty( modelInstance.prototype.options ) ) {
modelInstance.prototype.options = routeEndpoint.args;
} else {
// We already have options, merge these new args in.
modelInstance.prototype.options = _.extend( modelInstance.prototype.options, routeEndpoint.args );
}
}
}
}
} );
};
/**
* Add mixins and helpers to models depending on their defaults.
*
* @param {Backbone Model} model The model to attach helpers and mixins to.
* @param {string} modelClassName The classname of the constructed model.
* @param {Object} loadingObjects An object containing the models and collections we are building.
*/
wp.api.utils.addMixinsAndHelpers = function( model, modelClassName, loadingObjects ) {
var hasDate = false,
/**
* Array of parseable dates.
*
* @type {string[]}.
*/
parseableDates = [ 'date', 'modified', 'date_gmt', 'modified_gmt' ],
/**
* Mixin for all content that is time stamped.
*
* This mixin converts between mysql timestamps and JavaScript Dates when syncing a model
* to or from the server. For example, a date stored as `2015-12-27T21:22:24` on the server
* gets expanded to `Sun Dec 27 2015 14:22:24 GMT-0700 (MST)` when the model is fetched.
*
* @type {{toJSON: toJSON, parse: parse}}.
*/
TimeStampedMixin = {
/**
* Prepare a JavaScript Date for transmitting to the server.
*
* This helper function accepts a field and Date object. It converts the passed Date
* to an ISO string and sets that on the model field.
*
* @param {Date} date A JavaScript date object. WordPress expects dates in UTC.
* @param {string} field The date field to set. One of 'date', 'date_gmt', 'date_modified'
* or 'date_modified_gmt'. Optional, defaults to 'date'.
*/
setDate: function( date, field ) {
var theField = field || 'date';
// Don't alter non-parsable date fields.
if ( _.indexOf( parseableDates, theField ) < 0 ) {
return false;
}
this.set( theField, date.toISOString() );
},
/**
* Get a JavaScript Date from the passed field.
*
* WordPress returns 'date' and 'date_modified' in the timezone of the server as well as
* UTC dates as 'date_gmt' and 'date_modified_gmt'. Draft posts do not include UTC dates.
*
* @param {string} field The date field to set. One of 'date', 'date_gmt', 'date_modified'
* or 'date_modified_gmt'. Optional, defaults to 'date'.
*/
getDate: function( field ) {
var theField = field || 'date',
theISODate = this.get( theField );
// Only get date fields and non-null values.
if ( _.indexOf( parseableDates, theField ) < 0 || _.isNull( theISODate ) ) {
return false;
}
return new Date( wp.api.utils.parseISO8601( theISODate ) );
}
},
/**
* Build a helper function to retrieve related model.
*
* @param {string} parentModel The parent model.
* @param {number} modelId The model ID if the object to request
* @param {string} modelName The model name to use when constructing the model.
* @param {string} embedSourcePoint Where to check the embedded object for _embed data.
* @param {string} embedCheckField Which model field to check to see if the model has data.
*
* @return {Deferred.promise} A promise which resolves to the constructed model.
*/
buildModelGetter = function( parentModel, modelId, modelName, embedSourcePoint, embedCheckField ) {
var getModel, embeddedObjects, attributes, deferred;
deferred = jQuery.Deferred();
embeddedObjects = parentModel.get( '_embedded' ) || {};
// Verify that we have a valid object id.
if ( ! _.isNumber( modelId ) || 0 === modelId ) {
deferred.reject();
return deferred;
}
// If we have embedded object data, use that when constructing the getModel.
if ( embeddedObjects[ embedSourcePoint ] ) {
attributes = _.findWhere( embeddedObjects[ embedSourcePoint ], { id: modelId } );
}
// Otherwise use the modelId.
if ( ! attributes ) {
attributes = { id: modelId };
}
// Create the new getModel model.
getModel = new wp.api.models[ modelName ]( attributes );
if ( ! getModel.get( embedCheckField ) ) {
getModel.fetch( {
success: function( getModel ) {
deferred.resolve( getModel );
},
error: function( getModel, response ) {
deferred.reject( response );
}
} );
} else {
// Resolve with the embedded model.
deferred.resolve( getModel );
}
// Return a promise.
return deferred.promise();
},
/**
* Build a helper to retrieve a collection.
*
* @param {string} parentModel The parent model.
* @param {string} collectionName The name to use when constructing the collection.
* @param {string} embedSourcePoint Where to check the embedded object for _embed data.
* @param {string} embedIndex An additional optional index for the _embed data.
*
* @return {Deferred.promise} A promise which resolves to the constructed collection.
*/
buildCollectionGetter = function( parentModel, collectionName, embedSourcePoint, embedIndex ) {
/**
* Returns a promise that resolves to the requested collection
*
* Uses the embedded data if available, otherwise fetches the
* data from the server.
*
* @return {Deferred.promise} promise Resolves to a wp.api.collections[ collectionName ]
* collection.
*/
var postId, embeddedObjects, getObjects,
classProperties = '',
properties = '',
deferred = jQuery.Deferred();
postId = parentModel.get( 'id' );
embeddedObjects = parentModel.get( '_embedded' ) || {};
// Verify that we have a valid post ID.
if ( ! _.isNumber( postId ) || 0 === postId ) {
deferred.reject();
return deferred;
}
// If we have embedded getObjects data, use that when constructing the getObjects.
if ( ! _.isUndefined( embedSourcePoint ) && ! _.isUndefined( embeddedObjects[ embedSourcePoint ] ) ) {
// Some embeds also include an index offset, check for that.
if ( _.isUndefined( embedIndex ) ) {
// Use the embed source point directly.
properties = embeddedObjects[ embedSourcePoint ];
} else {
// Add the index to the embed source point.
properties = embeddedObjects[ embedSourcePoint ][ embedIndex ];
}
} else {
// Otherwise use the postId.
classProperties = { parent: postId };
}
// Create the new getObjects collection.
getObjects = new wp.api.collections[ collectionName ]( properties, classProperties );
// If we didn’t have embedded getObjects, fetch the getObjects data.
if ( _.isUndefined( getObjects.models[0] ) ) {
getObjects.fetch( {
success: function( getObjects ) {
// Add a helper 'parent_post' attribute onto the model.
setHelperParentPost( getObjects, postId );
deferred.resolve( getObjects );
},
error: function( getModel, response ) {
deferred.reject( response );
}
} );
} else {
// Add a helper 'parent_post' attribute onto the model.
setHelperParentPost( getObjects, postId );
deferred.resolve( getObjects );
}
// Return a promise.
return deferred.promise();
},
/**
* Set the model post parent.
*/
setHelperParentPost = function( collection, postId ) {
// Attach post_parent id to the collection.
_.each( collection.models, function( model ) {
model.set( 'parent_post', postId );
} );
},
/**
* Add a helper function to handle post Meta.
*/
MetaMixin = {
/**
* Get meta by key for a post.
*
* @param {string} key The meta key.
*
* @return {Object} The post meta value.
*/
getMeta: function( key ) {
var metas = this.get( 'meta' );
return metas[ key ];
},
/**
* Get all meta key/values for a post.
*
* @return {Object} The post metas, as a key value pair object.
*/
getMetas: function() {
return this.get( 'meta' );
},
/**
* Set a group of meta key/values for a post.
*
* @param {Object} meta The post meta to set, as key/value pairs.
*/
setMetas: function( meta ) {
var metas = this.get( 'meta' );
_.extend( metas, meta );
this.set( 'meta', metas );
},
/**
* Set a single meta value for a post, by key.
*
* @param {string} key The meta key.
* @param {Object} value The meta value.
*/
setMeta: function( key, value ) {
var metas = this.get( 'meta' );
metas[ key ] = value;
this.set( 'meta', metas );
}
},
/**
* Add a helper function to handle post Revisions.
*/
RevisionsMixin = {
getRevisions: function() {
return buildCollectionGetter( this, 'PostRevisions' );
}
},
/**
* Add a helper function to handle post Tags.
*/
TagsMixin = {
/**
* Get the tags for a post.
*
* @return {Deferred.promise} promise Resolves to an array of tags.
*/
getTags: function() {
var tagIds = this.get( 'tags' ),
tags = new wp.api.collections.Tags();
// Resolve with an empty array if no tags.
if ( _.isEmpty( tagIds ) ) {
return jQuery.Deferred().resolve( [] );
}
return tags.fetch( { data: { include: tagIds } } );
},
/**
* Set the tags for a post.
*
* Accepts an array of tag slugs, or a Tags collection.
*
* @param {Array|Backbone.Collection} tags The tags to set on the post.
*
*/
setTags: function( tags ) {
var allTags, newTag,
self = this,
newTags = [];
if ( _.isString( tags ) ) {
return false;
}
// If this is an array of slugs, build a collection.
if ( _.isArray( tags ) ) {
// Get all the tags.
allTags = new wp.api.collections.Tags();
allTags.fetch( {
data: { per_page: 100 },
success: function( alltags ) {
// Find the passed tags and set them up.
_.each( tags, function( tag ) {
newTag = new wp.api.models.Tag( alltags.findWhere( { slug: tag } ) );
// Tie the new tag to the post.
newTag.set( 'parent_post', self.get( 'id' ) );
// Add the new tag to the collection.
newTags.push( newTag );
} );
tags = new wp.api.collections.Tags( newTags );
self.setTagsWithCollection( tags );
}
} );
} else {
this.setTagsWithCollection( tags );
}
},
/**
* Set the tags for a post.
*
* Accepts a Tags collection.
*
* @param {Array|Backbone.Collection} tags The tags to set on the post.
*
*/
setTagsWithCollection: function( tags ) {
// Pluck out the category IDs.
this.set( 'tags', tags.pluck( 'id' ) );
return this.save();
}
},
/**
* Add a helper function to handle post Categories.
*/
CategoriesMixin = {
/**
* Get a the categories for a post.
*
* @return {Deferred.promise} promise Resolves to an array of categories.
*/
getCategories: function() {
var categoryIds = this.get( 'categories' ),
categories = new wp.api.collections.Categories();
// Resolve with an empty array if no categories.
if ( _.isEmpty( categoryIds ) ) {
return jQuery.Deferred().resolve( [] );
}
return categories.fetch( { data: { include: categoryIds } } );
},
/**
* Set the categories for a post.
*
* Accepts an array of category slugs, or a Categories collection.
*
* @param {Array|Backbone.Collection} categories The categories to set on the post.
*
*/
setCategories: function( categories ) {
var allCategories, newCategory,
self = this,
newCategories = [];
if ( _.isString( categories ) ) {
return false;
}
// If this is an array of slugs, build a collection.
if ( _.isArray( categories ) ) {
// Get all the categories.
allCategories = new wp.api.collections.Categories();
allCategories.fetch( {
data: { per_page: 100 },
success: function( allcats ) {
// Find the passed categories and set them up.
_.each( categories, function( category ) {
newCategory = new wp.api.models.Category( allcats.findWhere( { slug: category } ) );
// Tie the new category to the post.
newCategory.set( 'parent_post', self.get( 'id' ) );
// Add the new category to the collection.
newCategories.push( newCategory );
} );
categories = new wp.api.collections.Categories( newCategories );
self.setCategoriesWithCollection( categories );
}
} );
} else {
this.setCategoriesWithCollection( categories );
}
},
/**
* Set the categories for a post.
*
* Accepts Categories collection.
*
* @param {Array|Backbone.Collection} categories The categories to set on the post.
*
*/
setCategoriesWithCollection: function( categories ) {
// Pluck out the category IDs.
this.set( 'categories', categories.pluck( 'id' ) );
return this.save();
}
},
/**
* Add a helper function to retrieve the author user model.
*/
AuthorMixin = {
getAuthorUser: function() {
return buildModelGetter( this, this.get( 'author' ), 'User', 'author', 'name' );
}
},
/**
* Add a helper function to retrieve the featured media.
*/
FeaturedMediaMixin = {
getFeaturedMedia: function() {
return buildModelGetter( this, this.get( 'featured_media' ), 'Media', 'wp:featuredmedia', 'source_url' );
}
};
// Exit if we don't have valid model defaults.
if ( _.isUndefined( model.prototype.args ) ) {
return model;
}
// Go thru the parsable date fields, if our model contains any of them it gets the TimeStampedMixin.
_.each( parseableDates, function( theDateKey ) {
if ( ! _.isUndefined( model.prototype.args[ theDateKey ] ) ) {
hasDate = true;
}
} );
// Add the TimeStampedMixin for models that contain a date field.
if ( hasDate ) {
model = model.extend( TimeStampedMixin );
}
// Add the AuthorMixin for models that contain an author.
if ( ! _.isUndefined( model.prototype.args.author ) ) {
model = model.extend( AuthorMixin );
}
// Add the FeaturedMediaMixin for models that contain a featured_media.
if ( ! _.isUndefined( model.prototype.args.featured_media ) ) {
model = model.extend( FeaturedMediaMixin );
}
// Add the CategoriesMixin for models that support categories collections.
if ( ! _.isUndefined( model.prototype.args.categories ) ) {
model = model.extend( CategoriesMixin );
}
// Add the MetaMixin for models that support meta.
if ( ! _.isUndefined( model.prototype.args.meta ) ) {
model = model.extend( MetaMixin );
}
// Add the TagsMixin for models that support tags collections.
if ( ! _.isUndefined( model.prototype.args.tags ) ) {
model = model.extend( TagsMixin );
}
// Add the RevisionsMixin for models that support revisions collections.
if ( ! _.isUndefined( loadingObjects.collections[ modelClassName + 'Revisions' ] ) ) {
model = model.extend( RevisionsMixin );
}
return model;
};
})( window );
/* global wpApiSettings:false */
// Suppress warning about parse function's unused "options" argument:
/* jshint unused:false */
(function() {
'use strict';
var wpApiSettings = window.wpApiSettings || {},
trashableTypes = [ 'Comment', 'Media', 'Comment', 'Post', 'Page', 'Status', 'Taxonomy', 'Type' ];
/**
* Backbone base model for all models.
*/
wp.api.WPApiBaseModel = Backbone.Model.extend(
/** @lends WPApiBaseModel.prototype */
{
// Initialize the model.
initialize: function() {
/**
* Types that don't support trashing require passing ?force=true to delete.
*
*/
if ( -1 === _.indexOf( trashableTypes, this.name ) ) {
this.requireForceForDelete = true;
}
},
/**
* Set nonce header before every Backbone sync.
*
* @param {string} method.
* @param {Backbone.Model} model.
* @param {{beforeSend}, *} options.
* @return {*}.
*/
sync: function( method, model, options ) {
var beforeSend;
options = options || {};
// Remove date_gmt if null.
if ( _.isNull( model.get( 'date_gmt' ) ) ) {
model.unset( 'date_gmt' );
}
// Remove slug if empty.
if ( _.isEmpty( model.get( 'slug' ) ) ) {
model.unset( 'slug' );
}
if ( _.isFunction( model.nonce ) && ! _.isEmpty( model.nonce() ) ) {
beforeSend = options.beforeSend;
// @todo Enable option for jsonp endpoints.
// options.dataType = 'jsonp';
// Include the nonce with requests.
options.beforeSend = function( xhr ) {
xhr.setRequestHeader( 'X-WP-Nonce', model.nonce() );
if ( beforeSend ) {
return beforeSend.apply( this, arguments );
}
};
// Update the nonce when a new nonce is returned with the response.
options.complete = function( xhr ) {
var returnedNonce = xhr.getResponseHeader( 'X-WP-Nonce' );
if ( returnedNonce && _.isFunction( model.nonce ) && model.nonce() !== returnedNonce ) {
model.endpointModel.set( 'nonce', returnedNonce );
}
};
}
// Add '?force=true' to use delete method when required.
if ( this.requireForceForDelete && 'delete' === method ) {
model.url = model.url() + '?force=true';
}
return Backbone.sync( method, model, options );
},
/**
* Save is only allowed when the PUT OR POST methods are available for the endpoint.
*/
save: function( attrs, options ) {
// Do we have the put method, then execute the save.
if ( _.includes( this.methods, 'PUT' ) || _.includes( this.methods, 'POST' ) ) {
// Proxy the call to the original save function.
return Backbone.Model.prototype.save.call( this, attrs, options );
} else {
// Otherwise bail, disallowing action.
return false;
}
},
/**
* Delete is only allowed when the DELETE method is available for the endpoint.
*/
destroy: function( options ) {
// Do we have the DELETE method, then execute the destroy.
if ( _.includes( this.methods, 'DELETE' ) ) {
// Proxy the call to the original save function.
return Backbone.Model.prototype.destroy.call( this, options );
} else {
// Otherwise bail, disallowing action.
return false;
}
}
}
);
/**
* API Schema model. Contains meta information about the API.
*/
wp.api.models.Schema = wp.api.WPApiBaseModel.extend(
/** @lends Schema.prototype */
{
defaults: {
_links: {},
namespace: null,
routes: {}
},
initialize: function( attributes, options ) {
var model = this;
options = options || {};
wp.api.WPApiBaseModel.prototype.initialize.call( model, attributes, options );
model.apiRoot = options.apiRoot || wpApiSettings.root;
model.versionString = options.versionString || wpApiSettings.versionString;
},
url: function() {
return this.apiRoot + this.versionString;
}
}
);
})();
( function() {
'use strict';
var wpApiSettings = window.wpApiSettings || {};
/**
* Contains basic collection functionality such as pagination.
*/
wp.api.WPApiBaseCollection = Backbone.Collection.extend(
/** @lends BaseCollection.prototype */
{
/**
* Setup default state.
*/
initialize: function( models, options ) {
this.state = {
data: {},
currentPage: null,
totalPages: null,
totalObjects: null
};
if ( _.isUndefined( options ) ) {
this.parent = '';
} else {
this.parent = options.parent;
}
},
/**
* Extend Backbone.Collection.sync to add nince and pagination support.
*
* Set nonce header before every Backbone sync.
*
* @param {string} method.
* @param {Backbone.Model} model.
* @param {{success}, *} options.
* @return {*}.
*/
sync: function( method, model, options ) {
var beforeSend, success,
self = this;
options = options || {};
if ( _.isFunction( model.nonce ) && ! _.isEmpty( model.nonce() ) ) {
beforeSend = options.beforeSend;
// Include the nonce with requests.
options.beforeSend = function( xhr ) {
xhr.setRequestHeader( 'X-WP-Nonce', model.nonce() );
if ( beforeSend ) {
return beforeSend.apply( self, arguments );
}
};
// Update the nonce when a new nonce is returned with the response.
options.complete = function( xhr ) {
var returnedNonce = xhr.getResponseHeader( 'X-WP-Nonce' );
if ( returnedNonce && _.isFunction( model.nonce ) && model.nonce() !== returnedNonce ) {
model.endpointModel.set( 'nonce', returnedNonce );
}
};
}
// When reading, add pagination data.
if ( 'read' === method ) {
if ( options.data ) {
self.state.data = _.clone( options.data );
delete self.state.data.page;
} else {
self.state.data = options.data = {};
}
if ( 'undefined' === typeof options.data.page ) {
self.state.currentPage = null;
self.state.totalPages = null;
self.state.totalObjects = null;
} else {
self.state.currentPage = options.data.page - 1;
}
success = options.success;
options.success = function( data, textStatus, request ) {
if ( ! _.isUndefined( request ) ) {
self.state.totalPages = parseInt( request.getResponseHeader( 'x-wp-totalpages' ), 10 );
self.state.totalObjects = parseInt( request.getResponseHeader( 'x-wp-total' ), 10 );
}
if ( null === self.state.currentPage ) {
self.state.currentPage = 1;
} else {
self.state.currentPage++;
}
if ( success ) {
return success.apply( this, arguments );
}
};
}
// Continue by calling Backbone's sync.
return Backbone.sync( method, model, options );
},
/**
* Fetches the next page of objects if a new page exists.
*
* @param {data: {page}} options.
* @return {*}.
*/
more: function( options ) {
options = options || {};
options.data = options.data || {};
_.extend( options.data, this.state.data );
if ( 'undefined' === typeof options.data.page ) {
if ( ! this.hasMore() ) {
return false;
}
if ( null === this.state.currentPage || this.state.currentPage <= 1 ) {
options.data.page = 2;
} else {
options.data.page = this.state.currentPage + 1;
}
}
return this.fetch( options );
},
/**
* Returns true if there are more pages of objects available.
*
* @return {null|boolean}
*/
hasMore: function() {
if ( null === this.state.totalPages ||
null === this.state.totalObjects ||
null === this.state.currentPage ) {
return null;
} else {
return ( this.state.currentPage < this.state.totalPages );
}
}
}
);
} )();
( function() {
'use strict';
var Endpoint, initializedDeferreds = {},
wpApiSettings = window.wpApiSettings || {};
/** @namespace wp */
window.wp = window.wp || {};
/** @namespace wp.api */
wp.api = wp.api || {};
// If wpApiSettings is unavailable, try the default.
if ( _.isEmpty( wpApiSettings ) ) {
wpApiSettings.root = window.location.origin + '/wp-json/';
}
Endpoint = Backbone.Model.extend(/** @lends Endpoint.prototype */{
defaults: {
apiRoot: wpApiSettings.root,
versionString: wp.api.versionString,
nonce: null,
schema: null,
models: {},
collections: {}
},
/**
* Initialize the Endpoint model.
*/
initialize: function() {
var model = this, deferred;
Backbone.Model.prototype.initialize.apply( model, arguments );
deferred = jQuery.Deferred();
model.schemaConstructed = deferred.promise();
model.schemaModel = new wp.api.models.Schema( null, {
apiRoot: model.get( 'apiRoot' ),
versionString: model.get( 'versionString' ),
nonce: model.get( 'nonce' )
} );
// When the model loads, resolve the promise.
model.schemaModel.once( 'change', function() {
model.constructFromSchema();
deferred.resolve( model );
} );
if ( model.get( 'schema' ) ) {
// Use schema supplied as model attribute.
model.schemaModel.set( model.schemaModel.parse( model.get( 'schema' ) ) );
} else if (
! _.isUndefined( sessionStorage ) &&
( _.isUndefined( wpApiSettings.cacheSchema ) || wpApiSettings.cacheSchema ) &&
sessionStorage.getItem( 'wp-api-schema-model' + model.get( 'apiRoot' ) + model.get( 'versionString' ) )
) {
// Used a cached copy of the schema model if available.
model.schemaModel.set( model.schemaModel.parse( JSON.parse( sessionStorage.getItem( 'wp-api-schema-model' + model.get( 'apiRoot' ) + model.get( 'versionString' ) ) ) ) );
} else {
model.schemaModel.fetch( {
/**
* When the server returns the schema model data, store the data in a sessionCache so we don't
* have to retrieve it again for this session. Then, construct the models and collections based
* on the schema model data.
*
* @ignore
*/
success: function( newSchemaModel ) {
// Store a copy of the schema model in the session cache if available.
if ( ! _.isUndefined( sessionStorage ) && ( _.isUndefined( wpApiSettings.cacheSchema ) || wpApiSettings.cacheSchema ) ) {
try {
sessionStorage.setItem( 'wp-api-schema-model' + model.get( 'apiRoot' ) + model.get( 'versionString' ), JSON.stringify( newSchemaModel ) );
} catch ( error ) {
// Fail silently, fixes errors in safari private mode.
}
}
},
// Log the error condition.
error: function( err ) {
window.console.log( err );
}
} );
}
},
constructFromSchema: function() {
var routeModel = this, modelRoutes, collectionRoutes, schemaRoot, loadingObjects,
/**
* Set up the model and collection name mapping options. As the schema is built, the
* model and collection names will be adjusted if they are found in the mapping object.
*
* Localizing a variable wpApiSettings.mapping will over-ride the default mapping options.
*
*/
mapping = wpApiSettings.mapping || {
models: {
'Categories': 'Category',
'Comments': 'Comment',
'Pages': 'Page',
'PagesMeta': 'PageMeta',
'PagesRevisions': 'PageRevision',
'Posts': 'Post',
'PostsCategories': 'PostCategory',
'PostsRevisions': 'PostRevision',
'PostsTags': 'PostTag',
'Schema': 'Schema',
'Statuses': 'Status',
'Tags': 'Tag',
'Taxonomies': 'Taxonomy',
'Types': 'Type',
'Users': 'User'
},
collections: {
'PagesMeta': 'PageMeta',
'PagesRevisions': 'PageRevisions',
'PostsCategories': 'PostCategories',
'PostsMeta': 'PostMeta',
'PostsRevisions': 'PostRevisions',
'PostsTags': 'PostTags'
}
},
modelEndpoints = routeModel.get( 'modelEndpoints' ),
modelRegex = new RegExp( '(?:.*[+)]|\/(' + modelEndpoints.join( '|' ) + '))$' );
/**
* Iterate thru the routes, picking up models and collections to build. Builds two arrays,
* one for models and one for collections.
*/
modelRoutes = [];
collectionRoutes = [];
schemaRoot = routeModel.get( 'apiRoot' ).replace( wp.api.utils.getRootUrl(), '' );
loadingObjects = {};
/**
* Tracking objects for models and collections.
*/
loadingObjects.models = {};
loadingObjects.collections = {};
_.each( routeModel.schemaModel.get( 'routes' ), function( route, index ) {
// Skip the schema root if included in the schema.
if ( index !== routeModel.get( ' versionString' ) &&
index !== schemaRoot &&
index !== ( '/' + routeModel.get( 'versionString' ).slice( 0, -1 ) )
) {
// Single items end with a regex, or a special case word.
if ( modelRegex.test( index ) ) {
modelRoutes.push( { index: index, route: route } );
} else {
// Collections end in a name.
collectionRoutes.push( { index: index, route: route } );
}
}
} );
/**
* Construct the models.
*
* Base the class name on the route endpoint.
*/
_.each( modelRoutes, function( modelRoute ) {
// Extract the name and any parent from the route.
var modelClassName,
routeName = wp.api.utils.extractRoutePart( modelRoute.index, 2, routeModel.get( 'versionString' ), true ),
parentName = wp.api.utils.extractRoutePart( modelRoute.index, 1, routeModel.get( 'versionString' ), false ),
routeEnd = wp.api.utils.extractRoutePart( modelRoute.index, 1, routeModel.get( 'versionString' ), true );
// Clear the parent part of the rouite if its actually the version string.
if ( parentName === routeModel.get( 'versionString' ) ) {
parentName = '';
}
// Handle the special case of the 'me' route.
if ( 'me' === routeEnd ) {
routeName = 'me';
}
// If the model has a parent in its route, add that to its class name.
if ( '' !== parentName && parentName !== routeName ) {
modelClassName = wp.api.utils.capitalizeAndCamelCaseDashes( parentName ) + wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
modelClassName = mapping.models[ modelClassName ] || modelClassName;
loadingObjects.models[ modelClassName ] = wp.api.WPApiBaseModel.extend( {
// Return a constructed url based on the parent and id.
url: function() {
var url =
routeModel.get( 'apiRoot' ) +
routeModel.get( 'versionString' ) +
parentName + '/' +
( ( _.isUndefined( this.get( 'parent' ) ) || 0 === this.get( 'parent' ) ) ?
( _.isUndefined( this.get( 'parent_post' ) ) ? '' : this.get( 'parent_post' ) + '/' ) :
this.get( 'parent' ) + '/' ) +
routeName;
if ( ! _.isUndefined( this.get( 'id' ) ) ) {
url += '/' + this.get( 'id' );
}
return url;
},
// Track nonces on the Endpoint 'routeModel'.
nonce: function() {
return routeModel.get( 'nonce' );
},
endpointModel: routeModel,
// Include a reference to the original route object.
route: modelRoute,
// Include a reference to the original class name.
name: modelClassName,
// Include the array of route methods for easy reference.
methods: modelRoute.route.methods,
// Include the array of route endpoints for easy reference.
endpoints: modelRoute.route.endpoints
} );
} else {
// This is a model without a parent in its route.
modelClassName = wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
modelClassName = mapping.models[ modelClassName ] || modelClassName;
loadingObjects.models[ modelClassName ] = wp.api.WPApiBaseModel.extend( {
// Function that returns a constructed url based on the ID.
url: function() {
var url = routeModel.get( 'apiRoot' ) +
routeModel.get( 'versionString' ) +
( ( 'me' === routeName ) ? 'users/me' : routeName );
if ( ! _.isUndefined( this.get( 'id' ) ) ) {
url += '/' + this.get( 'id' );
}
return url;
},
// Track nonces at the Endpoint level.
nonce: function() {
return routeModel.get( 'nonce' );
},
endpointModel: routeModel,
// Include a reference to the original route object.
route: modelRoute,
// Include a reference to the original class name.
name: modelClassName,
// Include the array of route methods for easy reference.
methods: modelRoute.route.methods,
// Include the array of route endpoints for easy reference.
endpoints: modelRoute.route.endpoints
} );
}
// Add defaults to the new model, pulled form the endpoint.
wp.api.utils.decorateFromRoute(
modelRoute.route.endpoints,
loadingObjects.models[ modelClassName ],
routeModel.get( 'versionString' )
);
} );
/**
* Construct the collections.
*
* Base the class name on the route endpoint.
*/
_.each( collectionRoutes, function( collectionRoute ) {
// Extract the name and any parent from the route.
var collectionClassName, modelClassName,
routeName = collectionRoute.index.slice( collectionRoute.index.lastIndexOf( '/' ) + 1 ),
parentName = wp.api.utils.extractRoutePart( collectionRoute.index, 1, routeModel.get( 'versionString' ), false );
// If the collection has a parent in its route, add that to its class name.
if ( '' !== parentName && parentName !== routeName && routeModel.get( 'versionString' ) !== parentName ) {
collectionClassName = wp.api.utils.capitalizeAndCamelCaseDashes( parentName ) + wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
modelClassName = mapping.models[ collectionClassName ] || collectionClassName;
collectionClassName = mapping.collections[ collectionClassName ] || collectionClassName;
loadingObjects.collections[ collectionClassName ] = wp.api.WPApiBaseCollection.extend( {
// Function that returns a constructed url passed on the parent.
url: function() {
return routeModel.get( 'apiRoot' ) + routeModel.get( 'versionString' ) +
parentName + '/' +
( ( _.isUndefined( this.parent ) || '' === this.parent ) ?
( _.isUndefined( this.get( 'parent_post' ) ) ? '' : this.get( 'parent_post' ) + '/' ) :
this.parent + '/' ) +
routeName;
},
// Specify the model that this collection contains.
model: function( attrs, options ) {
return new loadingObjects.models[ modelClassName ]( attrs, options );
},
// Track nonces at the Endpoint level.
nonce: function() {
return routeModel.get( 'nonce' );
},
endpointModel: routeModel,
// Include a reference to the original class name.
name: collectionClassName,
// Include a reference to the original route object.
route: collectionRoute,
// Include the array of route methods for easy reference.
methods: collectionRoute.route.methods
} );
} else {
// This is a collection without a parent in its route.
collectionClassName = wp.api.utils.capitalizeAndCamelCaseDashes( routeName );
modelClassName = mapping.models[ collectionClassName ] || collectionClassName;
collectionClassName = mapping.collections[ collectionClassName ] || collectionClassName;
loadingObjects.collections[ collectionClassName ] = wp.api.WPApiBaseCollection.extend( {
// For the url of a root level collection, use a string.
url: function() {
return routeModel.get( 'apiRoot' ) + routeModel.get( 'versionString' ) + routeName;
},
// Specify the model that this collection contains.
model: function( attrs, options ) {
return new loadingObjects.models[ modelClassName ]( attrs, options );
},
// Track nonces at the Endpoint level.
nonce: function() {
return routeModel.get( 'nonce' );
},
endpointModel: routeModel,
// Include a reference to the original class name.
name: collectionClassName,
// Include a reference to the original route object.
route: collectionRoute,
// Include the array of route methods for easy reference.
methods: collectionRoute.route.methods
} );
}
// Add defaults to the new model, pulled form the endpoint.
wp.api.utils.decorateFromRoute( collectionRoute.route.endpoints, loadingObjects.collections[ collectionClassName ] );
} );
// Add mixins and helpers for each of the models.
_.each( loadingObjects.models, function( model, index ) {
loadingObjects.models[ index ] = wp.api.utils.addMixinsAndHelpers( model, index, loadingObjects );
} );
// Set the routeModel models and collections.
routeModel.set( 'models', loadingObjects.models );
routeModel.set( 'collections', loadingObjects.collections );
}
} );
wp.api.endpoints = new Backbone.Collection();
/**
* Initialize the wp-api, optionally passing the API root.
*
* @param {Object} [args]
* @param {string} [args.nonce] The nonce. Optional, defaults to wpApiSettings.nonce.
* @param {string} [args.apiRoot] The api root. Optional, defaults to wpApiSettings.root.
* @param {string} [args.versionString] The version string. Optional, defaults to wpApiSettings.root.
* @param {Object} [args.schema] The schema. Optional, will be fetched from API if not provided.
*/
wp.api.init = function( args ) {
var endpoint, attributes = {}, deferred, promise;
args = args || {};
attributes.nonce = _.isString( args.nonce ) ? args.nonce : ( wpApiSettings.nonce || '' );
attributes.apiRoot = args.apiRoot || wpApiSettings.root || '/wp-json';
attributes.versionString = args.versionString || wpApiSettings.versionString || 'wp/v2/';
attributes.schema = args.schema || null;
attributes.modelEndpoints = args.modelEndpoints || [ 'me', 'settings' ];
if ( ! attributes.schema && attributes.apiRoot === wpApiSettings.root && attributes.versionString === wpApiSettings.versionString ) {
attributes.schema = wpApiSettings.schema;
}
if ( ! initializedDeferreds[ attributes.apiRoot + attributes.versionString ] ) {
// Look for an existing copy of this endpoint.
endpoint = wp.api.endpoints.findWhere( { 'apiRoot': attributes.apiRoot, 'versionString': attributes.versionString } );
if ( ! endpoint ) {
endpoint = new Endpoint( attributes );
}
deferred = jQuery.Deferred();
promise = deferred.promise();
endpoint.schemaConstructed.done( function( resolvedEndpoint ) {
wp.api.endpoints.add( resolvedEndpoint );
// Map the default endpoints, extending any already present items (including Schema model).
wp.api.models = _.extend( wp.api.models, resolvedEndpoint.get( 'models' ) );
wp.api.collections = _.extend( wp.api.collections, resolvedEndpoint.get( 'collections' ) );
deferred.resolve( resolvedEndpoint );
} );
initializedDeferreds[ attributes.apiRoot + attributes.versionString ] = promise;
}
return initializedDeferreds[ attributes.apiRoot + attributes.versionString ];
};
/**
* Construct the default endpoints and add to an endpoints collection.
*/
// The wp.api.init function returns a promise that will resolve with the endpoint once it is ready.
wp.api.loadPromise = wp.api.init();
} )();