Files
mediawiki-extensions-Univer…/resources/js/ext.uls.preferences.js
Siebrand Mazeland 9ff4a4c343 Remove empty @returns comment
Change-Id: I83625c21a0de492004a1f20337a8288de0e49fd3
2012-11-12 07:46:38 +01:00

114 lines
2.9 KiB
JavaScript

/**
* ULS preferences system for MediaWiki.
* Local storage for anonymous users, preferences for logged in users.
*
* Copyright (C) 2012 Alolita Sharma, Amir Aharoni, Arun Ganesh, Brandon Harris,
* Niklas Laxström, Pau Giner, Santhosh Thottingal, Siebrand Mazeland and other
* contributors. See CREDITS for a list.
*
* UniversalLanguageSelector is dual licensed GPLv2 or later and MIT. You don't
* have to do anything special to choose one license or the other and you don't
* have to notify anyone which license you are using. You are free to use
* UniversalLanguageSelector in commercial projects as long as the copyright
* header is left intact. See files GPL-LICENSE and MIT-LICENSE for details.
*
* @file
* @ingroup Extensions
* @licence GNU General Public Licence 2.0 or later
* @licence MIT License
*/
( function ( $, mw, undefined ) {
'use strict';
var ULSPreferences = function () {
this.preferenceName = 'uls-preferences';
this.username = mw.user.getName();
this.isAnon = mw.user.isAnon();
this.preferences = null;
this.init();
};
ULSPreferences.prototype = {
/**
* Initialize
*/
init: function () {
if ( this.isAnon ) {
this.preferences = $.jStorage.get( this.preferenceName );
} else {
var options = mw.user.options.get( this.preferenceName );
this.preferences = $.parseJSON( options );
}
this.preferences = this.preferences || {};
},
/**
* Set the preference
*
* @param {String} key
* @param value
*/
set: function ( key, value ) {
this.preferences[key] = value;
},
/**
* Get a preference value for the given preference name
*
* @param key
*/
get: function ( key ) {
return this.preferences[key];
},
/**
* Save the preferences
*
* @param callback
*/
save: function ( callback ) {
var that = this, api;
callback = callback || $.noop;
if ( this.isAnon ) {
// Anonymous user- Save preferences in local storage
$.jStorage.set( this.preferenceName, this.preferences );
callback.call( this, true );
} else {
// Logged in user. Use MW apis to change preferences
api = new mw.Api();
api.post( {
action: 'tokens',
type: 'options'
} ).done( function ( tokenresult ) {
var token = tokenresult.tokens.optionstoken;
api.post( {
action: 'options',
change: 'hideminor=1',
optionname: that.preferenceName,
optionvalue: $.toJSON( that.preferences ),
token: token
} ).done( function () {
callback.call( this, true );
} ).fail( function () {
callback.call( this, false );
} );
} ).fail( function () {
callback.call( this, false );
} );
}
}
};
mw.uls = mw.uls || {};
mw.uls.preferences = function () {
var data = $( 'body' ).data( 'preferences' );
if ( !data ) {
$( 'body' ).data( 'preferences', ( data = new ULSPreferences() ) );
}
return data;
};
}( jQuery, mediaWiki ) );