Skins

Note: Skins are used in legacy stores only.

Overview

You can control the look and feel of your stores by either selecting one of the uStore default skins or using your own custom skin instead. If you want to use your own skin, you need to prepare it in advance. uStore supports two types of skins: desktop and mobile. The default XMPieGreen skin is also adapted for mobile devices. The skins are designed with active CSS and can easily be modified using HTML5 Base.

You can download existing skins to customize them, upload new skins, and replace an existing skin with a new skin.

It is highly recommended that you download the skin as backup before deleting or replacing it.

To select a skin:

  1. Go to Store Setting > Set up Store, and click the Appearance tab.

  2. In the Store Skin section, select the required skin from the Skin Name list.

    For uStore Connect stores, make sure to select a skin that matches the appearance of the third-party e-commerce application.

  3. If you want to add a header title to your store, enter it in the Header Title box. This will be displayed in the store Welcome page.

  4. Select the Show Product Search Bar to enable the product search bar in your store’s Home page and Product List page.
    The product search bar enables customers to quickly find products by product name, product description and key words.

Customize skins

This section reviews the main components and principles of the Skin XMPieGreen skin and explains how you can customize it for branding and design purposes.

This information is designed for web designers. To be able to take full advantage of the provided information, you need to be knowledgeable in HTML and CSS editing.

Main elements

The XMPie skin mechanism was designed to provide maximum layout, flexibility, reduced page weight and faster page loads.

The following figures illustrate the flexibility of the XMPieGreen skin. The customized skin was achieved by making relatively small changes in the CSS definitions.

Default XMPieGreen skin

Customized skin based on the XMPieGreen skin

Main skin files

The main skin files are located in the Images folder:

File

Description

Style.css

Main style sheet

Popup.css

Styles for popup windows

FileSubmission.css

Styles used for the document builder pages

Common.skin

Maps additional skin IDs to their style

XmpImageButton.skin

Maps each button’s skin ID to its css class

jquery-ui.custom.css

Styles for the jquery controls used in uStore

General page layout

The default page layout includes the following areas:

Header

Content area

The following selectors, found in the Style.css define the general styles used throughout the page layouts:

Selector

Description

#fullpage

Defines the page width

Html

Defines the store background

Header

The header consists of the following elements:

Logo: Your company’s logo

User Welcome: Salutation defined in the uStore backoffice by the uStore administrator

Menu buttons: Navigation menu buttons to the store’s main pages

Localization and currencies menu: Enables the user to select a language to view the store’s interface and a currency to use for purchases in the store.

Links to:

  • Drafts: Lists non-completed orders that were saved as drafts.

  • Help: Displays an online help file.

  • Sign out: Displays the Sign in page

Most of the header elements have an absolute positioning on the page. This means that you can easily change their position.

Following are the header elements:

Element

Selector /Class

Image file

Positioning

Logo

#logo

Logo.jpg

Absolute

User Welcome

.userWelcome

Absolute

Menu buttons

.menuButton

.menuButton:hover

.menuButton.selected a

.menuButton.color:hover

.menuButton.selected.color

.menuButton a

Localization and currencies menu

XmpImageDropDownList

Toggle

Choices

flagList

dropDownCurrencies

Note: Properties are set using combinations of these classes.

Absolute

Drafts, Help and Sign Out links

header li.links

Absolute

Content area

The content area includes the following sections, all displayed over a background image:

Product Group tree: The menu on the left pane of the page.

Homepage Title: the name of the store.

Product Search box: A box at the top right corner of the page that enables visitors to search for products in the store.

Homepage: The area that includes the main content of the page.

Following are the content area elements:

Element

Selector /Class

Image file

Background image (wave)

.ThemedPageMaster #bodyarea.

leftBanner.png

Store title

.title

Search box

.productSearchBox

Search box input area

.productSearchBox input[type=input]

Search button

.productSearchBox input[type=submit]

magnifing-glass.png

Background color of the product tree

.ThemedPageMaster #bodyarea:before

Width of the product tree

.ThemedPageMaster #bodyarea:before

#navArea

.treeViewContainer.

Homepage

store.png

Facebook login button

uStore administrators can enable storefront customers to log in to a store using their Facebook credentials. When the Facebook login feature is used, a new box appears in the Sign-in page with the Facebook Login button.

The following class controls the Facebook login button: singleSignOnButtonFacebook

LivePerson chat button

uStore administrators can add a chat button to all storefront pages. By default the LivePerson chat button is located at the lower left corner of every page.

The following selector controls the LivePerson chat button style: .LivePersonButton_Skin

Product list page

