It's easy to customise WebRES in a number of ways:

• Tweak settings using the Configuration Panel in Applications > WebXG WebRES > Config
• Modify texts displayed using the Translation Panel in Applications > WebXG WebRES > Translation
• Use the File Management Panel in Applications > WebXG WebRES > WebRES File Management to edit
  • HTML pages (page 1, rates page, edit, etc.)
  • Components for your branding (for example, see "Header Component" below), and individual widgets (like the "Pickup date" component)
  • CSS stylesheets
  • Location specific components.
  And to upload
  • New components
  • New stylesheets
  • Other assets (images, etc.)

WebRES by default shows a simple, unbranded view, designed to be placed into an iframe. In most cases, you will be able to easily embed the WebRES application into your own customized pages, and tweak the pages using the control panels described in this document.

In addition, it is possible to continue using your own application and its interfaces to your own backend systems (or possibly to other Thermeon systems such as WebXML) while using just certain WebRES pages.

Header Component

While the Header file itself can be edited, it is preferable to implement the 'mc/Header_addtitions' component to add code to this section of your WebRES. Any code within this component will automatically display in your Header thus leaving the original Header available for future updates.

Location specific components

Currently supported components

• "_sidebar", displayed in the left column on the review and save page. (webres format permitting).

Components must be saved via File Manangement in the locations/ directory with the file name representing the pickup location code, e.g "ABC12" followed by the supported component type e.g "_sidebar".

Example : locations/ABC12_sidebar

If the /locations/ directory does not exist in file management:

• Click "upload a new file" at the top most level.
• Enter "locations/ABC12_sidebar" as the filename (where "ABC12" is the pickup location number).

The customization panels

All the panels for customization require authorization. If you do not already have login details to WebXG authorized to make changes to your data and application, please contact our Support Team.

Configuration panel

Applications > WebXG WebRES > Config

This panel allows you to edit all configuration options. These are listed alphabetically and can be easily modified and changed.

You can see the "default" values set by Thermeon, and edit the keys for your application. Each value is described. For example: "Ask for the driver license information" (Yes|No)

Selecting the "Blank?" checkbox next to a setup variable, will force that variable not to have any value, but it will NOT use the DEFAULT value for that particular setup variable.

Press "Save Changes" to finish (or navigate away from the page to ignore changes).

Translation panel

Applications > WebXG WebRES > Translation

This panel allows you to edit the translations for the application.

You are presented with the edit page for your default language, but can change this by setting the "Select Language" dropdown and clicking "Edit Language".

The translation are categorized:

• 'Common' includes the basic translations.
• Other categories such as 'billto_info' group together translations regarding billing for example.
• The "conversion" translations such as "currency_code_conversion" are suffixed with conversion. You can add new keys to these entries by clicking on "add conversion". You can also edit the values for existing keys.

Editing a value:

1. Open a section by clicking on the title [+]
2. (You can close it again by clicking [-])
3. You will see the name of each key in the left hand column, and the default values for WebXG in the next column. You can edit the value by writing in the text box labelled "Client"
4. To show a blank translation (no text) click the "Blank?" checkbox.
5. To revert to using the default translation, clear the text and leave "Blank?" unchecked.
6. Save your changes by clicking the "Save Literals" at the top or bottom of the page.

Conversions are edited in the same way, however you can also edit the name of the key. The last line of the list is left blank for you to add a new entry. If you need to add more than one conversion translation at a time, you can click on the button "Add New Conversion" to add a new one.

Args Aliasing (alias_conversion)

• Args aliasing allows you to specify different names for variables in webres.
• An example use of args aliasing would be a referrer wanting to pass a location_id to your webres, which in reality is known as pickup_loc in WebRES.
• Args aliasing allows you to specify more than one args alias per variable, so that you can cater for different referrers passing different variable names. If a second referrer wanted to pass loc_id, you could also alias this to pickup_loc as well.
• This allows you to adapt webres to work around different naming conventions, without having to require additional development for 3rd party applications interacting with webres.
• To do this, you create a new alias_conversion literal called pickup_loc and a Client en value of the variable being passed into webres.

Default Values (default_value)

• You can also set default values for any field in WebRES.
• An example use, would be to set the default pickup_time to 09:00
• To do this, you create a new conversion literal called pickup_time and give it the default value of 09:00
• Another example, would be to set a default location so the literal would be called pickup_loc and the default value would be the location code as in CARS+

Customization panel

Applications > WebXG WebRES > WebRES File Management

The customization panel allows you to edit all HTML files in the WebRES application.

You start off viewing the details of "Page 1", index.html. The details of the page are listed, as well as the components that it calls.

You can navigate by clicking on any of the hyperlinked component paths, to view their detiails. Alternatively, you can navigate to another html file from the list at the top of the screen.

You can view the source of the component you are currently viewing by clicking "View source"

You can see whether you are using the default version ("Status: Unmodified") or a custom version (we log which user made the change and when).

To make changes click on the "Edit source" button. Make your changes and click "Save" at the bottom of the form. Your changes are effective immediately.

You can also revert to previous versions of a file by selecting the desired revision from the dropdown menu. This will show you the revision you have selected, and you may then save this as the new version if desired. This will create a new version from the old one.

To edit all files (including CSS and graphics) that aren't shown in the list of HTML files and components, you can browse a tree of all files by expanding the button "Show Tree". This file browser also gives you the option to "Upload a new file".

Uploading a new file allows you to choose a file by clicking "Browse..." You may optionally provide a filename, otherwise the file will retain the name of the uploaded file.