Resources

English

The IPPhoneMenu displays a Menu of selectable items. These items can either be sub-menus, containing items themselves, or items with a specific target, like URLs, key-events or internal callbacks.

For this how to, we will create an example menu for setting features for incoming calls. The menu will include two menu items: The first one to switch server managed DND on/off, a second one to configure Call Forward.

Create a new

...

IP Phone Menu

Code Block

language	xml
linenumbers	true

<?xml version="1.0" encoding="UTF-8"?>
<IPPhoneMenu>
	<Menu>
	</Menu>
</IPPhoneMenu>

Adding menu items

New items can be added to the XML menu with the <MenuItem></MenuItem> tag.
To give the menu item a name, add name="" to the tag. You can give it a static name, or use the $(lang:SETTING) variable. With this, the item name will be translated automatically to the language the user has selected on the phone.
For further references, you can assign an ID to the menu item. We will use id="serverDnd" and id="serverCfw" for our two menu items.

...

Code Block

language	xml
linenumbers	true

<SnomIPPhoneMenu>
	<MenuItem Name="$(lang:incoming_calls_settings)">
		<MenuItem name="$(lang:dnd_line)" id="serverDnd">
		
		</MenuItem>
		<MenuItem "$(lang:redirect_settings)" id="serverCfw">


		</MenuItem>
	</MenuItem>
</SnomIPPhoneMenu>

Subtext

You can also use the tag

...

<SubText> to display more information, e.g. which submenus lay behind the menu item.

Code Block

language	xml
linenumbers	true

<SnomIPPhoneMenu>
	<MenuItem name="$(lang:auto_dial)">
		<SubText>
			$(lang:redirect_settings), $(lang:outgoing_calls_settings), $(lang:incoming_calls_settings), $(lang:xsi_anywhere)
		</SubText
	</MenuItem>
</SnomIPPhoneMenu>

Adding pre-loaded icons to the menus

The phone comes equipped with a couple of icons that are used in different call states and features. You can find the icons in the customisation package of each firmware version in the folder:

bmp → colored

Folder	Description
background_images	Stores the background image of the phone
call_icons	Stores the icons for the different call states, such as connected, ringing, busy, etc.
call_overlay	Status indication rings for contact images
contact_state_icons	Icons for different contact states, such as available, away, busy, etc. These icons are used when there is no contact picture provided.
contact_state_overlays	Icon rings for different contact states, such as available, away, busy, etc. These icons are used when there is a contact picture provided.
contact_type_icons	Icons for the contacts in the phone address book. E.g. friends, VIP, family, work, etc.
extraicontype_icons	Icons for the phone menus, smartLabels (WiFi, headset); check boxes, arrows, conference active, and many more
fkey_icons	Icons that are used on for fkey labelling
icontype_icons	icons of the hard function keys (transfer, settings, address book, hold, etc.) on the phone
identity_state_icons	Icons to indicate the state of an identity in idle screen, such as silent ringer, forwarding active, keyboard lock
input_info_images	icons for the setup wizards of smartTransfer and smartConference
other_images	mainly images for the analog clock and a few others
settings_window_icons	icons for setting brightness, contrast, and different volume settings. These are overlay icons with a bar in the middle.
titlebar_icons	Icons for the titlebar, such as headset, calendar cards, mute, reboot, speaker, etc.

You can refer to any of these icons in your XML code. To display an icon from the folder extraicontype_icons, simply add:

Code Block

language	xml
linenumbers	true

<SnomIPPhoneMenu>
	<MenuItem name="$(lang:auto_dial)">
		<ExtraIconType>$(icon_type_enum:kIconTypePhoneStateDND)</ExtraIconType>
		<URL>https://ds.cloud-cfg.com/snom/0004139227B7/8fb1ba7b28291a0c0192cbefec44366759a668c0f888397ec3cb6cf69a82be5d/autodialset/0</URL>
	</MenuItem>
</SnomIPPhoneMenu>

Submenus

You can indicate to the user that there are submenus behind that menu time, by showing the arrow_right icon (Image Modified) next to the name of the menu item. For this add the following tag to your XML code:

Code Block

language	xml
linenumbers	true

<ExtraIconType>$(icon_type_enum:kIconTypeMenuArrowRight)</ExtraIconType>

Note

title	Further Information

...

Include Page

	Howto Footer - en
	Howto Footer - en

German

Pagetitle

	Wie man benutzerdefinierte XML-Menüs auf Farbbildschirmtelefonen erstellt - Firmware-Version 10.x
	Wie man benutzerdefinierte XML-Menüs auf Farbbildschirmtelefonen erstellt - Firmware-Version 10.x

Das IPPhoneMenu zeigt ein Menü mit wählbaren Elementen an. Diese Elemente können entweder Untermenüs sein, die Elemente selbst enthalten, oder Elemente mit einem bestimmten Ziel, wie URLs, Key-Events oder interne Rückrufe.

Für dieses How to erstellen wir ein Beispielmenü zur Einstellung von Funktionen für eingehende Anrufe. Das Menü enthält zwei Menüpunkte: Der erste, der das servergesteuerte DND ein- und ausschaltet, der zweite, der die Rufumleitung konfiguriert.

Ein neues IP-Telefonmenü erstellen

Code Block

language	xml
linenumbers	true

<?xml version="1.0" encoding="UTF-8"?>
<IPPhoneMenu>
	<Menu>
	</Menu>
</IPPhoneMenu>

Hinzufügen von Menüpunkten

