Documentation Center

Configuring mobile devices available for preview

The Phones.xml is the Mobile Simulator configuration file which lists the types of mobile devices for which you want to be able to preview content in the Content Manager Explorer or SiteEdit.

About this task

The Phones.xml consists of the following sections that define a default set of the most popular mobile devices available for preview in Content Manager Explorer on the most popular operating systems:

  • <os name="Android">
  • <os name="Apple iOS">
  • <os name="Bada">
  • <os name="HP webOS">
  • <os name="Moto">
  • <os name="Rim">
  • <os name="Symbian">
  • <os name="Windows Mobile">

In each <os> section, you can add or remove <phone> sections. A <phone> section defines a specific mobile device on a operating systemn for which you want to able to preview content.

Procedure

  1. Open the Phones.xml configuration file, located by default in your SDL Tridion installation \C:\Program Files (x86)\Tridion\web\WebUI\Editors\MobilePreview\Configuration directory, in a text editor.
  2. The Phones.xml consists of <os> sections and in each <os> section one or more <phone> sections. A <phone> element has a name attribute which specifies the name of the mobile device displayed in the Mobile Simulator drop-down menu and the following sections:
    <image>
    The image to display in the Mobile Simulator for this mobile device:
    • <url>—the relative path to the image.
    • <width>—the width in pixels of the image.
    • <height>—the height in pixels of the image.
    <screen>
    The positioning of image in the Mobile Simulator:
    • <width>
    • <height>
    • <left>
    • <top>
    <userAgent>
    The client application specified using the format: Mozilla/[version] ([system and browser information]) [platform] ([platform details]) [extensions] .
    Example configuration
    <os name="Android">
        <phone name="HTC Desire">
          <image>
            <url>../../Themes/Carbon/Phones/htc-desire_400x776.png</url>
            <width>400</width>
            <height>776</height>
          </image>
          <screen>
            <width>319</width>
            <height>498</height>
            <left>38</left>
            <top>116</top>
          </screen>
          <userAgent>Mozilla/5.0 (Linux; U; Android 2.1-update1; en-us; HTC Desire Build/ERE27) AppleWebKit/530.17 (KHTML, like Gecko) Version/4.0 Mobile Safari/530.17</userAgent>
        </phone>
      </os>
  3. Save and close Phones.xml.