Home Library Learn Samples Downloads Support Community Forums
2 out of 3 rated this helpful - Rate this topic

Sign-in Page XML Reference

Dd548479.note(en-us,MSDN.10).gifNote:
This topic describes functionality that will be obsolete. This functionality is provided only to support legacy applications. Live Connect incorporates features that provide equivalent functionality.

The following table contains a detailed explanation of the sign-in elements that you can customize.

Dd548479.note(en-us,MSDN.10).gifNote:
Any XML element that defines color, such as HeaderBkgndColor, uses a hexadecimal value. This value is in the format #RRGGBB, where the value for each primary color—red (RR), green (GG), and blue (BB)—is in the decimal-equivalent range of 0 to 255.

Node Element Description

WhiteLabelProperties

Logo

An entry from the string table that specifies the URL of your site's logo.

WhiteLabelProperties

LogoSSL

An entry from the string table that specifies the URL (SSL) of your site's logo.

WhiteLabelProperties

LogoAltText

An entry from the string table that specifies alternate text to display in place of your site's logo.

WhiteLabelProperties

HeaderBkgndImage

An entry from the string table that specifies the URL of the header background image. This element must be used with the HeaderBkgndImageSSL element.

WhiteLabelProperties

HeaderBkgndImageSSL

An entry from the string table that specifies the URL of the header background image.

Dd548479.note(en-us,MSDN.10).gifNote:
If you use a background header image, make sure it is available over SSL. Otherwise, if a user selects Use Enhanced Security at sign-in, the image does not render.

WhiteLabelProperties

HeaderBkgndColor

A hexadecimal value that specifies the sign-in page's header background color.

WhiteLabelProperties

BkgndColor

A hexadecimal value that specifies the background color of the sign-in page.

WhiteLabelProperties

FontColorLight

A hexadecimal value that specifies the footer font color used in the sign-in page.

WhiteLabelProperties

FontColorLink

A hexadecimal value that specifies the color for hyperlinks shown on the sign-in page.

WhiteLabelProperties

ButtonColor

A hexadecimal value that specifies the sign-in page's Sign in and Sign up button color.

WhiteLabelProperties

ButtonBorder

A hexadecimal value that specifies the sign-in page's button-border color.

WhiteLabelProperties

FontColor

A hexadecimal value that specifies the color of fonts on the sign-in page.

WhiteLabelProperties

UserTileColor

A hexadecimal value that specifies the color of user tiles on the sign-in page.

WhiteLabelProperties

WLIDValuePropFontColor

A hexadecimal value that specifies the color of the Windows Live value-proposition statement on the sign-in page.

SiteLoginUIProperties

Header

A string variable, such as STR_HEADER_1, that matches a String element's ID attribute. The Windows Live ID service uses this variable to locate a corresponding String element in the sign-in XML file, and displays the contents of the String element as the header for the sign-in page.

Each Header element should contain an ID attribute, so that you can easily specify it by using the dynamic sign-in customization options. You must also have one Header element that has an ID attribute of "default". The Windows Live ID service uses this header as the standard header to display.

SiteLoginUIProperties

Title

A string variable, such as STR_TITLE_1, that matches a String element's ID attribute. The Windows Live ID service uses this variable to locate a corresponding String element in the sign-in XML file, and displays the contents of the String element as the title of the sign-in page.

Each Title element should contain an ID attribute, so that you can easily specify it by using the dynamic sign-in customization options. You also must have one Title element that has an ID attribute of "default". The Windows Live ID service uses this title as the standard title to display.

SiteLoginUIProperties

Subtitle

A string variable, such as STR_SUBTITLE_1, that matches a String element's ID attribute. The Windows Live ID service uses this variable to locate a corresponding String element in the sign-in XML file, and displays the contents of the String element as the subtitle for the sign-in page.

Each Subtitle element should contain an ID attribute, so that you can easily specify it using the dynamic sign-in customization options. You also must have one Subtitle element that has an ID attribute of "default". The Windows Live ID service uses this subtitle as the standard subtitle to display.

SiteLoginUIProperties

ImageURL

A string variable, such as STR_IMAGEURL_1, that matches a String element's ID attribute. The Windows Live ID service uses this variable to locate a corresponding String element in the sign-in XML file, and uses the contents of the String element as the image URL (typically your logo) on the sign-in page. This image appears only when the sign-in page is served over HTTP and if the Title element is not empty.

Each ImageURL element should contain an ID attribute, so that you can easily specify it by using the dynamic sign-in customization options. You also must have one ImageURL element that has an ID attribute of "default". The Windows Live ID service uses this URL as the standard image URL to display.

SiteLoginUIProperties

SSLImageURL

A string variable, such as STR_SSLIMAGEURL_1, that matches a String element's ID attribute. The Windows Live ID service uses this variable to locate a corresponding String element in the sign-in XML file, and uses the contents of the String element as the image URL (typically your logo) on the sign-in page. Unlike the ImageURL element, this element is for connections over SSL. This image appears only when the sign-in page is served over HTTPS and if the Title element is not empty.

Each SSLImageURL element should contain an ID attribute, so that you can easily specify it by using the dynamic sign-in customization options. You also must have one SSLImageURL element that has an ID attribute of "default". The Windows Live ID service uses this URL as the standard SSLImageURL to display.