The product list is displayed as either a list or a grid, depending on the settings defined on the Store Setup > Appearance tab in the uStore backoffice.

The following is the Product List page displayed as a grid:

The following are selectors that control the Product List page:

Element

Selector /Class

Basic Properties

.XmpImageButton

Product List

productListTable

productlistview

productgridview

thumbnail

productInfo

productname

productdesc

productQtyRange

productPrice

productDetailsLink

overlay

productEnlarge

productDownload

Product details and customization pages

The product details and customization pages include the purchasing workflow, from providing information about a selected product to the checkout steps. The elements displayed on these pages and their layout depends greatly on the settings defined by the uStore administrator on the uStore backoffice.

Layout of the Product Details and Customization pages:

DUC customization controls

Product preview area

Footer

In the Customize step, by default, the labels for the DUC customization controls appear to the left and at the same height of the input control as can be seen in the above image. If you want to place the labels above the customization controls and align them to the left, add the following rule:

.Duc dt, .Duc dd

{

float:inherit;

margin-left: 10px;

padding: 0;

}

Popup windows

The uStore user interface includes a few pop-up windows. The Billing Address dialog box, which enables the visitor to enter the billing address for a specific order, is an example of a pop-up window:

Following are the pop-up window styles:

Styles

CSS File

Selector

Styles within the pop-up window

Popup.CSS

Style of the pop-up window itself

jquery-ui.custom.CSS

ui-dialog(several selectors)

For example, edit the .ui-dialog-title selector to change the style of the pop-up window title.

Color scheme

Use the following CSS selectors to edit your skin’s color schemes.

Selectors in the Style.css and Popup.css

Following is a list of the color schemes that you control via selectors located in the Style.css and Popup.css files.

Color Schemes

Selector

Sample Images

Theme buttons

.XmpieThemeColorButton

.XmpieThemeColorButton:hover

.XmpieThemeColorButton.Hover

.XmpieThemeColorButton:active

Background colors of the order approval buttons

.XmpieApproveButton:hover

.XmpieApproveButton:active

Colors of the options shown in the Gallery List View and Gallery Grid View controls

.FieldOptionItem.FOGrid.selected .optionTitle

.FieldOptionItem.selected.FOGrid .optionIcon

Color of current customization step

.btnSelected a:link

Color of the current wizard step

.WizStepTR[stepStatus='active']

.WizStepTRSel[stepStatus='active']

Color of the current wizard step when multiple shipping addresses are enabled

.WizardStepHeadingCurrent

Selectors in the FileSubmission.css

Following is a list of the color schemes that you control via selectors located in the FileSubmission.css file.

Color Schemes

Selector

Sample Images

Properties pop-up in the document builder step

.VerticalMenuDiv ul li:hover

.VerticalMenuDiv_ul_li_active

Preflight pop-up in the document builder step

infoToggleArea

Font styling

Use the following CSS selectors to set the font style:

CSS File

Selector

Style.CSS

Popup.CSS

Body

FormButton

DIV.LoadingDivHeader

jquery-ui.custom.CSS

.ui-widget

.ui-widget input

.ui-widget select

.ui-widget textarea

.ui-widget button

Images

You can make any changes to images as long as you do not change the file name. Images used in the document builder process are found in the File Submission folder.

The following tables list images that would most probably need editing to match a new branding or color scheme.

Master pages

Note: Only advanced users who are familiar with ASP.NET should work with master pages.

If you need to make more complex changes to your storefront pages so that they comply with your organization’s branding or website structure requirements, you need to create new master pages.

Master pages determine the page layout of your storefront pages. Master pages affect page elements, such as the header, content area and footer. In addition, you may want to modify a master page to add code and other elements, such as widgets, banners and additional functionality.

uStore’s default master pages are located at:

<uStore Installation Drive>:\XMPie\uStore\App\CustomerApp\PageLayout

There are four default master page files:

  • Popup.Master

  • ThemedPage.Master

  • ThemedPageFullWidth.Master

  • Login.Master

Create new master pages

Create a new master page based on one of the existing master files. First you need to copy the master page file that you want to modify to the same folder of your new skin. Any changes that you make to the master file take effect only if the master file is located directly under the skin folder.

To copy a master file to your new skin folder:

  1. On the uStore server, browse to <uStore Installation Drive>:\xmpie\ustore\App\CustomerApp\PageLayout.

  2. Copy the required master file from the PageLayout folder to the skin folder. For example, copy the file ThemedPage.Master to: <uStore Installation Drive>:\xmpie\ustore\App\uStoreShared\Skins\Images\<new_skin_folder>.

  3. Make the required changes to the master file and save it.