Imagine Español

Settings file

You can use a JavaScript Object Notation (JSON) file for mass configuration of Imagine Español settings. This feature is available in Imagine Español version 2.1.153 or later. The JSON settings file can be used with these apps:

  • Android
  • Mac
  • Windows (standalone)
  • Windows Store
 

Use of the settings file for mass configuration is not supported if you are running Imagine Español in a web browser with the Unity Web Player, or using the iPad app. See Chrome management to find out how to make a settings file for Chrome.

To create a settings file with the settings file generator

  1. Click to access the settings file generator.
  2. Enter information in the required fields.
  3. Click Generate. A configuration file is created.

To create a settings file manually

  1. Create a JSON file using a text editor of your choice.
  2. Name the file client_settings_espanol.json.
  3. Enter the desired keys and values and save the file.
  4. Validate the JSON file before you use it. You can access an online JSON validator tool by clicking here.
  5. Move the file to the proper location. Paths for each app are specified in the table below.
 

Use the EngineAddress key for Imagine Español deployment. Don't use two address keys in the same JSON file.

Imagine Learning JSON keys and values

Key

Value

EngineAddress

Enter any valid IP address or host name for Imagine Español deployment.

CachingMode

Enter the desired caching option. Options include CacheAsYouGoPreCache, and Streaming.

CustomBrowser

Enter the desired browser. Options include IEFirefoxSafari, and Chrome.

EnableHttps

Enter true or false. Use this setting if you are connecting to a secure on-premise server over HTTPS.

ProxyUser

Enter the username associated with the proxy server. This setting is supported in Windows and Mac standalone clients.

ProxyPassword

Enter the password associated with the proxy server. This setting is supported in Windows and Mac standalone clients.

WebProxy

Enter the IP address of your web proxy with a colon followed by your port number (e.g., 44.44.44.44:3128). This setting should be used only at sites experiencing issues related to using Imagine Español with a proxy server.

These values are case sensitive. Ensure that the syntax used in the JSON is correct. Each key should be entered within quotation marks. True and false values do not have quotation marks; all other values do. Commas are required after each value, except for the last. If you edit a JSON file using a Mac OS X text editor, smart quotes may invalidate the JSON.

On-premise deployment

            {
                "CachingMode": "CacheAsYouGo",
                "CustomBrowser": "Firefox",
                "EnableHttps": false,
                "EngineAddress": "imagine.district.k12.ut.us",
                "ProxyUser": "user1",
                "ProxyPassword": "password1"
                "webProxy": "44.44.44.44.:3128"
            }
        

Settings file locations

App

Path

Android

\Android Device\Internal storage\Android\data\com.ImagineLearning.IL\files\
client_settings.json

Mac

/Library/Application Support/Imagine Learning

Mac App Store

/Users/Username/Library/Containers/com.ImagineLearning.
ILM/Data/Library/Application Support/Library/Caches/client_settings.json

Windows

C:\ProgramData\Imagine\client_settings.json

Windows Store

%USERPROFILE%\AppData\Local\Packages\ImagineLearning
.ImagineLearning_q6aj84ys0e2nr\ LocalState\client_settings.json

 

The client_settings.json file works in conjunction with Imagine Español configuration. The local client_settings.json file will always override what it retrieves from Imagine Español; however, values received that are not currently set in the client_settings.json file will be updated.