Custom Settings

Top Previous Next

Custom settings is a way to easily set global parameters that will affect all the ThinRDP Server functioning, regardless of the session.

The customsettings.js file is distributed with the ThinRDP Server installation. You can find it in the installation directory, inside the 'webrdp' folder. It is a javascript file that contains javascript code which is read by the client's browser when they access ThinRDP Server and then communicates with ThinRDP Server to send information, like toolbar parameters. You can open it with any text editor, like notepad.

These are the initial values:

var customSettings = {

"createToolbar": true, // Create ThinRDP toolbar

"toolbarVisible": false // ThinRDP toolbar starts expanded (visible)

};

The customSettings variable uses the JSON format, a collection of name/value pairs. When ThinRDP starts it will read the values in customSettings and override with its settings the options that are set in the profiles. It is recommended to always use the profiles for configuring, because it might lead to misinterpretation to have the configuration in a file that is not seen in the interface. Therefore, the use of this file is recommended only for situations when many profiles are already created and it would take too long to modify them all. Custom settings offers a way to quickly configure settings that will affect all the connections, such as customizing the toolbar.

Apart from the initial values, the values that can be passed in the customSettings variable are most of those used in the connect method in the SDK. Add the overrideDefault value when using values that need it. This is specified in the connect method parameter reference.

•	The connect method.