classiccms 0.5.5 → 0.5.6

data/lib/classiccms/public/admin/datatables/src/core/core.sort.js

@@ -0,0 +1,460 @@
+
+
+/**
+ * Change the order of the table
+ *  @param {object} oSettings dataTables settings object
+ *  @param {bool} bApplyClasses optional - should we apply classes or not
+ *  @memberof DataTable#oApi
+ */
+function _fnSort ( oSettings, bApplyClasses )
+{
+	var
+		i, iLen, j, jLen, k, kLen,
+		sDataType, nTh,
+		aaSort = [],
+	 	aiOrig = [],
+		oSort = DataTable.ext.oSort,
+		aoData = oSettings.aoData,
+		aoColumns = oSettings.aoColumns,
+		oAria = oSettings.oLanguage.oAria;
+	
+	/* No sorting required if server-side or no sorting array */
+	if ( !oSettings.oFeatures.bServerSide && 
+		(oSettings.aaSorting.length !== 0 || oSettings.aaSortingFixed !== null) )
+	{
+		aaSort = ( oSettings.aaSortingFixed !== null ) ?
+			oSettings.aaSortingFixed.concat( oSettings.aaSorting ) :
+			oSettings.aaSorting.slice();
+		
+		/* If there is a sorting data type, and a fuction belonging to it, then we need to
+		 * get the data from the developer's function and apply it for this column
+		 */
+		for ( i=0 ; i<aaSort.length ; i++ )
+		{
+			var iColumn = aaSort[i][0];
+			var iVisColumn = _fnColumnIndexToVisible( oSettings, iColumn );
+			sDataType = oSettings.aoColumns[ iColumn ].sSortDataType;
+			if ( DataTable.ext.afnSortData[sDataType] )
+			{
+				var aData = DataTable.ext.afnSortData[sDataType].call( 
+					oSettings.oInstance, oSettings, iColumn, iVisColumn
+				);
+				if ( aData.length === aoData.length )
+				{
+					for ( j=0, jLen=aoData.length ; j<jLen ; j++ )
+					{
+						_fnSetCellData( oSettings, j, iColumn, aData[j] );
+					}
+				}
+				else
+				{
+					_fnLog( oSettings, 0, "Returned data sort array (col "+iColumn+") is the wrong length" );
+				}
+			}
+		}
+		
+		/* Create a value - key array of the current row positions such that we can use their
+		 * current position during the sort, if values match, in order to perform stable sorting
+		 */
+		for ( i=0, iLen=oSettings.aiDisplayMaster.length ; i<iLen ; i++ )
+		{
+			aiOrig[ oSettings.aiDisplayMaster[i] ] = i;
+		}
+
+		/* Build an internal data array which is specific to the sort, so we can get and prep
+		 * the data to be sorted only once, rather than needing to do it every time the sorting
+		 * function runs. This make the sorting function a very simple comparison
+		 */
+		var iSortLen = aaSort.length;
+		var fnSortFormat, aDataSort;
+		for ( i=0, iLen=aoData.length ; i<iLen ; i++ )
+		{
+			for ( j=0 ; j<iSortLen ; j++ )
+			{
+				aDataSort = aoColumns[ aaSort[j][0] ].aDataSort;
+
+				for ( k=0, kLen=aDataSort.length ; k<kLen ; k++ )
+				{
+					sDataType = aoColumns[ aDataSort[k] ].sType;
+					fnSortFormat = oSort[ (sDataType ? sDataType : 'string')+"-pre" ];
+					
+					aoData[i]._aSortData[ aDataSort[k] ] = fnSortFormat ?
+						fnSortFormat( _fnGetCellData( oSettings, i, aDataSort[k], 'sort' ) ) :
+						_fnGetCellData( oSettings, i, aDataSort[k], 'sort' );
+				}
+			}
+		}
+		
+		/* Do the sort - here we want multi-column sorting based on a given data source (column)
+		 * and sorting function (from oSort) in a certain direction. It's reasonably complex to
+		 * follow on it's own, but this is what we want (example two column sorting):
+		 *  fnLocalSorting = function(a,b){
+		 *  	var iTest;
+		 *  	iTest = oSort['string-asc']('data11', 'data12');
+		 *  	if (iTest !== 0)
+		 *  		return iTest;
+		 *    iTest = oSort['numeric-desc']('data21', 'data22');
+		 *    if (iTest !== 0)
+		 *  		return iTest;
+		 *  	return oSort['numeric-asc']( aiOrig[a], aiOrig[b] );
+		 *  }
+		 * Basically we have a test for each sorting column, if the data in that column is equal,
+		 * test the next column. If all columns match, then we use a numeric sort on the row 
+		 * positions in the original data array to provide a stable sort.
+		 */
+		oSettings.aiDisplayMaster.sort( function ( a, b ) {
+			var k, l, lLen, iTest, aDataSort, sDataType;
+			for ( k=0 ; k<iSortLen ; k++ )
+			{
+				aDataSort = aoColumns[ aaSort[k][0] ].aDataSort;
+
+				for ( l=0, lLen=aDataSort.length ; l<lLen ; l++ )
+				{
+					sDataType = aoColumns[ aDataSort[l] ].sType;
+					
+					iTest = oSort[ (sDataType ? sDataType : 'string')+"-"+aaSort[k][1] ](
+						aoData[a]._aSortData[ aDataSort[l] ],
+						aoData[b]._aSortData[ aDataSort[l] ]
+					);
+				
+					if ( iTest !== 0 )
+					{
+						return iTest;
+					}
+				}
+			}
+			
+			return oSort['numeric-asc']( aiOrig[a], aiOrig[b] );
+		} );
+	}
+	
+	/* Alter the sorting classes to take account of the changes */
+	if ( (bApplyClasses === undefined || bApplyClasses) && !oSettings.oFeatures.bDeferRender )
+	{
+		_fnSortingClasses( oSettings );
+	}
+
+	for ( i=0, iLen=oSettings.aoColumns.length ; i<iLen ; i++ )
+	{
+		var sTitle = aoColumns[i].sTitle.replace( /<.*?>/g, "" );
+		nTh = aoColumns[i].nTh;
+		nTh.removeAttribute('aria-sort');
+		nTh.removeAttribute('aria-label');
+		
+		/* In ARIA only the first sorting column can be marked as sorting - no multi-sort option */
+		if ( aoColumns[i].bSortable )
+		{
+			if ( aaSort.length > 0 && aaSort[0][0] == i )
+			{
+				nTh.setAttribute('aria-sort', aaSort[0][1]=="asc" ? "ascending" : "descending" );
+				
+				var nextSort = (aoColumns[i].asSorting[ aaSort[0][2]+1 ]) ? 
+					aoColumns[i].asSorting[ aaSort[0][2]+1 ] : aoColumns[i].asSorting[0];
+				nTh.setAttribute('aria-label', sTitle+
+					(nextSort=="asc" ? oAria.sSortAscending : oAria.sSortDescending) );
+			}
+			else
+			{
+				nTh.setAttribute('aria-label', sTitle+
+					(aoColumns[i].asSorting[0]=="asc" ? oAria.sSortAscending : oAria.sSortDescending) );
+			}
+		}
+		else
+		{
+			nTh.setAttribute('aria-label', sTitle);
+		}
+	}
+	
+	/* Tell the draw function that we have sorted the data */
+	oSettings.bSorted = true;
+	$(oSettings.oInstance).trigger('sort', oSettings);
+	
+	/* Copy the master data into the draw array and re-draw */
+	if ( oSettings.oFeatures.bFilter )
+	{
+		/* _fnFilter() will redraw the table for us */
+		_fnFilterComplete( oSettings, oSettings.oPreviousSearch, 1 );
+	}
+	else
+	{
+		oSettings.aiDisplay = oSettings.aiDisplayMaster.slice();
+		oSettings._iDisplayStart = 0; /* reset display back to page 0 */
+		_fnCalculateEnd( oSettings );
+		_fnDraw( oSettings );
+	}
+}
+
+
+/**
+ * Attach a sort handler (click) to a node
+ *  @param {object} oSettings dataTables settings object
+ *  @param {node} nNode node to attach the handler to
+ *  @param {int} iDataIndex column sorting index
+ *  @param {function} [fnCallback] callback function
+ *  @memberof DataTable#oApi
+ */
+function _fnSortAttachListener ( oSettings, nNode, iDataIndex, fnCallback )
+{
+	_fnBindAction( nNode, {}, function (e) {
+		/* If the column is not sortable - don't to anything */
+		if ( oSettings.aoColumns[iDataIndex].bSortable === false )
+		{
+			return;
+		}
+		
+		/*
+		 * This is a little bit odd I admit... I declare a temporary function inside the scope of
+		 * _fnBuildHead and the click handler in order that the code presented here can be used 
+		 * twice - once for when bProcessing is enabled, and another time for when it is 
+		 * disabled, as we need to perform slightly different actions.
+		 *   Basically the issue here is that the Javascript engine in modern browsers don't 
+		 * appear to allow the rendering engine to update the display while it is still excuting
+		 * it's thread (well - it does but only after long intervals). This means that the 
+		 * 'processing' display doesn't appear for a table sort. To break the js thread up a bit
+		 * I force an execution break by using setTimeout - but this breaks the expected 
+		 * thread continuation for the end-developer's point of view (their code would execute
+		 * too early), so we on;y do it when we absolutely have to.
+		 */
+		var fnInnerSorting = function () {
+			var iColumn, iNextSort;
+			
+			/* If the shift key is pressed then we are multipe column sorting */
+			if ( e.shiftKey )
+			{
+				/* Are we already doing some kind of sort on this column? */
+				var bFound = false;
+				for ( var i=0 ; i<oSettings.aaSorting.length ; i++ )
+				{
+					if ( oSettings.aaSorting[i][0] == iDataIndex )
+					{
+						bFound = true;
+						iColumn = oSettings.aaSorting[i][0];
+						iNextSort = oSettings.aaSorting[i][2]+1;
+						
+						if ( !oSettings.aoColumns[iColumn].asSorting[iNextSort] )
+						{
+							/* Reached the end of the sorting options, remove from multi-col sort */
+							oSettings.aaSorting.splice( i, 1 );
+						}
+						else
+						{
+							/* Move onto next sorting direction */
+							oSettings.aaSorting[i][1] = oSettings.aoColumns[iColumn].asSorting[iNextSort];
+							oSettings.aaSorting[i][2] = iNextSort;
+						}
+						break;
+					}
+				}
+				
+				/* No sort yet - add it in */
+				if ( bFound === false )
+				{
+					oSettings.aaSorting.push( [ iDataIndex, 
+						oSettings.aoColumns[iDataIndex].asSorting[0], 0 ] );
+				}
+			}
+			else
+			{
+				/* If no shift key then single column sort */
+				if ( oSettings.aaSorting.length == 1 && oSettings.aaSorting[0][0] == iDataIndex )
+				{
+					iColumn = oSettings.aaSorting[0][0];
+					iNextSort = oSettings.aaSorting[0][2]+1;
+					if ( !oSettings.aoColumns[iColumn].asSorting[iNextSort] )
+					{
+						iNextSort = 0;
+					}
+					oSettings.aaSorting[0][1] = oSettings.aoColumns[iColumn].asSorting[iNextSort];
+					oSettings.aaSorting[0][2] = iNextSort;
+				}
+				else
+				{
+					oSettings.aaSorting.splice( 0, oSettings.aaSorting.length );
+					oSettings.aaSorting.push( [ iDataIndex, 
+						oSettings.aoColumns[iDataIndex].asSorting[0], 0 ] );
+				}
+			}
+			
+			/* Run the sort */
+			_fnSort( oSettings );
+		}; /* /fnInnerSorting */
+		
+		if ( !oSettings.oFeatures.bProcessing )
+		{
+			fnInnerSorting();
+		}
+		else
+		{
+			_fnProcessingDisplay( oSettings, true );
+			setTimeout( function() {
+				fnInnerSorting();
+				if ( !oSettings.oFeatures.bServerSide )
+				{
+					_fnProcessingDisplay( oSettings, false );
+				}
+			}, 0 );
+		}
+		
+		/* Call the user specified callback function - used for async user interaction */
+		if ( typeof fnCallback == 'function' )
+		{
+			fnCallback( oSettings );
+		}
+	} );
+}
+
+
+/**
+ * Set the sorting classes on the header, Note: it is safe to call this function 
+ * when bSort and bSortClasses are false
+ *  @param {object} oSettings dataTables settings object
+ *  @memberof DataTable#oApi
+ */
+function _fnSortingClasses( oSettings )
+{
+	var i, iLen, j, jLen, iFound;
+	var aaSort, sClass;
+	var iColumns = oSettings.aoColumns.length;
+	var oClasses = oSettings.oClasses;
+	
+	for ( i=0 ; i<iColumns ; i++ )
+	{
+		if ( oSettings.aoColumns[i].bSortable )
+		{
+			$(oSettings.aoColumns[i].nTh).removeClass( oClasses.sSortAsc +" "+ oClasses.sSortDesc +
+				" "+ oSettings.aoColumns[i].sSortingClass );
+		}
+	}
+	
+	if ( oSettings.aaSortingFixed !== null )
+	{
+		aaSort = oSettings.aaSortingFixed.concat( oSettings.aaSorting );
+	}
+	else
+	{
+		aaSort = oSettings.aaSorting.slice();
+	}
+	
+	/* Apply the required classes to the header */
+	for ( i=0 ; i<oSettings.aoColumns.length ; i++ )
+	{
+		if ( oSettings.aoColumns[i].bSortable )
+		{
+			sClass = oSettings.aoColumns[i].sSortingClass;
+			iFound = -1;
+			for ( j=0 ; j<aaSort.length ; j++ )
+			{
+				if ( aaSort[j][0] == i )
+				{
+					sClass = ( aaSort[j][1] == "asc" ) ?
+						oClasses.sSortAsc : oClasses.sSortDesc;
+					iFound = j;
+					break;
+				}
+			}
+			$(oSettings.aoColumns[i].nTh).addClass( sClass );
+			
+			if ( oSettings.bJUI )
+			{
+				/* jQuery UI uses extra markup */
+				var jqSpan = $("span."+oClasses.sSortIcon,  oSettings.aoColumns[i].nTh);
+				jqSpan.removeClass(oClasses.sSortJUIAsc +" "+ oClasses.sSortJUIDesc +" "+ 
+					oClasses.sSortJUI +" "+ oClasses.sSortJUIAscAllowed +" "+ oClasses.sSortJUIDescAllowed );
+				
+				var sSpanClass;
+				if ( iFound == -1 )
+				{
+				 	sSpanClass = oSettings.aoColumns[i].sSortingClassJUI;
+				}
+				else if ( aaSort[iFound][1] == "asc" )
+				{
+					sSpanClass = oClasses.sSortJUIAsc;
+				}
+				else
+				{
+					sSpanClass = oClasses.sSortJUIDesc;
+				}
+				
+				jqSpan.addClass( sSpanClass );
+			}
+		}
+		else
+		{
+			/* No sorting on this column, so add the base class. This will have been assigned by
+			 * _fnAddColumn
+			 */
+			$(oSettings.aoColumns[i].nTh).addClass( oSettings.aoColumns[i].sSortingClass );
+		}
+	}
+	
+	/* 
+	 * Apply the required classes to the table body
+	 * Note that this is given as a feature switch since it can significantly slow down a sort
+	 * on large data sets (adding and removing of classes is always slow at the best of times..)
+	 * Further to this, note that this code is admitadly fairly ugly. It could be made a lot 
+	 * simpiler using jQuery selectors and add/removeClass, but that is significantly slower
+	 * (on the order of 5 times slower) - hence the direct DOM manipulation here.
+	 * Note that for defered drawing we do use jQuery - the reason being that taking the first
+	 * row found to see if the whole column needs processed can miss classes since the first
+	 * column might be new.
+	 */
+	sClass = oClasses.sSortColumn;
+	
+	if ( oSettings.oFeatures.bSort && oSettings.oFeatures.bSortClasses )
+	{
+		var nTds = _fnGetTdNodes( oSettings );
+
+		/* Remove the old classes */
+		if ( oSettings.oFeatures.bDeferRender )
+		{
+			$(nTds).removeClass(sClass+'1 '+sClass+'2 '+sClass+'3');
+		}
+		else if ( nTds.length >= iColumns )
+		{
+			for ( i=0 ; i<iColumns ; i++ )
+			{
+				if ( nTds[i].className.indexOf(sClass+"1") != -1 )
+				{
+					for ( j=0, jLen=(nTds.length/iColumns) ; j<jLen ; j++ )
+					{
+						nTds[(iColumns*j)+i].className = 
+							$.trim( nTds[(iColumns*j)+i].className.replace( sClass+"1", "" ) );
+					}
+				}
+				else if ( nTds[i].className.indexOf(sClass+"2") != -1 )
+				{
+					for ( j=0, jLen=(nTds.length/iColumns) ; j<jLen ; j++ )
+					{
+						nTds[(iColumns*j)+i].className = 
+							$.trim( nTds[(iColumns*j)+i].className.replace( sClass+"2", "" ) );
+					}
+				}
+				else if ( nTds[i].className.indexOf(sClass+"3") != -1 )
+				{
+					for ( j=0, jLen=(nTds.length/iColumns) ; j<jLen ; j++ )
+					{
+						nTds[(iColumns*j)+i].className = 
+							$.trim( nTds[(iColumns*j)+i].className.replace( " "+sClass+"3", "" ) );
+					}
+				}
+			}
+		}
+		
+		/* Add the new classes to the table */
+		var iClass = 1, iTargetCol;
+		for ( i=0 ; i<aaSort.length ; i++ )
+		{
+			iTargetCol = parseInt( aaSort[i][0], 10 );
+			for ( j=0, jLen=(nTds.length/iColumns) ; j<jLen ; j++ )
+			{
+				nTds[(iColumns*j)+iTargetCol].className += " "+sClass+iClass;
+			}
+			
+			if ( iClass < 3 )
+			{
+				iClass++;
+			}
+		}
+	}
+}
+

