Feature Pack 8: The Madisons store is deprecated. Most features demonstrated in the Madisons store are available in the Aurora store.

Madisons mobile starter store directory structure

The Madisons mobile starter store files are organized by default in a defined directory structure.

The following directory structure exists when your store is published:

Note: The StoreView URL is used as the main entry point into the store and is enabled with the device detection. When the user navigates to the store:

http://localhost/webapp/wcs/stores/servlet/StoreView?storeId=10101

They are redirected to either the base store or the mobile store, depending on the device used. When mapping your domain to WebSphere Commerce, you should configure the Web server to point to the StoreView URL instead of the TopCategories URL of the base store.

For example: http://mycompany.com redirects to http://localhost/webapp/wcs/stores/servlet/StoreView?storeId=10101, which redirects to either the base store or mobile store, depending on the device used.

The directory structure used in the examples represent a server environment. For development environments, the equivalent directory structure applies: for example,WC_eardir\Stores.war\storedir\mobile\css

WC_eardir/Stores.war/storedir/mobile/css
Contains the CSS files for the store using the following naming conventions:
  • commonX_Y.css
    The main CSS file used for all locales, excluding the locale-specific CSS files, for example common1_1ja_JP.css.
    Where:
    • X is the style number, starting from 1, mapped to the number of styles available in WebSphere Commerce Accelerator's Change Style. The Madisons mobile starter store contains one style.
    • Y is the color number, starting from 1, mapped to the number of colors available in WebSphere Commerce Accelerator's Change Style. The Madisons mobile starter store contains one color.
Feature Pack 1WC_eardir/Stores.war/storedir/mobile/iPhone
Feature Pack 1Contains the files for customizing the storefront behaviour for an iPhone mobile application. It contains the following assets:
  • CSS
  • Images
  • JSP files
  • JavaScript files
WC_eardir/Stores.war/storedir/mobile/images/
Contains common store icons and images.
WC_eardir/Stores.war/storedir/mobile/images/advertisements
Contains all the images for store advertisements. Most of the advertisement images are a content file asset found in WebSphere Commerce Accelerator or Management Center.
WC_eardir/Stores.war/storedir/mobile/images/attachments
Contains file assets attachments that are linked to a product.
WC_eardir/Stores.war/storedir/mobile/images/catalog
Contains catalog, category, and product images.
WC_eardir/Stores.war/storedir/mobile/images/colors/colorY
Contains images that are style and color dependant when customizing the layout and presentation of the store. For example, the border colors of an image are modified to remain consistent with a change in the store's color scheme.
Where:
  • Y is the color number, starting from 1, mapped to the number of colors available in WebSphere Commerce Accelerator's Change Style. The Madisons mobile starter store contains one color.
WC_eardir/Stores.war/storedir/mobile/include
Contains JSP files and JSP file fragments according to the following usage:
  • Files containing JSTL constants.
  • Files containing repetitive code that is included in all pages.
  • Files that are used by JSP files in the include/styles/style1 directory, common to all styles.
WC_eardir/Stores.war/storedir/mobile/include/styles/styleX
Contains JSP files that define the entire frame surrounding the content pages of the store.
Where:
  • X is the style number, starting from 1, mapped to the number of styles available in WebSphere Commerce Accelerator's Change Style. The Madisons mobile starter store contains one style.
The set of defined files are:
  • CachedHeaderDisplay.jsp
  • CachedFooterDisplay.jsp
WC_eardir/Stores.war/storedir/mobile/ShoppingArea/CatalogSection
Contains the full-page JSP files that render the store pages contained in the catalog browsing flow.
WC_eardir/Stores.war/storedir/mobile/ShoppingArea/CheckoutSection
Contains the full-page JSP files that render the store pages contained in the checkout flow.
WC_eardir/Stores.war/storedir/mobile/StoreInfoArea
Contains the full-page JSP files that render the store information pages, for example, the Help/Contact Us page.
WC_eardir/Stores.war/storedir/mobile/Snippets
Contains JSP files and JSP file fragments that are reused in the full-page store JSP files. The JSP file snippets are created to keep code modular and to render specific features of WebSphere Commerce. It contains JSP files, for example, that render:
  • The contents of an e-Marketing Spot.
  • An address form.
  • A promotion code.
Files in this directory can be included in store pages that want to use these features.
WC_eardir/Stores.war/storedir/mobile/UserArea
Contains the full-page JSP files that display the store's My Account section, Sign in, Registration, and Password Reset pages.
WC_eardir/Stores.war/storedir/mobile/
Contains error JSP files used in the store.