255 lines
7.2 KiB
JavaScript
255 lines
7.2 KiB
JavaScript
/**
|
|
* ULS startup script - MediaWiki specific customization for jquery.uls
|
|
*
|
|
* Copyright (C) 2012-2013 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';
|
|
|
|
// MediaWiki override for ULS defaults.
|
|
$.fn.uls.defaults = $.extend( $.fn.uls.defaults, {
|
|
languages: mw.config.get( 'wgULSLanguages' ),
|
|
searchAPI: mw.util.wikiScript( 'api' ) + '?action=languagesearch'
|
|
} );
|
|
|
|
// No need of IME in language search bar of ULS
|
|
$.fn.uls.Constructor.prototype.render = function () {
|
|
this.$languageFilter.addClass( 'noime' );
|
|
};
|
|
|
|
var jsonLoader = null,
|
|
initialized = false,
|
|
currentLang = mw.config.get( 'wgUserLanguage' );
|
|
|
|
mw.uls = mw.uls || {};
|
|
mw.uls.previousLanguagesCookie = 'uls-previous-languages';
|
|
mw.uls.languageSettingsModules = ['ext.uls.inputsettings', 'ext.uls.displaysettings'];
|
|
|
|
// What was the last thing that the user did to select the language:
|
|
// * 'map' - clicked the map
|
|
// * 'search' - typed in the search box
|
|
// * 'common' - clicked a link in the "Common languages" section
|
|
// If the user just clicked in some other section, it remains undefined.
|
|
// This is useful for logging.
|
|
mw.uls.languageSelectionMethod = undefined;
|
|
|
|
/**
|
|
* Add event logging triggers, which are common to different
|
|
* ULS instances
|
|
*/
|
|
mw.uls.addEventLoggingTriggers = function () {
|
|
// Remove previous values when reinitializing
|
|
mw.uls.languageSelectionMethod = undefined;
|
|
|
|
$( '#map-block' ).on( 'click', function () {
|
|
mw.uls.languageSelectionMethod = 'map';
|
|
} );
|
|
|
|
$( '#languagefilter' ).on( 'keydown', function () {
|
|
// If it's the first letter,
|
|
// log the usage of the search box
|
|
if ( $( this ).val() === '' ) {
|
|
mw.uls.languageSelectionMethod = 'search';
|
|
}
|
|
} );
|
|
|
|
$( '#uls-lcd-quicklist a' ).on( 'click', function () {
|
|
mw.uls.languageSelectionMethod = 'common';
|
|
} );
|
|
};
|
|
|
|
/**
|
|
* Change the language of wiki using setlang URL parameter
|
|
* @param {string} language Language code.
|
|
*/
|
|
mw.uls.changeLanguage = function ( language ) {
|
|
var uri = new mw.Uri( window.location.href ),
|
|
deferred = new $.Deferred();
|
|
|
|
deferred.done( function () {
|
|
uri.extend( {
|
|
setlang: language
|
|
} );
|
|
window.location.href = uri.toString();
|
|
} );
|
|
|
|
mw.hook( 'mw.uls.interface.language.change' ).fire( language, deferred );
|
|
|
|
// Delay is zero if event logging is not enabled
|
|
window.setTimeout( function () {
|
|
deferred.resolve();
|
|
}, mw.config.get( 'wgULSEventLogging' ) * 500 );
|
|
|
|
};
|
|
|
|
mw.uls.setPreviousLanguages = function ( previousLanguages ) {
|
|
$.cookie( mw.uls.previousLanguagesCookie, $.toJSON( previousLanguages ),
|
|
{ path: '/' } );
|
|
};
|
|
|
|
mw.uls.getPreviousLanguages = function () {
|
|
var previousLanguages = $.cookie( mw.uls.previousLanguagesCookie );
|
|
|
|
if ( !previousLanguages ) {
|
|
return [];
|
|
}
|
|
|
|
// return last 5 language changes
|
|
return $.parseJSON( previousLanguages ).slice( -5 );
|
|
};
|
|
|
|
/**
|
|
* Returns the browser's user interface language or the system language.
|
|
* The caller should check the validity of the returned language code.
|
|
*
|
|
* @return {string} Language code or empty string.
|
|
*/
|
|
mw.uls.getBrowserLanguage = function () {
|
|
// language is the standard property.
|
|
// userLanguage is only for IE and returns system locale.
|
|
// Empty string is a fallback in case both are undefined
|
|
// to avoid runtime error with split().
|
|
return ( window.navigator.language || window.navigator.userLanguage || '' ).split( '-' )[0];
|
|
};
|
|
|
|
/*jshint camelcase:false*/
|
|
mw.uls.getCountryCode = function () {
|
|
return window.Geo && ( window.Geo.country || window.Geo.country_code );
|
|
};
|
|
|
|
mw.uls.getAcceptLanguageList = function () {
|
|
return mw.config.get( 'wgULSAcceptLanguageList' );
|
|
};
|
|
|
|
/**
|
|
* Get a list of codes for languages to show in
|
|
* the "Common languages" section of the ULS.
|
|
* The list consists of the user's current selected language,
|
|
* the wiki's content language, the browser' UI language
|
|
* and Accept-Language, user's previous selected languages
|
|
* and finally, the languages of countryCode taken from the CLDR,
|
|
* taken by default from the user's geolocation.
|
|
*
|
|
* @param {String} [countryCode] Uppercase country code.
|
|
* @return {Array} List of language codes without duplicates.
|
|
*/
|
|
mw.uls.getFrequentLanguageList = function ( countryCode ) {
|
|
var unique = [],
|
|
list = [
|
|
mw.config.get( 'wgUserLanguage' ),
|
|
mw.config.get( 'wgContentLanguage' ),
|
|
mw.uls.getBrowserLanguage()
|
|
]
|
|
.concat( mw.uls.getPreviousLanguages() )
|
|
.concat( mw.uls.getAcceptLanguageList() );
|
|
|
|
countryCode = countryCode || mw.uls.getCountryCode();
|
|
|
|
if ( countryCode ) {
|
|
list = list.concat( $.uls.data.getLanguagesInTerritory( countryCode ) );
|
|
}
|
|
|
|
$.each( list, function ( i, v ) {
|
|
if ( $.inArray( v, unique ) === -1 ) {
|
|
unique.push( v );
|
|
}
|
|
} );
|
|
|
|
// Filter out unknown and unsupported languages
|
|
unique = $.grep( unique, function ( langCode ) {
|
|
var target;
|
|
|
|
// If the language is already known and defined, just use it
|
|
if ( $.fn.uls.defaults.languages[langCode] !== undefined ) {
|
|
return true;
|
|
}
|
|
|
|
// If the language is not immediately known,
|
|
// try to check is as a redirect
|
|
target = $.uls.data.isRedirect( langCode );
|
|
|
|
if ( target ) {
|
|
// Check that the redirect's target is known
|
|
// to this instance of ULS
|
|
return $.fn.uls.defaults.languages[target] !== undefined;
|
|
}
|
|
|
|
return false;
|
|
} );
|
|
|
|
return unique;
|
|
};
|
|
|
|
/**
|
|
* Checks whether the browser is supported.
|
|
* Browser support policy: http://www.mediawiki.org/wiki/Browser_support#Grade_A
|
|
* @return boolean
|
|
*/
|
|
function isBrowserSupported() {
|
|
var blacklist = {
|
|
'msie': [['<=', 7]]
|
|
};
|
|
|
|
return !$.client.test( blacklist, null, true );
|
|
}
|
|
|
|
/**
|
|
* Initialize ULS front-end and its i18n.
|
|
*
|
|
* @param {Function} callback callback function to be called after initialization.
|
|
*/
|
|
mw.uls.init = function ( callback ) {
|
|
|
|
callback = callback || $.noop;
|
|
|
|
if ( initialized ) {
|
|
callback.call( this );
|
|
|
|
return;
|
|
}
|
|
|
|
if ( !isBrowserSupported() ) {
|
|
$( '#pt-uls' ).hide();
|
|
|
|
return;
|
|
}
|
|
|
|
/*
|
|
* The 'als' is used in a non-standard way in MediaWiki -
|
|
* it may be used to represent the Allemanic language,
|
|
* the standard code of which is 'gsw', while 'als'
|
|
* is ISO 639 3 refers to Tosk Albanian, which is
|
|
* not currently used in any way in MediaWiki.
|
|
* This local fix adds a redirect for it.
|
|
*/
|
|
$.uls.data.addLanguage( 'als', { target: 'gsw' } );
|
|
|
|
if ( !jsonLoader ) {
|
|
jsonLoader = mw.uls.loadLocalization( currentLang );
|
|
} else {
|
|
jsonLoader.done( function () {
|
|
initialized = true;
|
|
} );
|
|
jsonLoader.done( callback );
|
|
}
|
|
};
|
|
|
|
$( document ).ready( function () {
|
|
mw.uls.init();
|
|
} );
|
|
}( jQuery, mediaWiki ) );
|