From cb17f798614f4a25c0b062608897264b6c73aaaa Mon Sep 17 00:00:00 2001
From: JoryHogeveen <jory.johan.hogeveen@gmail.com>
Date: Tue, 29 Aug 2017 18:28:25 +0200
Subject: [PATCH] Enhance nav menu script + jsDoc

---
 includes/class-menu-meta-box.php |  2 +-
 js/nav-menu.js                   | 60 ++++++++++----------------------
 slidebars/slidebars.js           | 12 +++++--
 slidebars/slidebars.min.js       | 12 +++++--
 4 files changed, 38 insertions(+), 48 deletions(-)

diff --git a/includes/class-menu-meta-box.php b/includes/class-menu-meta-box.php
index f242eba..5307812 100644
--- a/includes/class-menu-meta-box.php
+++ b/includes/class-menu-meta-box.php
@@ -154,7 +154,7 @@ public function admin_enqueue_scripts() {
 			$data['val'][ $item ] = get_post_meta( $item, '_off_canvas_control_menu_item', true );
 
 		// send all these data to javascript
-		wp_localize_script( 'off_canvas_control_nav_menu', 'off_canvas_control_data', $data );
+		wp_localize_script( 'off_canvas_control_nav_menu', 'ocsNavControl', $data );
 	}
 
 	/*
diff --git a/js/nav-menu.js b/js/nav-menu.js
index 315a6b5..9f0afe7 100644
--- a/js/nav-menu.js
+++ b/js/nav-menu.js
@@ -5,12 +5,14 @@
  * @author Jory Hogeveen <info@keraweb.nl>
  * @package off-canvas-slidebars
  * @version 0.4
+ * @global ocsNavControl
+ * @preserve
  *
  * Credits to the Polylang plugin for inspiration
  */
 
