/*! * VisualEditor MediaWiki Initialization Platform class. * * @copyright 2011-2016 VisualEditor Team and others; see AUTHORS.txt * @license The MIT License (MIT); see LICENSE.txt */ /** * Initialization MediaWiki platform. * * @class * @extends ve.init.Platform * * @constructor */ ve.init.mw.Platform = function VeInitMwPlatform() { // Parent constructor ve.init.Platform.call( this ); // Properties this.externalLinkUrlProtocolsRegExp = new RegExp( '^(' + mw.config.get( 'wgUrlProtocols' ) + ')', 'i' ); this.unanchoredExternalLinkUrlProtocolsRegExp = new RegExp( '(' + mw.config.get( 'wgUrlProtocols' ) + ')', 'i' ); this.parsedMessages = {}; this.linkCache = new ve.init.mw.LinkCache(); this.imageInfoCache = new ve.init.mw.ImageInfoCache(); }; /* Inheritance */ OO.inheritClass( ve.init.mw.Platform, ve.init.Platform ); /* Methods */ /** @inheritdoc */ ve.init.mw.Platform.prototype.getExternalLinkUrlProtocolsRegExp = function () { return this.externalLinkUrlProtocolsRegExp; }; /** @inheritdoc */ ve.init.mw.Platform.prototype.getUnanchoredExternalLinkUrlProtocolsRegExp = function () { return this.unanchoredExternalLinkUrlProtocolsRegExp; }; /** @inheritdoc */ ve.init.mw.Platform.prototype.addMessages = function ( messages ) { return mw.messages.set( messages ); }; /** * @method * @inheritdoc */ ve.init.mw.Platform.prototype.getMessage = mw.msg.bind( mw ); /** * @method * @inheritdoc */ ve.init.mw.Platform.prototype.getConfig = mw.config.get.bind( mw.config ); /** * All values are JSON-parsed. To get raw values, use mw.user.options.get directly. * * @method * @inheritdoc */ ve.init.mw.Platform.prototype.getUserConfig = function ( keys ) { var values, parsedValues; if ( Array.isArray( keys ) ) { values = mw.user.options.get( keys ); parsedValues = {}; Object.keys( values ).forEach( function ( value ) { parsedValues[ value ] = JSON.parse( values[ value ] ); } ); return parsedValues; } else { try { return JSON.parse( mw.user.options.get( keys ) ); } catch ( e ) { // We might encounter an old unencoded value in the store return null; } } }; /** * Options must be registered in onGetPreferences * * All values are JSON encoded. To set raw values, use mw.user.options.set directly. * * @method * @inheritdoc */ ve.init.mw.Platform.prototype.setUserConfig = function ( keyOrValueMap, value ) { var jsonValues, jsonValue; if ( typeof keyOrValueMap === 'object' ) { if ( OO.compare( keyOrValueMap, this.getUserConfig( Object.keys( keyOrValueMap ) ) ) ) { return false; } // JSON encode all the values for API storage jsonValues = {}; Object.keys( keyOrValueMap ).forEach( function ( key ) { jsonValues[ key ] = JSON.stringify( keyOrValueMap[ key ] ); } ); new mw.Api().saveOptions( jsonValues ); return mw.user.options.set( jsonValues ); } else { if ( value === this.getUserConfig( keyOrValueMap ) ) { return false; } // JSON encode the value for API storage jsonValue = JSON.stringify( value ); new mw.Api().saveOption( keyOrValueMap, jsonValue ); return mw.user.options.set( keyOrValueMap, jsonValue ); } }; /** @inheritdoc */ ve.init.mw.Platform.prototype.addParsedMessages = function ( messages ) { var key; for ( key in messages ) { this.parsedMessages[ key ] = messages[ key ]; } }; /** @inheritdoc */ ve.init.mw.Platform.prototype.getParsedMessage = function ( key ) { if ( Object.prototype.hasOwnProperty.call( this.parsedMessages, key ) ) { // Prefer parsed results from VisualEditorDataModule if available. return this.parsedMessages[ key ]; } // Fallback to regular messages, with mw.message html escaping applied. return mw.message( key ).escaped(); }; /** @inheritdoc */ ve.init.mw.Platform.prototype.getLanguageCodes = function () { return Object.keys( mw.language.getData( mw.config.get( 'wgUserLanguage' ), 'languageNames' ) || $.uls.data.getAutonyms() ); }; /** @inheritdoc */ ve.init.mw.Platform.prototype.getLanguageName = function ( code ) { var languageNames = mw.language.getData( mw.config.get( 'wgUserLanguage' ), 'languageNames' ) || $.uls.data.getAutonyms(); return languageNames[ code ] || ''; }; /** * @method * @inheritdoc */ ve.init.mw.Platform.prototype.getLanguageAutonym = function () { return $.uls.data.getAutonym(); }; /** * @method * @inheritdoc */ ve.init.mw.Platform.prototype.getLanguageDirection = function () { return $.uls.data.getDir(); }; /** @inheritdoc */ ve.init.mw.Platform.prototype.getUserLanguages = function () { return mw.language.getFallbackLanguageChain(); }; /** * @inheritdoc */ ve.init.mw.Platform.prototype.fetchSpecialCharList = function () { var characters = {}, otherGroupName = mw.msg( 'visualeditor-special-characters-group-other' ), otherMsg = mw.msg( 'visualeditor-quick-access-characters.json' ), groupObject; if ( otherMsg !== '' ) { try { characters[ otherGroupName ] = JSON.parse( otherMsg ); } catch ( err ) { ve.log( 've.init.mw.Platform: Could not parse the Special Character list.' ); ve.log( err ); } } $.each( mw.language.specialCharacters, function ( groupName, groupCharacters ) { groupObject = {}; // button label => character data to insert $.each( groupCharacters, function ( charKey, charVal ) { // VE has a different format and it would be a pain to change it now if ( typeof charVal === 'string' ) { groupObject[ charVal ] = charVal; } else if ( typeof charVal === 'object' && 0 in charVal && 1 in charVal ) { groupObject[ charVal[ 0 ] ] = charVal[ 1 ]; } else { groupObject[ charVal.label ] = charVal; } } ); characters[ mw.msg( 'special-characters-group-' + groupName ) ] = groupObject; } ); // This implementation always resolves instantly return $.Deferred().resolve( characters ).promise(); };