Tools

1.1.4 Update Manager

1.2 Assumptions

1.3 Conventions

• Mouseovers: Almost every image, icon, button, link or data field has a mouseover text. Please hover over these items to see a short description, and expanastion or shortcut key combination for an item. This user friendly feature is aimed at the novice user of a CMS.
• Shortcut keys: You do not need a mouse to work with W@S. Items are accessible with shorcut keys that are mentioned in the mouseover. Your browsers manual will tell you which keys to press in conjunction with the shortcut keys.
• Yellow status bar: The yellow bar will give status messages, for example:

  Data folder (cannot be changed lateron): filename not acceptable: 'grade 8'

  Confirmation or error messages will be displayed in this yellow bar. If necessary these messages can be copied and past in e-mail or forum posts for support.

• Pop up windows: Sometimes pop up windows are displayed together with the yellow status bar. They draw your attention and you have to turn them off to proceed. Read them, then click the [OK] button. The pop up messages are also displayed in the yellow status bar to cut and paste them.
• Text markup: Below are the text elements that have s special markup:
  • [Enter] or, for example [Alt-N]: To indicate that you can use the keyboard.
  • index.php: To indicate a file name.
  • Name: The bold underlined character of field titles identfy the keyboard shortcut that can be used to access or modify the item. Your browsers manual will tell you which keys to press in conjunction with the bold underlined character.
  • [D] or, for example [P]: In high visibility mode (for blind an dvisually impaired persons) the first one indicates the Trashcan (Delete). The second one indicates the Page preview icon.
  • Private area [  ] Mark ... etcetera: The [  ] in a text indicates a checkbox.
  • Add a page or, for example Area: A blue text refers to the same text in a screenshot.
  • Add an area, or for example Page Manager: Bold text refers to an item that is visible in a screen shot

(top)

2. Tools manager overview

To go to the Tools manager, please click on the Tools Manager icon to open its main window:

tools_open.png

The opening screen is split in two parts, the menu part and the management part.

• Menu: The Menu part has two modes:
  • Task selection: You can select a specific management task, Translate Tool, Backup Tool, Log View and Update Manager. By clicking on one of the items it's chosen, becomes underlined and is opened in the managing part.
  • Managing a task: When Translate Tool, Backup Tool, Log View or Update Manager is chosen, its configuration fields become available. T

(top)

3. Translate Tool

3.1 Translate Tool Overview

In the Menu, clicking the 'Translate Tool' link brings you to the Translate Tool overveiw:

tools_translatee_tool_open.png

Explanation:

• Menu: The selected item is underlined.
• Translate Tool: An overview of its options:
  • Add a language: Clicking on this link brings you to the 'Add a new language' dialogue. Adding a language is discussed in section 3.2 Add a new language.
    Mouseover:
    - [click here to add a new language]
    
  • Pencil icon: Clicking on the pencil brings you to the 'Edit language properties' dialogue. These options will be discussed below in sections 3.4 Edit language properties.
    Mouseover:
    - [edit language properties]
  • Language name: This link has the form: Lanaguage name in that language (2 characters language code). These options will be discussed below in section 3.4 Edit language properties.
    Mouseover:
    - [click here to edit translations for this language]

3.2 Add a new language

tools_translatee_tool_add_language.png

Explanation:

• Language code (ISO 639): A two or three character code must be entered here that corresponds with the language to be created. For details on the country codes see: http://www.w3.org/WAI/ER/brIG/ert/iso639.htm to choose the correct code. Don't mind the 'obsolete'. It works fine. For further details on this matter, see Wikipedia on http://en.wikipedia.org/wiki/ISO_639.
• Name (expressed in the language itself): Enter the name of the language, for example: Deutsch, Français.
• Parent language: The dropdown menu enables you to select a language (if available). By translating these words and sentences, you replace the chosen language with the translation.
  If the default (none) is selected, English will be the parent language.

  NOTICE:
  Thechoise of the parent language is a permanent choise and cannot be changed.

• Mark the language as active: When the box is checked the language is selectable by the users in their language selection. See Account manager, section 2.3 Give the user privileges.
• Save: To save your results. After saving your work, the newly created language will appear in the list of languages, ready for further action.
  Mouseover:
  - [use Alt-S or Cmnd-S as a keyboard shortcut for this button]
