
Custom Background Images
You can provide users with a choice of background images for the LCD screen on their phones. Users can
select a background image by choosing
Settings
>
User Preferences
>
Background Images
on the phone.
The image choices that users see come from PNG images and an XML file (called List.xml) that are stored
on the TFTP server that the phone uses. By storing your own PNG files and editing the XML file on the TFTP
server, you can designate the background images from which users can choose. In this way, you can provide
custom images, such as your company logo.
The following sections describe how you can customize the background images that are available at your site
by creating your own PNG files and editing the List.xml file.
List.xml File Format Requirements
The List.xml file defines an XML object that contains a list of background images. The List.xml file is stored
in the following subdirectory on the TFTP server:
•
/Desktops/320x212x16 for Cisco Unified IP Phone 7945 and 7965
•
/Desktops/320x212x12 for Cisco Unified IP Phone 7971 and 7970
•
/Desktops/320x212x12 for Cisco Unified IP Phone 7975
If you are manually creating the directory structure and the List.xml file, you must ensure that the directories
and files can be accessed by the user\CCMService, which is used by the TFTP service.
Tip
For more information, see
“
Software Upgrades
”
chapter in
Cisco Unified Communications Operating System
Administration Guide
.
The List.xml file can include up to 50 background images. The images are in the order that they appear in the
Background Images menu on the phone. For each image, the List.xml file contains one element type, called
ImageItem. The ImageItem element includes these two attributes:
•
Image: Uniform resource identifier (URI) that specifies where the phone obtains the thumbnail image
that will appear on the Background Images menu on a Phone.
•
URL: URI that specifies where the phone obtains the full size image.
The following example (for a Cisco Unified IP Phone 7971G-GE and 7970G) shows a List.xml file that defines
two images. The required Image and URL attributes must be included for each image. The TFTP URI that
displays in the example is the only supported method for linking to full size and thumbnail images. HTTP
URL support is not provided.
List.xml Example
<CiscoIPPhoneImageList><ImageItem
Image=
”
TFTP:Desktops/320x212x12/TN-Fountain.png
”
URL=
”
TFTP:Desktops/320x212x12/Fountain.png
”
/>
<ImageItem Image=
”
TFTP:Desktops/320x212x12/TN-FullMoon.png
”
URL=
”
TFTP:Desktops/320x212x12/FullMoon.png
”
/>
</CiscoIPPhoneImageList>
Cisco Unified IP Phone 7975G, 7971G-GE, 7970G, 7965G, and 7945G Administration Guide for Cisco Unified
Communications Manager 9.0 (SCCP and SIP)
168
Cisco Unified IP Phone Customization
Custom Background Images