data/lib/classiccms/public/admin/datatables/src/core/core.state.js

@@ -0,0 +1,201 @@
+
+
+/**
+ * Save the state of a table in a cookie such that the page can be reloaded
+ *  @param {object} oSettings dataTables settings object
+ *  @memberof DataTable#oApi
+ */
+function _fnSaveState ( oSettings )
+{
+	if ( !oSettings.oFeatures.bStateSave || oSettings.bDestroying )
+	{
+		return;
+	}
+
+	/* Store the interesting variables */
+	var i, iLen, bInfinite=oSettings.oScroll.bInfinite;
+	var oState = {
+		"iCreate":      new Date().getTime(),
+		"iStart":       (bInfinite ? 0 : oSettings._iDisplayStart),
+		"iEnd":         (bInfinite ? oSettings._iDisplayLength : oSettings._iDisplayEnd),
+		"iLength":      oSettings._iDisplayLength,
+		"aaSorting":    $.extend( true, [], oSettings.aaSorting ),
+		"oSearch":      $.extend( true, {}, oSettings.oPreviousSearch ),
+		"aoSearchCols": $.extend( true, [], oSettings.aoPreSearchCols ),
+		"abVisCols":    []
+	};
+
+	for ( i=0, iLen=oSettings.aoColumns.length ; i<iLen ; i++ )
+	{
+		oState.abVisCols.push( oSettings.aoColumns[i].bVisible );
+	}
+
+	_fnCallbackFire( oSettings, "aoStateSaveParams", 'stateSaveParams', [oSettings, oState] );
+	
+	oSettings.fnStateSave.call( oSettings.oInstance, oSettings, oState );
+}
+
+
+/**
+ * Attempt to load a saved table state from a cookie
+ *  @param {object} oSettings dataTables settings object
+ *  @param {object} oInit DataTables init object so we can override settings
+ *  @memberof DataTable#oApi
+ */
+function _fnLoadState ( oSettings, oInit )
+{
+	if ( !oSettings.oFeatures.bStateSave )
+	{
+		return;
+	}
+
+	var oData = oSettings.fnStateLoad.call( oSettings.oInstance, oSettings );
+	if ( !oData )
+	{
+		return;
+	}
+	
+	/* Allow custom and plug-in manipulation functions to alter the saved data set and
+	 * cancelling of loading by returning false
+	 */
+	var abStateLoad = _fnCallbackFire( oSettings, 'aoStateLoadParams', 'stateLoadParams', [oSettings, oData] );
+	if ( $.inArray( false, abStateLoad ) !== -1 )
+	{
+		return;
+	}
+	
+	/* Store the saved state so it might be accessed at any time */
+	oSettings.oLoadedState = $.extend( true, {}, oData );
+	
+	/* Restore key features */
+	oSettings._iDisplayStart    = oData.iStart;
+	oSettings.iInitDisplayStart = oData.iStart;
+	oSettings._iDisplayEnd      = oData.iEnd;
+	oSettings._iDisplayLength   = oData.iLength;
+	oSettings.aaSorting         = oData.aaSorting.slice();
+	oSettings.saved_aaSorting   = oData.aaSorting.slice();
+	
+	/* Search filtering  */
+	$.extend( oSettings.oPreviousSearch, oData.oSearch );
+	$.extend( true, oSettings.aoPreSearchCols, oData.aoSearchCols );
+	
+	/* Column visibility state
+	 * Pass back visibiliy settings to the init handler, but to do not here override
+	 * the init object that the user might have passed in
+	 */
+	oInit.saved_aoColumns = [];
+	for ( var i=0 ; i<oData.abVisCols.length ; i++ )
+	{
+		oInit.saved_aoColumns[i] = {};
+		oInit.saved_aoColumns[i].bVisible = oData.abVisCols[i];
+	}
+
+	_fnCallbackFire( oSettings, 'aoStateLoaded', 'stateLoaded', [oSettings, oData] );
+}
+
+
+/**
+ * Create a new cookie with a value to store the state of a table
+ *  @param {string} sName name of the cookie to create
+ *  @param {string} sValue the value the cookie should take
+ *  @param {int} iSecs duration of the cookie
+ *  @param {string} sBaseName sName is made up of the base + file name - this is the base
+ *  @param {function} fnCallback User definable function to modify the cookie
+ *  @memberof DataTable#oApi
+ */
+function _fnCreateCookie ( sName, sValue, iSecs, sBaseName, fnCallback )
+{
+	var date = new Date();
+	date.setTime( date.getTime()+(iSecs*1000) );
+	
+	/* 
+	 * Shocking but true - it would appear IE has major issues with having the path not having
+	 * a trailing slash on it. We need the cookie to be available based on the path, so we
+	 * have to append the file name to the cookie name. Appalling. Thanks to vex for adding the
+	 * patch to use at least some of the path
+	 */
+	var aParts = window.location.pathname.split('/');
+	var sNameFile = sName + '_' + aParts.pop().replace(/[\/:]/g,"").toLowerCase();
+	var sFullCookie, oData;
+	
+	if ( fnCallback !== null )
+	{
+		oData = (typeof $.parseJSON === 'function') ? 
+			$.parseJSON( sValue ) : eval( '('+sValue+')' );
+		sFullCookie = fnCallback( sNameFile, oData, date.toGMTString(),
+			aParts.join('/')+"/" );
+	}
+	else
+	{
+		sFullCookie = sNameFile + "=" + encodeURIComponent(sValue) +
+			"; expires=" + date.toGMTString() +"; path=" + aParts.join('/')+"/";
+	}
+	
+	/* Are we going to go over the cookie limit of 4KiB? If so, try to delete a cookies
+	 * belonging to DataTables. This is FAR from bullet proof
+	 */
+	var sOldName="", iOldTime=9999999999999;
+	var iLength = _fnReadCookie( sNameFile )!==null ? document.cookie.length : 
+		sFullCookie.length + document.cookie.length;
+	
+	if ( iLength+10 > 4096 ) /* Magic 10 for padding */
+	{
+		var aCookies =document.cookie.split(';');
+		for ( var i=0, iLen=aCookies.length ; i<iLen ; i++ )
+		{
+			if ( aCookies[i].indexOf( sBaseName ) != -1 )
+			{
+				/* It's a DataTables cookie, so eval it and check the time stamp */
+				var aSplitCookie = aCookies[i].split('=');
+				try { oData = eval( '('+decodeURIComponent(aSplitCookie[1])+')' ); }
+				catch( e ) { continue; }
+				
+				if ( oData.iCreate && oData.iCreate < iOldTime )
+				{
+					sOldName = aSplitCookie[0];
+					iOldTime = oData.iCreate;
+				}
+			}
+		}
+		
+		if ( sOldName !== "" )
+		{
+			document.cookie = sOldName+"=; expires=Thu, 01-Jan-1970 00:00:01 GMT; path="+
+				aParts.join('/') + "/";
+		}
+	}
+	
+	document.cookie = sFullCookie;
+}
+
+
+/**
+ * Read an old cookie to get a cookie with an old table state
+ *  @param {string} sName name of the cookie to read
+ *  @returns {string} contents of the cookie - or null if no cookie with that name found
+ *  @memberof DataTable#oApi
+ */
+function _fnReadCookie ( sName )
+{
+	var
+		aParts = window.location.pathname.split('/'),
+		sNameEQ = sName + '_' + aParts[aParts.length-1].replace(/[\/:]/g,"").toLowerCase() + '=',
+	 	sCookieContents = document.cookie.split(';');
+	
+	for( var i=0 ; i<sCookieContents.length ; i++ )
+	{
+		var c = sCookieContents[i];
+		
+		while (c.charAt(0)==' ')
+		{
+			c = c.substring(1,c.length);
+		}
+		
+		if (c.indexOf(sNameEQ) === 0)
+		{
+			return decodeURIComponent( c.substring(sNameEQ.length,c.length) );
+		}
+	}
+	return null;
+}
+