-if ( 'undefined' === typeof off_canvas_control_data ) {
-	var off_canvas_control_data = {};
+if ( 'undefined' === typeof ocsNavControl ) {
+	var ocsNavControl = {};
 }
 
 jQuery( document ).ready( function( $ ) {
@@ -22,41 +24,35 @@ jQuery( document ).ready( function( $ ) {
 		$this.addClass('off-canvas-control');
 
 		/* If control selected, then show it */
-		if ( off_canvas_control_data.val[ db_id ]['off-canvas-control']) {
-			var key = off_canvas_control_data.val[ db_id ]['off-canvas-control'];
-			control_type = ' <i class="item-type-off-canvas-control">(' + off_canvas_control_data.controls[ key ] + ')</i>';
+		if ( ocsNavControl.val[ db_id ]['off-canvas-control']) {
+			var key = ocsNavControl.val[ db_id ]['off-canvas-control'];
+			control_type = ' <i class="item-type-off-canvas-control">(' + ocsNavControl.controls[ key ] + ')</i>';
 		}
-		$this.find('.menu-item-bar .item-type').html( off_canvas_control_data.strings.menu_item_type + control_type );
+		$this.find('.menu-item-bar .item-type').html( ocsNavControl.strings.menu_item_type + control_type );
 	});
 
-	/* change menu type label on selecting a controller */
+	/* Change menu type label on selecting a controller */
 	$(document).on( 'change', '.field-off-canvas-control input', function() {
 		var key = $(this).val();
-		var control_type = ' <i class="item-type-off-canvas-control">(' + off_canvas_control_data.controls[ key ] + ')</i>';
-		$(this).parents('.menu-item').find('.menu-item-bar .item-type').html( off_canvas_control_data.strings.menu_item_type + control_type );
+		var control_type = ' <i class="item-type-off-canvas-control">(' + ocsNavControl.controls[ key ] + ')</i>';
+		$(this).parents('.menu-item').find('.menu-item-bar .item-type').html( ocsNavControl.strings.menu_item_type + control_type );
 	} );
 
-	/* init/change menu item options */
+	/* Init/change menu item options */
 	$('#update-nav-menu').bind( 'click load', function(e) {
 		if ( e.target && e.target.className && -1 < e.target.className.indexOf('item-edit')) {
 			$('input[value="#off_canvas_control"][type=text]').parent().parent().parent().each( function() {
 				var $this = $(this),
 					item = $this.attr('id').substring(19),
-					strings = off_canvas_control_data.strings,
-					controls = off_canvas_control_data.controls,
+					strings = ocsNavControl.strings,
+					controls = ocsNavControl.controls,
 					option;
 
-				$this.children('p.field-url, p.field-link-target, .field-xfn, .field-description').remove(); // remove default fields we don't need
+				// Remove default fields we don't need
+				$this.children('p.field-url, p.field-link-target, .field-xfn, .field-description').remove();
+				// Change description width.
 				$this.children('p.field-css-classes').removeClass('description-thin').addClass('description-wide');
 
-				/*option = $('<input>').attr({
-						type: 'hidden',
-						id: 'edit-menu-item-title-'+item,
-						name: 'menu-item-title['+item+']',
-						value: off_canvas_control_data.title
-				});
-				$this.append(option);*/
-
 				option = $('<input>').attr( {
 					type: 'hidden',
 					id: 'edit-menu-item-url-' + item,
@@ -81,7 +77,7 @@ jQuery( document ).ready( function( $ ) {
 						continue;
 					}
 					var checked = '';
-					if (( 'undefined' !== typeof off_canvas_control_data.val[ item ] && key === off_canvas_control_data.val[ item ]['off-canvas-control'] ) ) {
+					if (( 'undefined' !== typeof ocsNavControl.val[ item ] && key === ocsNavControl.val[ item ]['off-canvas-control'] ) ) {
 						checked = ' checked="checked"';
 					}
 					o += '<input type="radio" id="edit-menu-item-off-canvas-control-' + key + '-item-' + item + '" name="menu-item-off-canvas-control[' + item + ']" value="' + key + '" ' + checked + ' /> ';
@@ -95,25 +91,7 @@ jQuery( document ).ready( function( $ ) {
 				if ( 1 === $field_control_options.length ) {
 					$field_control_options.prop('checked', true);
 				}
-				/*
-				ids = Array('menu_item_type'); // reverse order
-				// add the fields
-				for(var i = 0; i < ids.length; i++) {
-					p = $('<p>').attr('class', 'description');
-					$(this).prepend(p);
-					label = $('<label>').attr('for', 'menu-item-'+ids[i]+'-'+item).text(' '+off_canvas_control_data.strings[i]);
-					p.append(label);
-					cb = $('<input>').attr({
-						type: 'checkbox',
-						id: 'edit-menu-item-'+ids[i]+'-'+item,
-						name: 'menu-item-'+ids[i]+'['+item+']',
-						value: 1
-					});
-					if ((typeof(off_canvas_control_data.val[item]) != 'undefined' && off_canvas_control_data.val[item][ids[i]] == 1) || (typeof(off_canvas_control_data.val[item]) == 'undefined' && ids[i] == 'show_names')) // show_names as default value
-						cb.prop('checked', true);
-					label.prepend(cb);
-				}
-				*/
+
 			} );
 		}
 	} );
diff --git a/slidebars/slidebars.js b/slidebars/slidebars.js
index 70d5229..7e90d32 100644
--- a/slidebars/slidebars.js
+++ b/slidebars/slidebars.js
@@ -1,4 +1,4 @@
-;/*!
+;/**
  * Slidebars - A jQuery Framework for Off-Canvas Menus and Sidebars
  * Version: 2.0.2
  * Url: http://www.adchsm.com/slidebars/
@@ -8,9 +8,15 @@
  * License url: http://www.adchsm.com/slidebars/license/
  *
  * Modified by: Jory Hogeveen
- * Version numbers below are related to Off-Canvas Sidebars, not Slidebars.
+ * Version numbers and info below is related to Off-Canvas Sidebars, not Slidebars.
  *
- * @since  0.4  Add scope for this reference + Add legacy CSS support (no hardware acceleration)
+ * @package off-canvas-slidebars
+ * @author Jory Hogeveen <info@keraweb.nl>
+ *
+ * @version 0.4
+ * @since 0.4  Add scope for this reference + Add legacy CSS support (no hardware acceleration)
+ * @global slidebars
+ * @preserve
  */
 
 var slidebars;
diff --git a/slidebars/slidebars.min.js b/slidebars/slidebars.min.js
index 239fb58..1ed3c2b 100644
--- a/slidebars/slidebars.min.js
+++ b/slidebars/slidebars.min.js
@@ -1,4 +1,4 @@
-;/*!
+;/**
  * Slidebars - A jQuery Framework for Off-Canvas Menus and Sidebars
  * Version: 2.0.2
  * Url: http://www.adchsm.com/slidebars/
@@ -8,8 +8,14 @@
  * License url: http://www.adchsm.com/slidebars/license/
  *
  * Modified by: Jory Hogeveen
- * Version numbers below are related to Off-Canvas Sidebars, not Slidebars.
+ * Version numbers and info below is related to Off-Canvas Sidebars, not Slidebars.
  *
- * @since  0.4  Add scope for this reference + Add legacy CSS support (no hardware acceleration)
+ * @package off-canvas-slidebars
+ * @author Jory Hogeveen <info@keraweb.nl>
+ *
+ * @version 0.4
+ * @since 0.4  Add scope for this reference + Add legacy CSS support (no hardware acceleration)
+ * @global slidebars
+ * @preserve
  */
 var slidebars;(function($){slidebars=function(){var canvas=$("[canvas]"),canvas_fixed=$("[canvas-fixed]");offCanvas={},self=this,init=false,registered=false,sides=["top","right","bottom","left"],styles=["reveal","push","overlay","shift"],getAnimationProperties=function(id){var elements=$(),amount="0px, 0px",size="0px",duration=parseFloat(offCanvas[id].element.css("transitionDuration"))*1e3;if("reveal"===offCanvas[id].style||"push"===offCanvas[id].style||"shift"===offCanvas[id].style){elements=elements.add(canvas)}if("reveal"===offCanvas[id].style&&("top"===offCanvas[id].side||"bottom"===offCanvas[id].side)){elements=elements.add(offCanvas[id].element)}if("push"===offCanvas[id].style||"overlay"===offCanvas[id].style||"shift"===offCanvas[id].style){elements=elements.add(offCanvas[id].element)}if(offCanvas[id].active||self.legacy){if("top"===offCanvas[id].side||"bottom"===offCanvas[id].side){size=offCanvas[id].element.css("height")}else{size=offCanvas[id].element.css("width")}if(self.legacy){amount=size}else{if("top"===offCanvas[id].side){amount="0px, "+size}else if("right"===offCanvas[id].side){amount="-"+size+", 0px"}else if("bottom"===offCanvas[id].side){amount="0px, -"+size}else if("left"===offCanvas[id].side){amount=size+", 0px"}}}return{elements:elements,amount:amount,duration:duration}},registerSlidebar=function(id,side,style,element){if(isRegisteredSlidebar(id)){throw"Error registering Slidebar, a Slidebar with id '"+id+"' already exists."}offCanvas[id]={id:id,side:side,style:style,element:element,active:false}},isRegisteredSlidebar=function(id){return offCanvas.hasOwnProperty(id)};this.legacy=false;this.init=function(callback){if(init){throw"Slidebars has already been initialized."}if(!registered){$("[off-canvas]").each(function(){var parameters=$(this).attr("off-canvas").split(" ",3);if(!parameters||!parameters[0]||-1===sides.indexOf(parameters[1])||-1===styles.indexOf(parameters[2])){throw"Error registering Slidebar, please specify a valid id, side and style'."}registerSlidebar(parameters[0],parameters[1],parameters[2],$(this))});registered=true}init=true;this.css();$(events).trigger("init");if("function"===typeof callback){callback()}};this.exit=function(callback){if(!init){throw"Slidebars hasn't been initialized."}var exit=function(){init=false;$(events).trigger("exit");if("function"===typeof callback){callback()}};if(this.getActiveSlidebar()){this.close(exit)}else{exit()}};this.css=function(callback){if(!init){throw"Slidebars hasn't been initialized."}for(var id in offCanvas){if(offCanvas.hasOwnProperty(id)&&isRegisteredSlidebar(id)){var offset;if("top"===offCanvas[id].side||"bottom"===offCanvas[id].side){offset=offCanvas[id].element.css("height")}else{offset=offCanvas[id].element.css("width")}var do_offset=false;if("push"===offCanvas[id].style||"overlay"===offCanvas[id].style||"shift"===offCanvas[id].style){do_offset=true}else if("reveal"===offCanvas[id].style&&("top"===offCanvas[id].side||"bottom"===offCanvas[id].side)){do_offset=true}if(do_offset){offCanvas[id].element.css("margin-"+offCanvas[id].side,"-"+offset);if(self.legacy&&"shift"===offCanvas[id].style){var shiftPos;if("top"===offCanvas[id].side||"bottom"===offCanvas[id].side){shiftPos=offCanvas[id].element.height()/1.9}else if("left"===offCanvas[id].side||"right"===offCanvas[id].side){shiftPos=offCanvas[id].element.width()/1.9}if("left"===offCanvas[id].side||"right"===offCanvas[id].side){offCanvas[id].element.css(offCanvas[id].side,shiftPos+"px")}}}}}if(this.getActiveSlidebar()){this.open(this.getActiveSlidebar())}$(events).trigger("css");if("function"===typeof callback){callback()}};this.open=function(id,callback){if(!init){throw"Slidebars hasn't been initialized."}if(!id||!isRegisteredSlidebar(id)){throw"Error opening Slidebar, there is no Slidebar with id '"+id+"'."}var open=function(){offCanvas[id].active=true;offCanvas[id].element.css("display","block");$(events).trigger("opening",[offCanvas[id].id]);var animationProperties=getAnimationProperties(id);var css={"-webkit-transition-duration":animationProperties.duration+"ms","-moz-transition-duration":animationProperties.duration+"ms","-o-transition-duration":animationProperties.duration+"ms","transition-duration":animationProperties.duration+"ms"};if(self.legacy){css[offCanvas[id].side]=animationProperties.amount;var canvasSide;if("right"===offCanvas[id].side||"bottom"===offCanvas[id].side){if("right"===offCanvas[id].side){canvasSide="left"}else if("bottom"===offCanvas[id].side){canvasSide="top"}var canvasCss={"-webkit-transition-duration":animationProperties.duration+"ms","-moz-transition-duration":animationProperties.duration+"ms","-o-transition-duration":animationProperties.duration+"ms","transition-duration":animationProperties.duration+"ms"};canvasCss[canvasSide]="-"+animationProperties.amount;if("overlay"!==offCanvas[id].style){canvas.css(canvasCss)}animationProperties.elements.not(canvas).css(css)}else{animationProperties.elements.css(css)}}else{css.transform="translate("+animationProperties.amount+")";animationProperties.elements.css(css)}setTimeout(function(){$(events).trigger("opened",[offCanvas[id].id]);if("function"===typeof callback){callback()}},animationProperties.duration)};if(this.getActiveSlidebar()&&this.getActiveSlidebar()!==id){this.close(open)}else{open()}};this.close=function(id,callback){if("function"===typeof id){callback=id;id=null}if(!init){throw"Slidebars hasn't been initialized."}if(id&&!isRegisteredSlidebar(id)){throw"Error closing Slidebar, there is no Slidebar with id '"+id+"'."}if(!id){id=this.getActiveSlidebar()}if(id&&offCanvas[id].active){offCanvas[id].active=false;$(events).trigger("closing",[offCanvas[id].id]);var animationProperties=getAnimationProperties(id);if(self.legacy){var css={};var canvasSide;if("right"===offCanvas[id].side||"bottom"===offCanvas[id].side){if("right"===offCanvas[id].side){canvasSide="left"}else if("bottom"===offCanvas[id].side){canvasSide="top"}canvas.css(canvasSide,"");animationProperties.elements.not(canvas).css(offCanvas[id].side,"")}else{animationProperties.elements.css(offCanvas[id].side,"")}if("shift"===offCanvas[id].style){var shiftPos;if("top"===offCanvas[id].side||"bottom"===offCanvas[id].side){shiftPos=offCanvas[id].element.height()/1.9}else if("left"===offCanvas[id].side||"right"===offCanvas[id].side){shiftPos=offCanvas[id].element.width()/1.9}if("left"===offCanvas[id].side||"right"===offCanvas[id].side){offCanvas[id].element.css(offCanvas[id].side,shiftPos+"px")}}}else{animationProperties.elements.css("transform","")}setTimeout(function(){animationProperties.elements.css({"-webkit-transition-duration":"","-moz-transition-duration":"","-o-transition-duration":"","transition-duration":""});offCanvas[id].element.css("display","");$(events).trigger("closed",[offCanvas[id].id]);if("function"===typeof callback){callback()}},animationProperties.duration)}};this.toggle=function(id,callback){if(!init){throw"Slidebars hasn't been initialized."}if(!id||!isRegisteredSlidebar(id)){throw"Error toggling Slidebar, there is no Slidebar with id '"+id+"'."}if(offCanvas[id].active){this.close(id,function(){if("function"===typeof callback){callback()}})}else{this.open(id,function(){if("function"===typeof callback){callback()}})}};this.isActive=function(id){return init};this.isActiveSlidebar=function(id){if(!init){throw"Slidebars hasn't been initialized."}if(!id){throw"You must provide a Slidebar id."}if(!isRegisteredSlidebar(id)){throw"Error retrieving Slidebar, there is no Slidebar with id '"+id+"'."}return offCanvas[id].active};this.getActiveSlidebar=function(){if(!init){throw"Slidebars hasn't been initialized."}var active=false;for(var id in offCanvas){if(isRegisteredSlidebar(id)){if(offCanvas[id].active){active=offCanvas[id].id;break}}}return active};this.getSlidebars=function(){if(!init){throw"Slidebars hasn't been initialized."}var slidebarsArray=[];for(var id in offCanvas){if(isRegisteredSlidebar(id)){slidebarsArray.push(offCanvas[id].id)}}return slidebarsArray};this.getSlidebar=function(id){if(!init){throw"Slidebars hasn't been initialized."}if(!id){throw"You must pass a Slidebar id."}if(!id||!isRegisteredSlidebar(id)){throw"Error retrieving Slidebar, there is no Slidebar with id '"+id+"'."}return offCanvas[id]};this.events={};var events=this.events;$(window).on("resize",this.css.bind(this))}})(jQuery);
\ No newline at end of file