summaryrefslogtreecommitdiffstats
path: root/wp-includes/js/utils.js
diff options
context:
space:
mode:
Diffstat (limited to 'wp-includes/js/utils.js')
-rw-r--r--wp-includes/js/utils.js204
1 files changed, 204 insertions, 0 deletions
diff --git a/wp-includes/js/utils.js b/wp-includes/js/utils.js
new file mode 100644
index 0000000..66d920a
--- /dev/null
+++ b/wp-includes/js/utils.js
@@ -0,0 +1,204 @@
+/**
+ * Cookie functions.
+ *
+ * @output wp-includes/js/utils.js
+ */
+
+/* global userSettings, getAllUserSettings, wpCookies, setUserSetting */
+/* exported getUserSetting, setUserSetting, deleteUserSetting */
+
+window.wpCookies = {
+// The following functions are from Cookie.js class in TinyMCE 3, Moxiecode, used under LGPL.
+
+ each: function( obj, cb, scope ) {
+ var n, l;
+
+ if ( ! obj ) {
+ return 0;
+ }
+
+ scope = scope || obj;
+
+ if ( typeof( obj.length ) !== 'undefined' ) {
+ for ( n = 0, l = obj.length; n < l; n++ ) {
+ if ( cb.call( scope, obj[n], n, obj ) === false ) {
+ return 0;
+ }
+ }
+ } else {
+ for ( n in obj ) {
+ if ( obj.hasOwnProperty(n) ) {
+ if ( cb.call( scope, obj[n], n, obj ) === false ) {
+ return 0;
+ }
+ }
+ }
+ }
+ return 1;
+ },
+
+ /**
+ * Get a multi-values cookie.
+ * Returns a JS object with the name: 'value' pairs.
+ */
+ getHash: function( name ) {
+ var cookie = this.get( name ), values;
+
+ if ( cookie ) {
+ this.each( cookie.split('&'), function( pair ) {
+ pair = pair.split('=');
+ values = values || {};
+ values[pair[0]] = pair[1];
+ });
+ }
+
+ return values;
+ },
+
+ /**
+ * Set a multi-values cookie.
+ *
+ * 'values_obj' is the JS object that is stored. It is encoded as URI in wpCookies.set().
+ */
+ setHash: function( name, values_obj, expires, path, domain, secure ) {
+ var str = '';
+
+ this.each( values_obj, function( val, key ) {
+ str += ( ! str ? '' : '&' ) + key + '=' + val;
+ });
+
+ this.set( name, str, expires, path, domain, secure );
+ },
+
+ /**
+ * Get a cookie.
+ */
+ get: function( name ) {
+ var e, b,
+ cookie = document.cookie,
+ p = name + '=';
+
+ if ( ! cookie ) {
+ return;
+ }
+
+ b = cookie.indexOf( '; ' + p );
+
+ if ( b === -1 ) {
+ b = cookie.indexOf(p);
+
+ if ( b !== 0 ) {
+ return null;
+ }
+ } else {
+ b += 2;
+ }
+
+ e = cookie.indexOf( ';', b );
+
+ if ( e === -1 ) {
+ e = cookie.length;
+ }
+
+ return decodeURIComponent( cookie.substring( b + p.length, e ) );
+ },
+
+ /**
+ * Set a cookie.
+ *
+ * The 'expires' arg can be either a JS Date() object set to the expiration date (back-compat)
+ * or the number of seconds until expiration
+ */
+ set: function( name, value, expires, path, domain, secure ) {
+ var d = new Date();
+
+ if ( typeof( expires ) === 'object' && expires.toGMTString ) {
+ expires = expires.toGMTString();
+ } else if ( parseInt( expires, 10 ) ) {
+ d.setTime( d.getTime() + ( parseInt( expires, 10 ) * 1000 ) ); // Time must be in milliseconds.
+ expires = d.toGMTString();
+ } else {
+ expires = '';
+ }
+
+ document.cookie = name + '=' + encodeURIComponent( value ) +
+ ( expires ? '; expires=' + expires : '' ) +
+ ( path ? '; path=' + path : '' ) +
+ ( domain ? '; domain=' + domain : '' ) +
+ ( secure ? '; secure' : '' );
+ },
+
+ /**
+ * Remove a cookie.
+ *
+ * This is done by setting it to an empty value and setting the expiration time in the past.
+ */
+ remove: function( name, path, domain, secure ) {
+ this.set( name, '', -1000, path, domain, secure );
+ }
+};
+
+// Returns the value as string. Second arg or empty string is returned when value is not set.
+window.getUserSetting = function( name, def ) {
+ var settings = getAllUserSettings();
+
+ if ( settings.hasOwnProperty( name ) ) {
+ return settings[name];
+ }
+
+ if ( typeof def !== 'undefined' ) {
+ return def;
+ }
+
+ return '';
+};
+
+/*
+ * Both name and value must be only ASCII letters, numbers or underscore
+ * and the shorter, the better (cookies can store maximum 4KB). Not suitable to store text.
+ * The value is converted and stored as string.
+ */
+window.setUserSetting = function( name, value, _del ) {
+ if ( 'object' !== typeof userSettings ) {
+ return false;
+ }
+
+ var uid = userSettings.uid,
+ settings = wpCookies.getHash( 'wp-settings-' + uid ),
+ path = userSettings.url,
+ secure = !! userSettings.secure;
+
+ name = name.toString().replace( /[^A-Za-z0-9_-]/g, '' );
+
+ if ( typeof value === 'number' ) {
+ value = parseInt( value, 10 );
+ } else {
+ value = value.toString().replace( /[^A-Za-z0-9_-]/g, '' );
+ }
+
+ settings = settings || {};
+
+ if ( _del ) {
+ delete settings[name];
+ } else {
+ settings[name] = value;
+ }
+
+ wpCookies.setHash( 'wp-settings-' + uid, settings, 31536000, path, '', secure );
+ wpCookies.set( 'wp-settings-time-' + uid, userSettings.time, 31536000, path, '', secure );
+
+ return name;
+};
+
+window.deleteUserSetting = function( name ) {
+ return setUserSetting( name, '', 1 );
+};
+
+// Returns all settings as JS object.
+window.getAllUserSettings = function() {
+ if ( 'object' !== typeof userSettings ) {
+ return {};
+ }
+
+ return wpCookies.getHash( 'wp-settings-' + userSettings.uid ) || {};
+};