Neue Elemente können dem XML-Menü mit dem Tag <MenuItem></MenuItem> hinzugefügt werden.
Um dem Menüpunkt einen Namen zu geben, fügen Sie dem Tag name=""" hinzu. Sie können ihm einen statischen Namen geben oder die Variable $(lang:SETTING) verwenden. Damit wird der Elementname automatisch in die Sprache übersetzt, die der Benutzer am Telefon ausgewählt hat.
Für weitere Referenzen können Sie dem Menüpunkt eine ID zuweisen. Wir werden id="serverDnd" und id="serverCfw" für unsere beiden Menüpunkte verwenden.

Code Block

language	xml
linenumbers	true

<SnomIPPhoneMenu>
	<MenuItem Name="$(lang:incoming_calls_settings)">
		<MenuItem name="$(lang:dnd_line)" id="serverDnd">
		
		</MenuItem>
		<MenuItem "$(lang:redirect_settings)" id="serverCfw">


		</MenuItem>
	</MenuItem>
</SnomIPPhoneMenu>

Subtext

Sie können auch das Tag <SubText> verwenden, um weitere Informationen anzuzeigen, z.B. welche Untermenüs hinter dem Menüpunkt stehen.

Code Block

language	xml
linenumbers	true

<SnomIPPhoneMenu>
	<MenuItem name="$(lang:auto_dial)">
		<SubText>
			$(lang:redirect_settings), $(lang:outgoing_calls_settings), $(lang:incoming_calls_settings), $(lang:xsi_anywhere)
		</SubText
	</MenuItem>
</SnomIPPhoneMenu>

Hinzufügen von vorinstallierten Symbolen zu den Menüs

Das Telefon ist mit einer Reihe von Symbolen ausgestattet, die in verschiedenen Anrufzuständen und Funktionen verwendet werden. Sie finden die Symbole im Anpassungspaket jeder Firmware-Version im Ordner:

bmp → colored

Ordner	Beschreibung
background_images	Speichert das Hintergrundbild des Telefons.
call_icons	Speichert die Icons für die verschiedenen Anrufzustände, wie z.B. verbunden, klingelnd, besetzt, etc.
call_overlay	Statusanzeige "klingelt" für Kontaktbilder
contact_state_icons	Icons für verschiedene Kontaktzustände, wie z.B. verfügbar, entfernt, besetzt, etc. Diese Icons werden verwendet, wenn kein Kontaktbild vorhanden ist.
contact_state_overlays	Icon-Ringe für verschiedene Kontaktzustände, wie z.B. verfügbar, entfernt, besetzt, etc. Diese Icons werden verwendet, wenn ein Kontaktbild zur Verfügung steht.
contact_type_icons	Icons für die Kontakte im Telefon-Adressbuch. Z.B. Freunde, VIP, Familie, Arbeit, etc.
extraicontype_icons	Icons für die Telefonmenüs, smartLabels (WiFi, Headset); Kontrollkästchen, Pfeile, Konferenz aktiv, uvm
fkey_icons	Icons, die für die Tastenbeschriftung verwendet werden.
icontype_icons	Icons der Tasten (Übertragung, Einstellungen, Adressbuch, Halten, etc.) auf dem Telefon.
identity_state_icons	Icons zur Anzeige des Status einer Identität im Ruhezustand, wie z.B. stiller Klingelton, Weiterleitung aktiv, Tastatursperre
input_info_images	Icons für die Einrichtungsassistenten von smartTransfer und smartConference
other_images	Hauptsächlich Bilder für die Analoguhr und einige andere.
settings_window_icons	Icons zum Einstellen von Helligkeit, Kontrast und verschiedenen Lautstärkeeinstellungen. Dies sind Overlay-Icons mit einem Balken in der Mitte.
titlebar_icons	Icons für die Titelleiste, wie z.B. Headset, Kalenderkarten, Mute, Neustart, Lautsprecher, etc.

Sie können auf jedes dieser Symbole in Ihrem XML-Code verweisen. Um ein Symbol aus dem Ordner extraicontype_icons anzuzeigen, fügen Sie es einfach hinzu:

Code Block

language	xml
linenumbers	true

<SnomIPPhoneMenu>
	<MenuItem name="$(lang:auto_dial)">
		<ExtraIconType>$(icon_type_enum:kIconTypePhoneStateDND)</ExtraIconType>
		<URL>https://ds.cloud-cfg.com/snom/0004139227B7/8fb1ba7b28291a0c0192cbefec44366759a668c0f888397ec3cb6cf69a82be5d/autodialset/0</URL>
	</MenuItem>
</SnomIPPhoneMenu>

Untermenüs

Sie können dem Benutzer anzeigen, dass sich hinter dieser Menüzeit Untermenüs befinden, indem Sie das Pfeil_rechts-Symbol (Image Added) neben dem Namen des Menüpunkts anzeigen. Füge dazu das folgende Tag zu deinem XML-Code hinzu:

Code Block

language	xml
linenumbers	true

<ExtraIconType>$(icon_type_enum:kIconTypeMenuArrowRight)</ExtraIconType>

Include Page

	Howto Footer - de
	Howto Footer - de

Content by Label

showLabels	false
spaces	PW
showSpace	false
sort	title
type	page
cql	label in ("xml","gui","minibrowser","customisation") and type = "page"
labels	xml minibrowser customisation gui

...

Space shortcuts

Child pages

Features/HowTo´s

I Need

Firmware

Features/HowTo´s

Ich brauche

Firmware

Versions Compared

Old Version 2

New Version Current

Key

Create a new

IP Phone Menu

Adding menu items

Subtext

Adding pre-loaded icons to the menus

Submenus

Ein neues IP-Telefonmenü erstellen

Hinzufügen von Menüpunkten

Subtext

Hinzufügen von vorinstallierten Symbolen zu den Menüs

Untermenüs

Snom - Technology GmbH

Resources

Knowledge Base

Company

Follow Snom