Working With the Address Book Web Part
The Address Book Web Part provides shoppers with an interface in which to view and manage their addresses.
Web Part
.png "Dd451863.vugaddresslist(en-US,CS.90).png") |
Both shipping and billing address are grouped together by default, but can be filtered by using the two checkboxes on the Web Part. If more than one address is in the shopper's profile, all the addresses are displayed on-screen either horizontally or vertically depending on the settings of the Repeat Direction property and the Repeat Columns property (see below):
.png "Dd451863.vugaddresslistscreenmultiple(en-US,CS.90).png")
Shoppers can also mark an address as either shipping or billing (or both) and once marked as such, they can designate an address as the primary billing or primary shipping address. An address can be both a shipping and billing address and can be the primary in both categories. Each category can only have one primary address.
From the Address Book Web Part, shoppers can remove an address through an action button. When shoppers remove an address, they are prompted to confirm their action (this is optional; site designers can set a property in this Web Part whether to confirm deletion).
Note
A shopper cannot delete an address that is associated with a credit card.
If shoppers want to edit an address, they can invoke the edit action that redirects them to the Address Detail Web Part that lets them complete the address editing process. The shopper can also click the New Address control at the top of the page that redirects them to the Address Detail Web Part to create a new address.
The field labels are dynamic based on the locale and culture of the page. For example, if you set up the address Book Web Part to display text for a US English-speaking shopper, the Region field would be State and the Postal Code field would be Zip Code.
Property Sheet
The following figure shows the Address Book Web Part property sheet. The Address Book Web Part property sheet lets site designers control some aspects of the Web Part's behavior and appearance. The property sheet is displayed by selecting the edit option on the Web Page (in Edit Page mode) and then selecting Modify Shared Web Part. This displays the property sheet. Expand the sections to see the relevant properties.
.gif "Dd451863.vugaddressbookpropertysheet(en-US,CS.90).gif")
Properties
The following table lists and describes the properties for the Address Book Web Part.
Property |
Type |
Description |
Default |
|---|---|---|---|
Use "deletion confirmation" pop-up |
Boolean |
If checked, causes a pop-up to be displayed asking the user to confirm the deletion. You can configure the text displayed using the ' "Delete confirmation" pop-up text' field. |
True (Mandatory) |
Display "back" button |
Boolean |
If checked, allows the user to use the browser's Back button to navigate to the previous page. |
False (Mandatory) |
"Address Detail" page URL |
String |
The URL of the address detail page |
~/AddressDetail.aspx (Mandatory) |
"Action" URL parameter |
String |
The value assigned to the field for queries |
act (Mandatory) |
"Address ID" URL parameter |
String |
The value assigned to the address field for queries |
address (Mandatory) |
"Address list" section title text |
String |
Sets the text displayed above the address list. |
My Address Book |
"Is billing address" check box text |
String |
Sets the text displayed beside the "is billing address" check box. |
This is a billing address |
"Add new address" button text |
String |
Sets the text displayed on the "add new address" button. |
Add New Address |
"Back" button text |
String |
Sets the text displayed on the "back" button. |
Back to |
"Edit" button text |
String |
Sets the text displayed on the "edit" button. |
Save |
"Remove" button text |
String |
Sets the text displayed on the "remove" button. |
Delete |
"City" label text |
String |
Sets the text displayed the "city" value. |
* City |
"Country" label text |
String |
Sets the text displayed beside the "country" value. |
* Country |
CSS class |
NA |
Sets the style sheet "class" name used when outputting the HTML markup of this Web Part. |
NA |
"Default billing address" check box text |
String |
Sets the text displayed beside the "set as default billing address" check box. |
Mark as default billing address |
"Default shipping address" check box text |
String |
Sets the text displayed beside the "set as default shipping address" check box. |
Mark as default shipping address |
"Delete confirmation" pop-up text |
String |
Sets the text displayed on the delete confirmation pop-up. |
Confirm Address Deletion |
Instructional text |
String |
Sets the text block displayed below the title. Can be used to provide instructions to end users. |
Click the 'Add New Address' button to add to your address book. |
"Line 1" label text |
String |
Sets the text displayed beside the "line 1" value. |
* Address line 1 |
"Line 2" label text |
String |
Sets the text displayed beside the "line 2" value. |
Address line 2 |
"Billing addresses list" text |
String |
Sets the text displayed above the "billing addresses" list. |
Billing Addresses |
"Shipping addresses" list text |
String |
Sets the text displayed above the "shipping addresses" list. |
Shipping Addresses |
"Phone number" label text |
String |
Sets the text displayed beside the "phone number" value. |
* Phone number |
"Postal code" label text |
String |
Sets the text displayed beside the "postal code" value. |
* Postal Code |
"Province" label text |
String |
Sets the text displayed beside the "province" value. |
* Province |
Layout : # of columns |
Int |
Sets the number of columns to use when laying out the collection of addresses. The number of columns of addresses to display (if there are more addresses than columns, new rows are created as needed) |
1 |
Layout : Orientation |
Enum |
Sets the orientation of the "columns" when laying out the collection of addresses. |
Horizontal |
"Is shipping address" check box text |
String |
Sets the text displayed beside the "is shipping address" check box. |
This is a shipping address |
"State" label text |
String |
Sets the text displayed beside the "state" value. |
* State |
"View" label text |
String |
Sets the "view" label text. |
Display my addresses by type: |
"Zip code" label text |
String |
Sets the text displayed beside the "zip code" value. |
* Zip/Postal Code |