/* global List, wpforms_builder, wpf, WPFormsBuilder, WPFormsFormTemplates */

[0] Fix | Delete

[1] Fix | Delete

/**

[2] Fix | Delete

* Form Builder Setup Panel module.

[3] Fix | Delete

*

[4] Fix | Delete

* @since 1.6.8

[5] Fix | Delete

*/

[6] Fix | Delete

[7] Fix | Delete

'use strict';

[8] Fix | Delete

[9] Fix | Delete

var WPForms = window.WPForms || {};

[10] Fix | Delete

[11] Fix | Delete

WPForms.Admin = WPForms.Admin || {};

[12] Fix | Delete

WPForms.Admin.Builder = WPForms.Admin.Builder || {};

[13] Fix | Delete

[14] Fix | Delete

WPForms.Admin.Builder.Setup = WPForms.Admin.Builder.Setup || ( function( document, window, $ ) {

[15] Fix | Delete

[16] Fix | Delete

/**

[17] Fix | Delete

* Elements holder.

[18] Fix | Delete

*

[19] Fix | Delete

* @since 1.6.8

[20] Fix | Delete

*

[21] Fix | Delete

* @type {object}

[22] Fix | Delete

*/

[23] Fix | Delete

var el = {};

[24] Fix | Delete

[25] Fix | Delete

/**

[26] Fix | Delete

* Runtime variables.

[27] Fix | Delete

*

[28] Fix | Delete

* @since 1.6.8

[29] Fix | Delete

*

[30] Fix | Delete

* @type {object}

[31] Fix | Delete

*/

[32] Fix | Delete

var vars = {};

[33] Fix | Delete

[34] Fix | Delete

/**

[35] Fix | Delete

* Active template name.

[36] Fix | Delete

*

[37] Fix | Delete

* @since 1.7.6

[38] Fix | Delete

*/

[39] Fix | Delete

const activeTemplateName = $( '.wpforms-template.selected .wpforms-template-name' ).text().trim();

[40] Fix | Delete

[41] Fix | Delete

/**

[42] Fix | Delete

* Public functions and properties.

[43] Fix | Delete

*

[44] Fix | Delete

* @since 1.6.8

[45] Fix | Delete

*

[46] Fix | Delete

* @type {object}

[47] Fix | Delete

*/

[48] Fix | Delete

var app = {

[49] Fix | Delete

[50] Fix | Delete

/**

[51] Fix | Delete

* Start the engine.

[52] Fix | Delete

*

[53] Fix | Delete

* @since 1.6.8

[54] Fix | Delete

*/

[55] Fix | Delete

init() {

[56] Fix | Delete

$( app.ready );

[57] Fix | Delete

[58] Fix | Delete

// Page load.

[59] Fix | Delete

$( window ).on( 'load', function() {

[60] Fix | Delete

[61] Fix | Delete

// In the case of jQuery 3.+, we need to wait for a ready event first.

[62] Fix | Delete

if ( typeof $.ready.then === 'function' ) {

[63] Fix | Delete

$.ready.then( app.load );

[64] Fix | Delete

} else {

[65] Fix | Delete

app.load();

[66] Fix | Delete

}

[67] Fix | Delete

} );

[68] Fix | Delete

},

[69] Fix | Delete

[70] Fix | Delete

/**

[71] Fix | Delete

* DOM is fully loaded.

[72] Fix | Delete

*

[73] Fix | Delete

* @since 1.6.8

[74] Fix | Delete

*/

[75] Fix | Delete

ready() {

[76] Fix | Delete

app.setup();

[77] Fix | Delete

app.setPanelsToggleState();

[78] Fix | Delete

app.setupTitleFocus();

[79] Fix | Delete

app.setTriggerBlankLink();

[80] Fix | Delete

app.setSelectedTemplate();

[81] Fix | Delete

app.setSelectedCategories();

[82] Fix | Delete

app.events();

[83] Fix | Delete

[84] Fix | Delete

el.$builder.trigger( 'wpformsBuilderSetupReady' );

[85] Fix | Delete

},

[86] Fix | Delete

[87] Fix | Delete

/**

[88] Fix | Delete

* Page load.

[89] Fix | Delete

*

[90] Fix | Delete

* @since 1.6.8

[91] Fix | Delete

*/

[92] Fix | Delete

load() {

[93] Fix | Delete

app.applyTemplateOnRequest();

[94] Fix | Delete

},

[95] Fix | Delete

[96] Fix | Delete

/**

[97] Fix | Delete

* Setup. Prepare some variables.

[98] Fix | Delete

*

[99] Fix | Delete

* @since 1.6.8

[100] Fix | Delete

*/

[101] Fix | Delete

setup() {

[102] Fix | Delete

// Cache DOM elements.

[103] Fix | Delete

el = {

[104] Fix | Delete

$builder: $( '#wpforms-builder' ),

[105] Fix | Delete

$form: $( '#wpforms-builder-form' ),

[106] Fix | Delete

$formName: $( '#wpforms-setup-name' ),

[107] Fix | Delete

$panel: $( '#wpforms-panel-setup' ),

[108] Fix | Delete

$categories: $( '#wpforms-panel-setup .wpforms-setup-templates-categories' ),

[109] Fix | Delete

$subcategories: $( '#wpforms-panel-setup .wpforms-setup-templates-subcategories' ),

[110] Fix | Delete

};

[111] Fix | Delete

[112] Fix | Delete

// Other values.

[113] Fix | Delete

vars.spinner = '<i class="wpforms-loading-spinner wpforms-loading-white wpforms-loading-inline"></i>';

[114] Fix | Delete

vars.formID = el.$form.data( 'id' );

[115] Fix | Delete

},

[116] Fix | Delete

[117] Fix | Delete

/**

[118] Fix | Delete

* Bind events.

[119] Fix | Delete

*

[120] Fix | Delete

* @since 1.6.8

[121] Fix | Delete

*/

[122] Fix | Delete

events() {

[123] Fix | Delete

el.$builder.on( 'wpformsBuilderPanelLoaded', app.panelLoaded );

[124] Fix | Delete

[125] Fix | Delete

app.panelEvents();

[126] Fix | Delete

[127] Fix | Delete

// Focus on the form title field when displaying setup panel.

[128] Fix | Delete

el.$builder

[129] Fix | Delete

.on( 'wpformsPanelSwitched', app.setupTitleFocus );

[130] Fix | Delete

[131] Fix | Delete

// Sync Setup title and settings title.

[132] Fix | Delete

el.$builder

[133] Fix | Delete

.on( 'input', '#wpforms-panel-field-settings-form_title', app.syncTitle )

[134] Fix | Delete

.on( 'input', '#wpforms-setup-name', app.syncTitle );

[135] Fix | Delete

},

[136] Fix | Delete

[137] Fix | Delete

/**

[138] Fix | Delete

* Bind panel events.

[139] Fix | Delete

*

[140] Fix | Delete

* @since 1.8.6

[141] Fix | Delete

*/

[142] Fix | Delete

panelEvents() {

[143] Fix | Delete

el.$panel

[144] Fix | Delete

.on( 'keyup', '#wpforms-setup-template-search', _.debounce( WPFormsFormTemplates.searchTemplate, 200 ) )

[145] Fix | Delete

.on( 'click', '.wpforms-setup-templates-categories li div', WPFormsFormTemplates.selectCategory )

[146] Fix | Delete

.on( 'click', '.wpforms-setup-templates-categories li .chevron', WPFormsFormTemplates.toggleSubcategoriesList )

[147] Fix | Delete

.on( 'click', '.wpforms-setup-templates-subcategories li', WPFormsFormTemplates.selectSubCategory )

[148] Fix | Delete

.on( 'click', '.wpforms-template-select', app.selectTemplate )

[149] Fix | Delete

.on( 'click', '.wpforms-trigger-blank', app.selectBlankTemplate );

[150] Fix | Delete

[151] Fix | Delete

el.$builder.on( 'wpformsBuilderReady wpformsBuilderPanelLoaded', app.filterTemplatesBySelectedCategory );

[152] Fix | Delete

},

[153] Fix | Delete

[154] Fix | Delete

/**

[155] Fix | Delete

* Panel loaded event.

[156] Fix | Delete

*

[157] Fix | Delete

* @since 1.8.6

[158] Fix | Delete

*

[159] Fix | Delete

* @param {Object} e Event object.

[160] Fix | Delete

* @param {string} panel Panel name.

[161] Fix | Delete

*/

[162] Fix | Delete

panelLoaded( e, panel ) {

[163] Fix | Delete

if ( panel !== 'setup' ) {

[164] Fix | Delete

return;

[165] Fix | Delete

}

[166] Fix | Delete

[167] Fix | Delete

app.setup();

[168] Fix | Delete

WPFormsFormTemplates.setup();

[169] Fix | Delete

app.setSelectedTemplate();

[170] Fix | Delete

app.setSelectedCategories();

[171] Fix | Delete

[172] Fix | Delete

app.panelEvents();

[173] Fix | Delete

},

[174] Fix | Delete

[175] Fix | Delete

/**

[176] Fix | Delete

* Set panels toggle buttons state.

[177] Fix | Delete

*

[178] Fix | Delete

* @since 1.6.8

[179] Fix | Delete

*/

[180] Fix | Delete

setPanelsToggleState: function() {

[181] Fix | Delete

[182] Fix | Delete

el.$builder

[183] Fix | Delete

.find( '#wpforms-panels-toggle button:not(.active)' )

[184] Fix | Delete

.toggleClass( 'wpforms-disabled', vars.formID === '' );

[185] Fix | Delete

},

[186] Fix | Delete

[187] Fix | Delete

/**

[188] Fix | Delete

* Set attributes of "blank template" link.

[189] Fix | Delete

*

[190] Fix | Delete

* @since 1.6.8

[191] Fix | Delete

*/

[192] Fix | Delete

setTriggerBlankLink: function() {

[193] Fix | Delete

[194] Fix | Delete

el.$builder

[195] Fix | Delete

.find( '.wpforms-trigger-blank' )

[196] Fix | Delete

.attr( {

[197] Fix | Delete

'data-template-name-raw': 'Blank Form',

[198] Fix | Delete

'data-template': 'blank',

[199] Fix | Delete

} );

[200] Fix | Delete

},

[201] Fix | Delete

[202] Fix | Delete

/**

[203] Fix | Delete

* Force focus on the form title field when switched to the Setup panel.

[204] Fix | Delete

*

[205] Fix | Delete

* @since 1.6.8

[206] Fix | Delete

*

[207] Fix | Delete

* @param {Object} e Event object.

[208] Fix | Delete

* @param {string} view Current view.

[209] Fix | Delete

*/

[210] Fix | Delete

setupTitleFocus( e, view ) {

[211] Fix | Delete

view = view || wpf.getQueryString( 'view' );

[212] Fix | Delete

[213] Fix | Delete

if ( view !== 'setup' ) {

[214] Fix | Delete

return;

[215] Fix | Delete

}

[216] Fix | Delete

[217] Fix | Delete

// Clone form title to the Setup page.

[218] Fix | Delete

$( '#wpforms-setup-name' ).val( $( '#wpforms-panel-field-settings-form_title' ).val() );

[219] Fix | Delete

[220] Fix | Delete

el.$formName.trigger( 'focus' );

[221] Fix | Delete

},

[222] Fix | Delete

[223] Fix | Delete

/**

[224] Fix | Delete

* Mark the current form template as selected.

[225] Fix | Delete

*

[226] Fix | Delete

* @since 1.8.6

[227] Fix | Delete

*/

[228] Fix | Delete

setSelectedTemplate() {

[229] Fix | Delete

if ( ! el.$panel.length || ! wpforms_builder.form_meta?.template ) {

[230] Fix | Delete

return;

[231] Fix | Delete

}

[232] Fix | Delete

[233] Fix | Delete

const $template = el.$builder

[234] Fix | Delete

.find( `.wpforms-template-select[data-template="${ wpforms_builder.form_meta.template }"]` )

[235] Fix | Delete

.closest( '.wpforms-template' );

[236] Fix | Delete

[237] Fix | Delete

if ( ! $template.length ) {

[238] Fix | Delete

return;

[239] Fix | Delete

}

[240] Fix | Delete

[241] Fix | Delete

$template

[242] Fix | Delete

.addClass( 'selected' )

[243] Fix | Delete

.addClass( 'badge' );

[244] Fix | Delete

[245] Fix | Delete

// Remove existing badge.

[246] Fix | Delete

$template.find( '.wpforms-badge' ).remove();

[247] Fix | Delete

[248] Fix | Delete

// Remove edit and delete action buttons from current user template.

[249] Fix | Delete

if ( $template.hasClass( 'wpforms-user-template' ) ) {

[250] Fix | Delete

$template.find( '.wpforms-template-edit, .wpforms-template-remove' ).remove();

[251] Fix | Delete

}

[252] Fix | Delete

},

[253] Fix | Delete

[254] Fix | Delete

/**

[255] Fix | Delete

* Set category and/or subcategory active if its template was selected.

[256] Fix | Delete

*

[257] Fix | Delete

* @since 1.8.9

[258] Fix | Delete

*/

[259] Fix | Delete

setSelectedCategories() {

[260] Fix | Delete

if ( ! el.$panel.length || ! wpforms_builder.form_meta?.category ) {

[261] Fix | Delete

return;

[262] Fix | Delete

}

[263] Fix | Delete

[264] Fix | Delete

const $category = el.$categories.find( `li[data-category="${ wpforms_builder.form_meta.category }"]` );

[265] Fix | Delete

[266] Fix | Delete

if ( ! $category.length ) {

[267] Fix | Delete

return;

[268] Fix | Delete

}

[269] Fix | Delete

[270] Fix | Delete

el.$categories.find( 'li' ).removeClass( 'active opened' );

[271] Fix | Delete

$category.addClass( 'active opened' );

[272] Fix | Delete

[273] Fix | Delete

const $subcategory = el.$subcategories.find( `li[data-subcategory="${ wpforms_builder.form_meta.subcategory }"]` );

[274] Fix | Delete

[275] Fix | Delete

if ( ! $subcategory.length ) {

[276] Fix | Delete

return;

[277] Fix | Delete

}

[278] Fix | Delete

[279] Fix | Delete

el.$subcategories.find( 'li' ).removeClass( 'active' );

[280] Fix | Delete

$subcategory.addClass( 'active' );

[281] Fix | Delete

},

[282] Fix | Delete

[283] Fix | Delete

/**

[284] Fix | Delete

* Filter templates by selected category and subcategory.

[285] Fix | Delete

*

[286] Fix | Delete

* @since 1.8.9

[287] Fix | Delete

*/

[288] Fix | Delete

filterTemplatesBySelectedCategory() {

[289] Fix | Delete

// If subcategory is available, trigger its click it will update and category also.

[290] Fix | Delete

if ( el.$subcategories.find( 'li.active' ).length ) {

[291] Fix | Delete

el.$subcategories.find( ' > li.active' ).trigger( 'click' );

[292] Fix | Delete

}

[293] Fix | Delete

[294] Fix | Delete

// In other case, check by the category.

[295] Fix | Delete

if ( el.$categories.find( 'li.active' ).length && ! el.$subcategories.find( 'li.active' ).length ) {

[296] Fix | Delete

el.$categories.find( ' > li.active div' ).trigger( 'click' );

[297] Fix | Delete

}

[298] Fix | Delete

},

[299] Fix | Delete

[300] Fix | Delete

/**

[301] Fix | Delete

* Keep Setup title and settings title instances the same.

[302] Fix | Delete

*

[303] Fix | Delete

* @since 1.6.8

[304] Fix | Delete

*

[305] Fix | Delete

* @param {object} e Event object.

[306] Fix | Delete

*/

[307] Fix | Delete

syncTitle: function( e ) {

[308] Fix | Delete

[309] Fix | Delete

if ( e.target.id === 'wpforms-setup-name' ) {

[310] Fix | Delete

$( '#wpforms-panel-field-settings-form_title' ).val( e.target.value );

[311] Fix | Delete

} else {

[312] Fix | Delete

$( '#wpforms-setup-name' ).val( e.target.value );

[313] Fix | Delete

}

[314] Fix | Delete

},

[315] Fix | Delete

[316] Fix | Delete

/**

[317] Fix | Delete

* Search template.

[318] Fix | Delete

*

[319] Fix | Delete

* @since 1.6.8

[320] Fix | Delete

* @since 1.7.7 Deprecated.

[321] Fix | Delete

*

[322] Fix | Delete

* @deprecated Use `WPFormsFormTemplates.searchTemplate` instead.

[323] Fix | Delete

*

[324] Fix | Delete

* @param {object} e Event object.

[325] Fix | Delete

*/

[326] Fix | Delete

searchTemplate: function( e ) {

[327] Fix | Delete

[328] Fix | Delete

console.warn( 'WARNING! Function "WPForms.Admin.Builder.Setup.searchTemplate( e )" has been deprecated, please use the new "WPFormsFormTemplates.searchTemplate( e )" function instead!' );

[329] Fix | Delete

[330] Fix | Delete

WPFormsFormTemplates.searchTemplate( e );

[331] Fix | Delete

},

[332] Fix | Delete

[333] Fix | Delete

/**

[334] Fix | Delete

* Select category.

[335] Fix | Delete

*

[336] Fix | Delete

* @since 1.6.8

[337] Fix | Delete

* @since 1.7.7 Deprecated.

[338] Fix | Delete

*

[339] Fix | Delete

* @deprecated Use `WPFormsFormTemplates.selectCategory` instead.

[340] Fix | Delete

*

[341] Fix | Delete

* @param {object} e Event object.

[342] Fix | Delete

*/

[343] Fix | Delete

selectCategory: function( e ) {

[344] Fix | Delete

[345] Fix | Delete

console.warn( 'WARNING! Function "WPForms.Admin.Builder.Setup.selectCategory( e )" has been deprecated, please use the new "WPFormsFormTemplates.selectCategory( e )" function instead!' );

[346] Fix | Delete

[347] Fix | Delete

WPFormsFormTemplates.selectCategory( e );

[348] Fix | Delete

},

[349] Fix | Delete

[350] Fix | Delete

/**

[351] Fix | Delete

* Select template.

[352] Fix | Delete

*

[353] Fix | Delete

* @since 1.6.8

[354] Fix | Delete

*

[355] Fix | Delete

* @param {Object} event Event object.

[356] Fix | Delete

*/

[357] Fix | Delete

selectTemplate( event ) {

[358] Fix | Delete

event.preventDefault();

[359] Fix | Delete

[360] Fix | Delete

const $button = $( this );

[361] Fix | Delete

[362] Fix | Delete

// Don't do anything for templates that trigger education modal OR addons-modal.

[363] Fix | Delete

if ( $button.hasClass( 'education-modal' ) ) {

[364] Fix | Delete

return;

[365] Fix | Delete

}

[366] Fix | Delete

[367] Fix | Delete

const template = $button.data( 'template' );

[368] Fix | Delete

[369] Fix | Delete

// User templates are applied differently for new forms.

[370] Fix | Delete

if ( ! vars.formID && template.match( /wpforms-user-template-(\d+)/ ) && $button.data( 'create-url' ) ) {

[371] Fix | Delete

window.location.href = $button.data( 'create-url' );

[372] Fix | Delete

return;

[373] Fix | Delete

}

[374] Fix | Delete

[375] Fix | Delete

el.$panel.find( '.wpforms-template' ).removeClass( 'active' );

[376] Fix | Delete

$button.closest( '.wpforms-template' ).addClass( 'active' );

[377] Fix | Delete

[378] Fix | Delete

// Save original label.

[379] Fix | Delete

$button.data( 'labelOriginal', $button.html() );

[380] Fix | Delete

[381] Fix | Delete

// Display loading indicator.

[382] Fix | Delete

$button.html( vars.spinner + wpforms_builder.loading );

[383] Fix | Delete

[384] Fix | Delete

const formName = app.getFormName( $button );

[385] Fix | Delete

[386] Fix | Delete

app.applyTemplate( formName, template, $button );

[387] Fix | Delete

},

[388] Fix | Delete

[389] Fix | Delete

/**

[390] Fix | Delete

* Get form name.

[391] Fix | Delete

*

[392] Fix | Delete

* @since 1.7.6

[393] Fix | Delete

*

[394] Fix | Delete

* @param {jQuery} $button Pressed template button.

[395] Fix | Delete

*

[396] Fix | Delete

* @returns {string} A new form name.

[397] Fix | Delete

*/

[398] Fix | Delete

getFormName: function( $button ) {

[399] Fix | Delete

[400] Fix | Delete

const templateName = $button.data( 'template-name-raw' );

[401] Fix | Delete

const formName = el.$formName.val();

[402] Fix | Delete

[403] Fix | Delete

if ( ! formName ) {

[404] Fix | Delete

return templateName;

[405] Fix | Delete

}

[406] Fix | Delete

[407] Fix | Delete

return activeTemplateName === formName ? templateName : formName;

[408] Fix | Delete

},

[409] Fix | Delete

[410] Fix | Delete

/**

[411] Fix | Delete

* Apply template.

[412] Fix | Delete

*

[413] Fix | Delete

* The final part of the select template routine.

[414] Fix | Delete

*

[415] Fix | Delete

* @since 1.6.9

[416] Fix | Delete

*

[417] Fix | Delete

* @param {string} formName Name of the form.

[418] Fix | Delete

* @param {string} template Template slug.

[419] Fix | Delete

* @param {jQuery} $button Use template button object.

[420] Fix | Delete

*/

[421] Fix | Delete

applyTemplate: function( formName, template, $button ) {

[422] Fix | Delete

[423] Fix | Delete

el.$builder.trigger( 'wpformsTemplateSelect', template );

[424] Fix | Delete

[425] Fix | Delete

if ( vars.formID ) {

[426] Fix | Delete

[427] Fix | Delete

// Existing form.

[428] Fix | Delete

app.selectTemplateExistingForm( formName, template, $button );

[429] Fix | Delete

[430] Fix | Delete

} else {

[431] Fix | Delete

[432] Fix | Delete

// Create a new form.

[433] Fix | Delete

WPFormsFormTemplates.selectTemplateProcess( formName, template, $button, app.selectTemplateProcessAjax );

[434] Fix | Delete

[435] Fix | Delete

}

[436] Fix | Delete

},

[437] Fix | Delete

[438] Fix | Delete

/**

[439] Fix | Delete

* Select Blank template.

[440] Fix | Delete

*

[441] Fix | Delete

* @since 1.6.8

[442] Fix | Delete

*

[443] Fix | Delete

* @param {object} e Event object.

[444] Fix | Delete

*/

[445] Fix | Delete

selectBlankTemplate: function( e ) {

[446] Fix | Delete

[447] Fix | Delete

e.preventDefault();

[448] Fix | Delete

[449] Fix | Delete

var $button = $( e.target ),

[450] Fix | Delete

formName = el.$formName.val() || wpforms_builder.blank_form,

[451] Fix | Delete

template = 'blank';

[452] Fix | Delete

[453] Fix | Delete

app.applyTemplate( formName, template, $button );

[454] Fix | Delete

},

[455] Fix | Delete

[456] Fix | Delete

/**

[457] Fix | Delete

* Select template. Existing form.

[458] Fix | Delete

*

[459] Fix | Delete

* @since 1.6.8

[460] Fix | Delete

*

[461] Fix | Delete

* @param {string} formName Name of the form.

[462] Fix | Delete

* @param {string} template Template slug.

[463] Fix | Delete

* @param {jQuery} $button Use template button object.

[464] Fix | Delete

*/

[465] Fix | Delete

selectTemplateExistingForm: function( formName, template, $button ) {

[466] Fix | Delete

[467] Fix | Delete

$.confirm( {

[468] Fix | Delete

title: wpforms_builder.heads_up,

[469] Fix | Delete

content: wpforms_builder.template_confirm,

[470] Fix | Delete

icon: 'fa fa-exclamation-circle',

[471] Fix | Delete

type: 'orange',

[472] Fix | Delete

buttons: {

[473] Fix | Delete

confirm: {

[474] Fix | Delete

text: wpforms_builder.ok,

[475] Fix | Delete

btnClass: 'btn-confirm',

[476] Fix | Delete

keys: [ 'enter' ],

[477] Fix | Delete

action: function() {

[478] Fix | Delete

[479] Fix | Delete

WPFormsFormTemplates.selectTemplateProcess( formName, template, $button, app.selectTemplateProcessAjax );

[480] Fix | Delete

},

[481] Fix | Delete

},

[482] Fix | Delete

cancel: {

[483] Fix | Delete

text: wpforms_builder.cancel,

[484] Fix | Delete

action: function() {

[485] Fix | Delete

[486] Fix | Delete

WPFormsFormTemplates.selectTemplateCancel();

[487] Fix | Delete

},

[488] Fix | Delete

},

[489] Fix | Delete

},

[490] Fix | Delete

} );

[491] Fix | Delete

},

[492] Fix | Delete

[493] Fix | Delete

/**

[494] Fix | Delete

* Select template.

[495] Fix | Delete

*

[496] Fix | Delete

* @since 1.6.8

[497] Fix | Delete

* @since 1.8.2 Deprecated.

[498] Fix | Delete

*

[499] Fix | Delete