StringTable

String

The text that the Windows Live ID service uses for one of your sign-in page elements, such as the title. Each String element must contain an ID attribute with a value that corresponds to the content of a SiteLoginUIProperties element. For example, if you have a Header element that contains the string STR_HEADER_1, you must have a String element with an ID attribute of STR_HEADER_1.

The SiteLoginUIProperties element contains the text elements that appear on the sign-in page. This element can include multiple instances of the following child elements:

  • Header
  • Title
  • Subtitle
  • ImageURL
  • SSLImageURL

Each of these elements should contain a string. When displaying your sign-in page to a user, the Windows Live ID service uses this string and attempts to locate a matching String element within the StringTable node. The service then uses the contents of this String node to populate the appropriate sign-in page element.

For example, if you set a Header element as

Copy 
<Header id="default">STRID_WL_DEF_HEADER</Header>

and in your StringTable element you have

Copy 
<String id="STRID_WL_DEF_HEADER">This is the Default Header Text</Header>

the Windows Live ID service displays "This is the Default Header Text" on your sign-in page.

This pairing of SiteLoginUIProperties elements with StringTable elements makes it easy for you to create variations of your sign-in page and to localize your sign-in page for different languages. For more information about creating variations of your sign-in page, see Dynamic Sign-in Query String. For more information about localizing your sign-in page, see Localizing the Sign-in Page.

Within the Subtitle element, you can use the following syntax to format text and create bulleted lists.

Syntax Description

## <image number> ##

Bullet image (see following table).

##b##

Bold text.

##i##

Italic text.

##u##

Underlined text.

You can specify the following bullet images.

Image Image Number
Dd548479.b688952b-84eb-4738-923c-d20718608f81(en-us,MSDN.10).png

li1

Dd548479.d942486e-534f-4fa2-a9f6-cf713be515a3(en-us,MSDN.10).png

li2

Dd548479.22cf930f-58c5-4fb8-b044-bd37f8dd7f65(en-us,MSDN.10).png

li3

Dd548479.3732bded-93e4-44c2-baa0-f9174c5f667b(en-us,MSDN.10).png

li4

Dd548479.ca3b218e-6b7c-4c61-a199-1e3b05d463b5(en-us,MSDN.10).png

li5

Dd548479.3be69e6a-59a0-4860-acb7-f4564a721c38(en-us,MSDN.10).png

li6

Dd548479.97ed2ea5-bdf5-47b8-829c-810d4518a1e8(en-us,MSDN.10).png

li7

Dd548479.15b963c4-7683-404c-aa02-b01917c6adc0(en-us,MSDN.10).png

li8

Dd548479.817aa905-a924-4a51-9c72-6eb3eacf8d5b(en-us,MSDN.10).png

li9

Dd548479.4e8f93c5-3fa2-4c4f-b77c-788b0dc73a49(en-us,MSDN.10).png

li10

Dd548479.346dd7be-a6c0-4434-b814-9e5ca8586e35(en-us,MSDN.10).png

li11

Dd548479.5cd3fa18-e034-482e-a2e4-46870ed0b40b(en-us,MSDN.10).png

li12

Dd548479.74060269-c905-4ec9-97c4-725ea93059aa(en-us,MSDN.10).png

li13

Dd548479.057d2daf-9166-48ff-bc24-5c5cb90e0687(en-us,MSDN.10).png

li14

Dd548479.b6cd8ad9-8b29-4bcc-b2c7-366ece2a565d(en-us,MSDN.10).png

li15

Dd548479.aba669bf-20e3-4690-a335-5138a89fc8d3(en-us,MSDN.10).png

li16

Dd548479.0cbcf427-5599-4895-b38c-2e7c20dd0d75(en-us,MSDN.10).png

li17

Dd548479.9bb57241-7c97-468d-ad45-93c9115bc99f(en-us,MSDN.10).png

li18

Dd548479.1c07eed9-de82-414b-98fe-c906c5b28fed(en-us,MSDN.10).png

li19

Dd548479.1b9c57c1-a1fa-476e-bdf2-4e1486a76468(en-us,MSDN.10).png

li20

Dd548479.0e32371a-0f80-45f4-8d7f-db6aa3fae8d1(en-us,MSDN.10).png

li21

Dd548479.a686af0e-630b-4522-9057-1054c761c0d2(en-us,MSDN.10).png

li22

Dd548479.b24d3560-e064-4732-9f75-7d6eedbde787(en-us,MSDN.10).png

li23

The following is an example of a bulleted subtitle.

Copy 
<String id="STRID_WL_DEF_SUBTITLE">##li3##Join our exciting new ##b##online community ##/b##of vacationers.##li5##Experience the very pinnacle of##b## vacation excellence##/b## from anywhere in the world at our 8 exclusive destinations.##li2##Make a ##b##reservation##/b## today and ensure yourself a getaway you've ##i##never##/i## experienced before.</String>

You can define multiple titles, subtitles, images, and their header statements in the StringTable node. Values in this table are used to form dynamic query strings at run time. For more information about these elements, see Dynamic Sign-in Query String.

Other Resources

Live Connect

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.