GUAC-1053 New endpoint for listing languages, JS service for retrieving languages, and settings section for choosing language.

guacamole/src/main/webapp/app/settings/directives/guacSettingsPreferences.js

@@ -30,8 +30,7 @@ angular.module('settings').directive('guacSettingsPreferences', [function guacSe
         restrict: 'E',
         replace: true,
 
-        scope: {
-        },
+        scope: {},
 
         templateUrl: 'app/settings/templates/settingsPreferences.html',
         controller: ['$scope', '$injector', function settingsPreferencesController($scope, $injector) {
@@ -40,11 +39,13 @@ angular.module('settings').directive('guacSettingsPreferences', [function guacSe
             var PermissionSet = $injector.get('PermissionSet');
 
             // Required services
+            var $translate            = $injector.get('$translate');
             var authenticationService = $injector.get('authenticationService');
             var guacNotification      = $injector.get('guacNotification');
-            var userService           = $injector.get('userService');
+            var languageService       = $injector.get('languageService');
             var permissionService     = $injector.get('permissionService');
             var preferenceService     = $injector.get('preferenceService');
+            var userService           = $injector.get('userService');
 
             /**
              * An action to be provided along with the object sent to
@@ -71,6 +72,21 @@ angular.module('settings').directive('guacSettingsPreferences', [function guacSe
              * @type Object.<String, Object>
              */
             $scope.preferences = preferenceService.preferences;
+            
+            /**
+             * A map of all available language keys to their human-readable
+             * names.
+             * 
+             * @type Object.<String, String>
+             */
+            $scope.languages = null;
+            
+            /**
+             * Switches the active display langugae to the chosen language.
+             */
+            $scope.changeLanguage = function changeLanguage() {
+                $translate.use($scope.preferences.language);
+            };
 
             /**
              * The new password for the user.
@@ -151,6 +167,12 @@ angular.module('settings').directive('guacSettingsPreferences', [function guacSe
                 
             };
 
+            // Retrieve defined languages
+            languageService.getLanguages()
+            .success(function languagesRetrieved(languages) {
+                $scope.languages = languages;
+            });
+
             // Retrieve current permissions
             permissionService.getPermissions(username)
             .success(function permissionsRetrieved(permissions) {
@@ -161,7 +183,23 @@ angular.module('settings').directive('guacSettingsPreferences', [function guacSe
                         
             });
 
+            /**
+             * Returns whether critical data has completed being loaded.
+             *
+             * @returns {Boolean}
+             *     true if enough data has been loaded for the user interface to be
+             *     useful, false otherwise.
+             */
+            $scope.isLoaded = function isLoaded() {
+
+                return $scope.canChangePassword !== null
+                    && $scope.languages         !== null;
+
+            };
+
         }]
     };
     
+    
+    
 }]);

guacamole/src/main/webapp/app/settings/services/preferenceService.js

@@ -28,8 +28,9 @@ angular.module('settings').factory('preferenceService', ['$injector',
         function preferenceService($injector) {
 
     // Required services
-    var $window    = $injector.get('$window');
     var $rootScope = $injector.get('$rootScope');
+    var $translate = $injector.get('$translate');
+    var $window    = $injector.get('$window');
 
     var service = {};
 
@@ -95,7 +96,14 @@ angular.module('settings').factory('preferenceService', ['$injector',
          *
          * @type String
          */
-        inputMethod : service.inputMethods.NONE
+        inputMethod : service.inputMethods.NONE,
+        
+        /**
+         * The selected language.
+         * 
+         * @type String
+         */
+        language : $translate.use()
 
     };
 

guacamole/src/main/webapp/app/settings/templates/settingsPreferences.html

@@ -1,4 +1,4 @@
-<div class="preferences">
+<div class="preferences" ng-class="{loading: !isLoaded()}">
     <!--
     Copyright 2015 Glyptodon LLC.
 
@@ -21,6 +21,21 @@
     THE SOFTWARE.
     -->
 
+    <!-- Language settings -->
+    <div class="settings section language update-password">
+        <p>{{'SETTINGS_PREFERENCES.HELP_LANGUAGE' | translate}}</p>
+
+        <!-- Language selection -->
+        <div class="form">
+            <table class="fields">
+                <tr>
+                    <th>{{'SETTINGS_PREFERENCES.FIELD_HEADER_LANGUAGE' | translate}}</th>
+                    <td><select ng-model="preferences.language" ng-change="changeLanguage()" ng-options="key as name for (key, name) in languages | orderBy: name"></select></td>
+                </tr>
+            </table>
+        </div>
+    </div>
+    
     <!-- Password update -->
     <div class="settings section update-password" ng-show="canChangePassword">
         <p>{{'SETTINGS_PREFERENCES.HELP_UPDATE_PASSWORD' | translate}}</p>