Category:HowTo:PUI Menu

From Snom User Wiki

Jump to: navigation, search

Author: Alexander Feldt



This feature is available on snom IP phones from firmware 8.4.18 onwards.
For snom 300 and snom 320 this feature is only available from version

Step 1

Download the default menu XML description from the phone using one of the following links (depending on the firmware version the phone is running):

Step 2

Edit the XML menu description file using a XML editor in order to make simple changes to the menu. Possible Editors are:

   Sade (Scalable Architecture for Digital Editions):
   XML Copy Editor:
   Textgrid Lab:
   Oxygen XML Editor:
   Forschungsverbund Textgrid:
   Subversion-Repository Textgrid Lab:
   Wörterbuchnetz der Universität Trier:

If you want to create new menu structures or apply bigger changes you will need a XML schema to validate the syntax.

Save your changes with the original file name, i.e. as "state_settings.xml"

Step 3

Upload the file onto the phone by means of XML Auto Provisioning. Read this chapter or check the example below.

After reboot you should see the differnt changes made to the menu structure.

Example: Delete menu entry "Timezone" from the "Preferences" menu


Delete the line marked red/bold

<?xml version="1.0" encoding="UTF-8"?>
 <Menu name="$(lang:preferences_settings)">
   <MenuItem name="$(lang:menu100_timezone)"><Action>timezone</Action></MenuItem>
   <MenuItem name="$(lang:menu100_dialtone)"><Action>dialtone</Action></MenuItem>
   <MenuItem name="$(lang:menu_gen_ringtone)"><Action>ringtone</Action></MenuItem>
   <MenuItem name="$(lang:language)"><Action>language</Action></MenuItem>
   <Menu name="$(lang:display_settings)">
     <MenuItem name="$(lang:use_backlight) $(lang:backlight_when_active)"><Action>backlight_active</Action></MenuItem>
     <MenuItem name="$(lang:use_backlight) $(lang:backlight_when_idle)"><Action>backlight_idle</Action></MenuItem>
     <MenuItem name="$(lang:menu_gen_contrast)"><Action>contrast</Action></MenuItem>
     <MenuItem name="$(lang:use_backlight)"><Action>use_backlight</Action></MenuItem>
   <MenuItem name="$(lang:menu_equalizer)"><Action>equalizer</Action></MenuItem>

Save the changed menu file and upload it onto the phone (via Auto Provisioning or manual redirection of the setting server)

Save the file with its original name, e.g.


Create another XML file, e.g. menu.xml

<?xml version="1.0" encoding="utf-8" ?> 
  <file url="http://yourwebserver/state_settings.xml" type="gui_xml_state_settings" />

and copy it onto your Web (HTTP) Server, i.e. http://yourwebserver/menu.xml:

Copy the URL (http://yourwebserver/menu.xml) and paste it into the Setting URL field and press Save

A reboot is required --> Press Reboot and confirm.

Check the result of your changes

The menu entry "Timezone" has disappeared from the "Preferences" menu:


Check the Log page for the following messages

[5] 24/12/2001 00:00:48: Setting server was already set: http://yourwebserver/menu.xml
[5] 24/12/2001 00:00:48: Fetching URL: http://yourwebserver/menu.xml
[5] 24/12/2001 00:00:49: read_xml_settings: found uploads XML header
[5] 24/12/2001 00:00:49: read_xml_settings: found one byte encoding: 1
[5] 24/12/2001 00:00:49: read_upload_list: Found data upload type >gui_xml_state_settings< !
[5] 24/12/2001 00:00:49: Conf setup: found xml style settings
[5] 24/12/2001 00:00:49: Fetching URL: http://yourwebserver/state_settings.xml

This category currently contains no pages or media.

Personal tools