Category:HowTo:PUI Menu
From Snom User Wiki
Author: Alexander Feldt
Contents |
Preconditions
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 8.7.3.7.
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):
- state_settings 8.9.3.15
- state_settings 8.7.5.x
- state_settings 8.7.3.25
- state_settings 8.7.3.19
- state_settings 8.7.3.10
- state_settings 8.7.3.7
- state_settings 8.7.2.9
- state_settings 8.4.35
- state_settings 8.4.32
- state_settings 8.4.31
- state_settings 8.4.18
Step 2
Edit the XML menu description file using a XML editor in order to make simple changes to the menu. Possible Editors are:
- Windows: Notepad++
- Mac: TextWrangler
- Linux:
Docbook: http://www.oasis-open.org/docbook TEI: http://www.tei-c.org Oxgarage: http://www.tei-c.org/oxgarage Saxon: http://www.saxonica.com Sade (Scalable Architecture for Digital Editions): http://www.bbaw.de/telota/software/sade XFT: http://xtf.cdlib.org XML Copy Editor: http://xml-copy-editor.sourceforge.net Textgrid Lab: http://www.textgridlab.org Oxygen XML Editor: http://www.oxygenxml.com Forschungsverbund Textgrid: http://www.textgrid.de Subversion-Repository Textgrid Lab: https://develop.sub.uni-goettingen.de/repos/textgrid Wörterbuchnetz der Universität Trier: http://woerterbuchnetz.de Eclipse: http://www.eclipse.org
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
Before
Delete the line marked red/bold
<?xml version="1.0" encoding="UTF-8"?> <SnomIPPhoneMenu> <Title>$(lang:menu100_settings)</Title> <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> </Menu> <MenuItem name="$(lang:menu_equalizer)"><Action>equalizer</Action></MenuItem> </Menu> ...
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.
state_settings.xml
Create another XML file, e.g. menu.xml
<?xml version="1.0" encoding="utf-8" ?> <uploads> <file url="http://yourwebserver/state_settings.xml" type="gui_xml_state_settings" /> </uploads>
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:
Troubleshooting
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.