Languages and Dictionaries

Site Managers can create system navigation and messages in multiple languages. Offering the system in several languages allows individuals to choose their preferred language.

Dictionaries allow a Site Manger to update system labels. Site Managers can create multiple dictionaries based on language. A dictionary contains a collection of labels used by the system to name items such as links, buttons, and features. A custom dictionary allows you to use familiar terminology instead of adapting to the system defaults.

Access languages and dictionaries via the Control Panel tab in the main navigation bar.

dictionaries-manage-list

Edit a Dictionary Label

  1. Log in with a Site Manager account.
  2. Navigate to Dictionaries from the Control Panel tab. dictionaries-navigation
  3. Select Edit Labels for the dictionary that contains the labels you want to update.
    dictionaries-edit-labels-2
    Edit Labels from detailed view.
    dictionaries-edit-labels
    Edit Labels from list view.
    1. Optionally use the Filter Options to find a specific label. dictionaries-filterIf you cannot see the Filter Options menu, select the < Show Panel Tool on the right-hand side of the screen.
      delete-bundles-b
      • Variable label contains: Enter a word contained in the system label (e.g. "product" will present a list of system labels containing the term product). Variable labels are static and cannot be updated.
      • Display text contains: Enter a word contained in the text for the label (e.g. enter the term “course” to view a list of labels using the term “course”).  Display text can be uddated.
    2. Optionally export the English dictionary as a CSV file to help you translate the labels or send the file off to someone else to translate (see Export Labels).
    3. Select Save and Finish at the bottom of the page to keep the changes or Cancel to return to the dictionaries page without saving the changes. Saved changes are immediately visible in the system. You can save your work and return to updating the labels later.

    callout-infoNew labels are periodically added due to new development. Site Managers are responsible for keeping the dictionary labels up to date. 

    Edit a Label in all Dictionaries

    dictionary-update-by-label-page

    1. Log in with a Site Manager account.
    2. Navigate to Dictionaries from the Control Panel tab. dictionaries-navigation
    3. Select Update by Label in the Tools menu.dictionary-update-by-labelIf you cannot see the Tools menu, select the < Show Panel Tool on the right-hand side of the screen.delete-bundles-b
    4. Enter the exact label or a term used in a label into the Filter Labels field.  
      dictionary-update-by-label-filter

      callout-infoUse the dictionary filter tool in one dictionary to find the system label that you need and then copy/paste it into the Filter Labels field (see Filter Options in the Edit a Dictionary Label section).

    5. Select the label from the filtered list and then select Display to list the selected labels for editing.
      dictionary-update-by-label-display
      callout-info

      Use ctrl+click to select mulitple filters or shift+click to select all filters.

    6. Enter the terms into the Label Text fields (see Edit a Dictionary Label).
      dictionary-update-by-label-fields
    7. Select Save and Finish at the bottom of the page to keep the changes or Cancel to return to the dictionaries page without saving the changes. Saved changes are immediately visible in the system. You can save your work and return to updating the labels later.

    Export Labels

    A Site Manager can export all of the labels in a dictionary with the defined display text into a CSV file. The file can be used offline to review all of the terms within a dictionary. This can be particularly helpful when collaborating with others or sending the terms away to be translated into another language.  

    1. Log in with a Site Manager account.
    2. Navigate to Dictionaries from the Control Panel tab. dictionaries-navigation
    3. Select Edit Labels for the dictionary you want to export.
      1. dictionaries-edit-labels-2
        Edit Labels from detailed view.
        dictionaries-edit-labels
        Edit Labels from list view.
      2. Select Export Dictionary in CSV from the Tool menu on the right. If you cannot see the Filter Options menu, select the > arrow to open or close the menu.
        dictionary-export

       

      Edit Name or Description

      A dictionary name or dictionary description can be updated at any time.

      1. Log in with a Site Manager account.
      2. Navigate to Dictionaries from the Control Panel tab. dictionaries-navigation
      3. Select a dictionary name or Details Edit to change the name or description of the selected dictionary.
        dictionary-change-name-detailed-view
        Edit name or details from detailed view.
        dictionary-change-name-list-view
        Edit name or details from list view.
      4. In the edit screen, enter the new name and/or descripton into the fields. Descriptions can be 255 characters long. dictionary-change-name-edit-screen
      5. Select Save to keep the changes or Cancel to return to the dictionaries page without saving the changes.

      Create a New Language

      Site Managers can create a new language. For each new language that is created, there is automatically one default dictionary generated that you can customize. A Site Manager may also opt to create any number of additional dictionaries for a language. (see Create a New Dictionary). 

      1. Log in with a Site Manager account.
      2. Select Language from the control panel.
        language-navigation
      3. Select Create from the Language Options menu on the right side. If you cannot see the Language Options menu, select the > arrow to open or close the menu.
        language-createIf you cannot see the Language Options menu, select the Show Panel Tool. It looks like a left-pointing arrow on the right-hand side of the screen.
        delete-bundles-b
      4. Enter the Language Name and set the Status to active or inactive.
        language-name
      5. Save. For each new language that is created, a new dictionary is automatically generated. After saving you will be taken to the new dictionary so you can customize it.
      6. Populate each dictionary label with new language terms (see Edit a Dictionary Label). You can save your work and return to the dictionary later via the Control Panel.
      7. Optionally set up email notifications (see Email Notifications). Notifications for a new language are disabled, so a Site Manager must configure any email notifications. 

      callout-infoAn active language is available to all campuses.  

      Create a New Dictionary

      Site Managers can create a new dictionary without creating a new language. These are called additional dictionaries. Additional dictionaries are used to provide an alternate set of terms for any language (e.g. if your organization has both internal users and public users, you may want to have an alternate English dictionaries so that internal users see terminology that is familiar to their own environment and the public users see terminology that is more generally relevant to them).

      1. Log in with a Site Manager account.
      2. Select Dictionaries from the control panel.
        dictionaries-navigation
      3. Select Create from the Dictionary Options menu on the right side. If you cannot see the menu, select the > arrow to open or close the menu.
        dictionary-create
      4. Complete the form.
        dictionary-create-form
        1. Enter the Dictionary Name.
        2. Use the Language drop-down menu to choose a language for the new dictionary. 
        3. Use the Base Dictionary drop-down menu to choose a dictionary.  The new dictionary will use the same labels as the selected base dictionary until you update them.
        4. Enter an optional Description of no more than 215 characters.
        5. Set the Status to active or inactive. Only active dictionaries can be accessed.
      5. Save. After saving you will be taken to the dictionary labels so you can customize them.
      6. Populate each dictionary label with new terms following the instructions in Edit a Dictionary LabelYou can save your work and return to the dictionary later via the Control Panel.
      7. Assign the new dictionary to applicable campuses.
        1. From the Dictionaries page, scroll down to Additional Dictionaries and then select Campuses for the new dictionary.
        2. Add the campuses that will use this dictionary.
          Add campuses from detailed view.
          Add campuses from list view.

          1. Save. 
        3. Optionally set up email notifications following the instructions in Email Notifications

        Find Missing Labels

        Site Managers can filter dictionary labels to view only the lables that are not defined.

        1. Log in with a Site Manager account.
        2. Navigate to Dictionaries from the Control Panel tab. dictionaries-navigation
        3.  Select the Show Missing icon for the applicable dictionary.
          dictionary-show-missing
        4. Enter a new term for each label displayed (see Edit a Dictionary Label).
        5. Select Save and Finish at the bottom of the page to keep the changes or Cancel to return to the dictionaries page without saving the changes. Saved changes are immediately visible in the system. You can save your work and return to updating the labels later.

        Display Dictionary Users

        A Site Manager can view which campuses or accounts make use of a specific dictionary. This can be espcially useful when considering inactivating or deleting a language or dictionary.  

        1. Log in with a Site Manager account.
        2. Navigate to Dictionaries from the Control Panel tab. dictionaries-navigation
        3. Select Display Users or Campuses for the applicable dictionary.
          Display users or campuses using detailed view
          Display users and view  campuses from detailed view.
          Display users and view campuses from list view; the numbers are links.
          1. Optionally use the sort options menu on the right to change how the user list is displayed. If you cannot see the menu, select the > arrow to open or close the menu.
            dictionaries-users-sort
          2. Optionally change an individual's language.  Select a name on the display to open their profile page and then use the language the drop down menu to select a new default language. 
            dictionaries-users-profile

           

          Deactivate a Language or Dictionary

          1. Log in with a Site Manager account.
          2. Languages and dictionaries cannot be deactivated if there are any campuses or indivuduals assigned. A Site Manager must first reassign a campus to another language and define a new language for these indivuduals within their profile before proceeding.
          3. Navigate to  Language or Dictionaries as applicable from the Control Panel tab. 
            dictionaries-and-languages-navigation
          4. To deactivate a language, use the drop down menu to change the status of the selected language to inactive. 

          Delete a Language/Dictionary

          callout-infoLanguages and dictionaries (including additional dictionaries) cannot be deleted until organizations and users associated with the langauage or dictionary and are reassigned to a different dictionary.

           

          1. Log in with a Site Manager account.
          2. Navigate to Language or Dictionaries as applicable from the Control Panel tab.  Deleting a language will permanently remove the associated default dictionary.  
            dictionaries-and-languages-navigation
          3. Select the area containing the language or additional dictionary to delete to highlight it. Only Additional Dictionaries can be deleted directly from the Dictionaries page. 
          4. Select Delete Selected from the Language Options or Dictionary Options menu to the right as applicable. A prompt will appear to confirm the deletion. If you cannot see the menu, select the > arrow to open or close the menu.

          callout-dangerDeleting the language will permanently remove the associated dictionary.