• Cancel: To cancel your action and return to the Translate Tool overview.
  Mouseover:
  - [use Alt-C or Cmnd-C as a keyboard shortcut for this button]

When the results are saved, the language is added:

tools_translatee_tool_language_added.png

3.3 Translate a language

NOTICE: Please read the instructions carefully before starting to translate. Here they are again:

Translation for Français (fr) - General

NOTICE:
The best way of working is to not even touch things like {HOTKEY}, {SITENAME}, {ALERTS}, etcetera. In short: stay out of stuff in RED!

Also note the '~' (tilde) is used as a shorthand notation to define hotkeys in dialogs. For example, a field labeled ~File could be selected by pressing the keycombination [Alt-F] or [Cmnd-F]. The German translation could be ~Datei, with hotkey [Alt-D] or [Cmnd-D].
It is important that a hotkey is unique within a dialog, i.e. if you, the translator, have used the letter D already in that dialog, your German translation might become Dat~ei, yielding hotkey [Alt-E] or [Cmnd-E].
In short: it is up to you, the translator, to choose a good set of hotkeys by carefully placing the tildes.

tools_translatee_tool_translate_language_top.png

tools_translatee_tool_translate_language_bottom.png

• Submit this translation: Leave this option checked. Better submit a an unfinished translation than to forget it accidentally.
• Translator name: Enter your name here.
• Translator email address: Enter your email address, so we can reach you if necessary.
• Translator notes: Space for your own notes or a message to us.
• Save: To save your results and submit the translation. After saving you stay in the same dialogue.
  Mouseover:
  - [use Alt-S or Cmnd-S as a keyboard shortcut for this button]
• Cancel: To cancel your action and return to the translate tool overview.
  Mouseover:
  - [use Alt-C or Cmnd-C as a keyboard shortcut for this button]

3.4 Edit language properties

tools_translatee_tool_edit_language_properties.png

Explanation:
NOTICE: This dialogue is the same as the 'Add a language' dialogue. You can correct errors in the name of the language and change 'active'. The language code and parent language cannot be changed.

• Language code (ISO 639): The chosen language code cannot be changed. This is a feture.
• Name (expressed in the language itself): Errors can be corrected
• Parent language: Cannot be changed.
• Mark the language as active: When the box is checked the language is selectable by the users in their language selection. See Account manager, section 2.3 Give the user privileges.
• Save: To save your results. After saving you return to the Translate Tool overveiew.
  Mouseover:
  - [use Alt-S or Cmnd-S as a keyboard shortcut for this button]
• Cancel: To cancel your action and return to the Translate Tool overview.
  Mouseover:
  - [use Alt-C or Cmnd-C as a keyboard shortcut for this button]

3.5 Small language adaptions

• Go the the right place for the text
• Make the changes and save them.
• Enjoy your chages.
• Send them to us.

(top)

4. Backup tool

4.1 Database backup

tools_backup_tool_open.png

Explanation:
To create a backup, proceed as follows:

• Click on the link 'Download Backup'.
• A window on your own computer opens.
• Select a directory to save the backup. The backup has a name like:
  exemplum.eu-was-was-20110104-185127.zip Which reads as: [ebsite]-[database name]-[prefix]-[YYYMMDD]-[hhmmss].zip.
• Ready!

4.2 Data backup

All docs and pics are not backed up.
They are in the CMS data foler. Example:
/home/httpd/wasdata/md5/ 

(top)

5. Log viewer

tools_log_viewer_open.png

(top)

6. Update manager

Download the upgrade (either a program update, or a manual, language or module update ) and unzip or untgz jin the CMS Root Folder. After unzipping, log in wiht the root account (webmaster, Wilhelmina Bladergroen). For a core update you are directly sent to the Update Manager dialogue.
For other updates, go Tools > Update manager.

6.1 Core update

Log in as webmaster to be directed to the Update Managerdialogue:

tools_update_manager_core_update.png

Depending on the performed upgrade differences in internal and external version numbers can be observed, as well as, in the Status column Update:

tools_update_manager_core_updated.png

WRONG PIC

After pressing the Update link, the internal and external versn numbers correspond and your Website@School is updated, up and running.

NOTICE:
Further information on the internal version number can be found in chapter Configuration Manager, paragraph 6. Site

6.2 Other updates

tools_update_manager_language_update.png

(top)

7. Concluding remarks

(top)