Child pages
  • <uploads> tag

Contents




Introduction

The <uploads> tag contains a list of the URLs for uploading new designs onto the phone (For further description please see the detailed article: Phone Customization)



Syntax

This XML tag can be used either

  • inside the <settings> tag or

    <uploads>
     <file url=URL type=TYPE /> 
    </uploads>
  • as an individual XML file whose URL is listed inside <setting-files> tag

    <?xml version="1.0" encoding="utf-8" ?> 
    <uploads>
     <file url=URL type=TYPE /> 
    </uploads>

Old configuration < fw 8.9.3.60

 Click here to expand...

Where

  • URL = The URL of the customization tarball file (*.tar) to be uploaded onto the phone
  • TYPE =
    • following miscellaneous customization options:
      • gui: allows replacing the default Phone User Interface background images and icons by customized ones, see Branding Snom Deskphones
      • web: allows replacing the default Web User Interface images and stylesheets by customized ones, see Branding Snom Deskphones
      • font: allows replacing the default snom821,snom760, and snom870 Phone User Interface font by customized ones, see fonts (from V8.7.2 onwards)
      • defaults: allows replacing the default configuration parameter values by customized values, see Factory Defaults
      • license: allows replacing the current phone license with a new license to enable additional features. The license will be ignored if it's not valid (e.g. not matching the mac address of the phone) (from V8.7.2)
      • moh: allows uploading a local music on hold file (RAW PCMU 20ms) (from V8.7.3.7)
      • qml: allows replacing the default snom870 QML description. (from V8.7.4 onwards)
    • following allow replacing the default behaviour of the respective PUI state which is specified via XML:


Since version 8.9.3.60 all the original mentioned files can be found into the "Customisation archive file" released along with the firmware, so please refer to the firmware download page.

The following attributes are allowed:

  • e="2" defines that unicode-values inside xml-escapes (e.g. & # 6 4 ;) may be greater than 255.



Example

Branding Snom Deskphones

Create a XML file, e.g. branding.xml and copy it onto your Web (HTTP) Server, i.e. http://yourwebserver/branding.xml:

<?xml version="1.0" encoding="utf-8" ?>
<uploads>
  <file url="http://yourwebserver/branding/snom820_mypuidesign.tar" type="gui" /> 
</uploads>

Factory Defaults

To change default settings create a XML file e.g. default.xml with the settings which you want to change and copy it onto your Web (HTTP) Server, i.e. http://yourwebserver/default.xml:

<?xml version="1.0" encoding="utf-8"?>
<settings>
 <phone-settings>
    <webserver_type perm="">off</webserver_type>
    </phone-settings>
</settings>


Now create a second XML file e.g. uploads.xml and load it via webinterface/advanced/update/Setting URL:

<?xml version="1.0" encoding="utf-8" ?>
<settings>
  <uploads>
    <file url="http://yourwebserver/default.xml" type="defaults" />
  </uploads>
</settings>
Note: The changes will take effect after reset

PUI Menu

  1. See this How To for creating a new "state_stettings.xml".
  2. Create another XML file, e.g. menu.xml and load it via WUI --> Advanced --> Update --> Setting URL:

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

PUI fonts

  1. See this How To for creating a new font.tar
  2. Create a XML file, e.g. fonts.xml and load it via WUI --> Advanced --> Update --> Setting URL:

    <?xml version="1.0" encoding="utf-8" ?> 
     <uploads>
      <file url="http://yourwebserver/fonts.tar" type="font" />
    </uploads>