Document Properties
Kbid27S349
Last Modified22-Jun-2020
Added to KB07-Dec-2015
Public AccessEveryone
StatusOnline
Doc TypeGuidelines, Concepts & Cookbooks
Product
  • ICM 7.6
  • ICM 7.7
  • ICM 7.8
  • ICM 7.9
  • ICM 7.10

Concept - Responsive Starter Store

1  Introduction

With Intershop Commerce Suite 7.6 a new customization approach for the storefront is introduced.

The storefront cartridges are no longer part of a projects base assembly (commerce_management_b2c or commerce_management_b2x). They now completely belong to the projects component set. This way it is necessary for the projects to get the storefront cartridges as source cartridges.

For this Intershop introduced the Responsive Starter Store. This blue print is a good starting point for customer projects. It consists of a working component set of storefront cartridges and demo cartridges and of two assemblies, one for B2C and one for B2X scenarios.

The Responsive Starter Store replaces our PrimeTech Reference Site with the new inSPIRED demo organization and completely reworked storefront cartridges that provide a new responsive storefront styling.

The inSPIRED organization structure of the Responsive Starter Store:

2 Screenshots

The homepage of the Responsive Starter Stores B2C demo channel - inTRONICS - in basically three different view sizes.

Desktop

Tablet

Mobile

3 Benefits

3.1 For Development

With the introduction of the Responsive Starter Store the projects get all the different options to customize the storefront of the project. They are no longer limited to building their changes on top of a fixed set provided by Intershop or creating a completely own storefront. By providing the storefront sources it is now possible within the project to work with the provided functionality and change it in pretty much the same way as Intershop developers can when developing the storefront functionality.

With the provided sources it is now also possible to work with the included Content Model and completely fit it to the projects needs. Content Model artifacts can now be removed, added or changed in the „original“ cartridges. There is no need to work with overrides any more, even though this functionality is still working as before. In addition any project specific functionality that hides unwanted content artifacts (black listing/white listing) is no longer needed since those artifacts can easily be removed in the sources.

For pipelines and ISML templates it is now possible too to directly make the changes in the original without the need to use the overloading mechanism, even though it might still be good practice for project specific customizations.

3.2 For Migration

With the new customization approach the project cartridges set - that might include the storefront cartridges of the Responsive Starter Store - is supposed to work as is on following Intershop versions. Only adaptions regarding actual API changes - that should be communicated - might be needed.

With the Responsive Starter Store, Intershop does not automatically update this part of the storefront cartridges when updating to a new Intershop version. Only the base assembly (commerce_management_b2c or commerce_management_b2x) is updated through Gradle but all the other parts are project code. This way it is up to a projects responsibility to do updates/migrations.

Any storefront updates come as a new blue print, e.g., a new version of the Responsive Starter Store. In which way this updated blue print is used to update the projects sources is up to the projects.

4 Content

The Responsive Starter Stores component set (a_responsive) basically contains the storefront cartridges that contain the storefronts “View Layer” and the Content Model. These cartridges can be copied and used in the projects component set to provide the standard storefront functionality. In addition, demo cartridges are provided that set up the inSPIRED demo organization with its channels and applications. Those demo cartridges can be used as starting point by the projects to base their initialization cartridges on.

Cartridge overview of the Responsive Starter Store component set:

a_responsive
├── app_sf_responsive
├── app_sf_responsive_b2b
├── app_sf_responsive_b2c
├── app_sf_responsive_cm
├── app_sf_responsive_costcenter
├── app_sf_responsive_smb
├── as_responsive
├── as_responsive_b2b
├── demo_responsive
├── demo_responsive_b2b
├── demo_responsive_catalog
├── demo_responsive_content
├── demo_responsive_ocst
├── demo_responsive_search

base storefront cartridge
additional B2B functionality cartridge
base storefront cartridge
base storefront cartridge
additional B2B functionality cartridge
base storefront cartridge
base storefront cartridge
additional B2B functionality cartridge
demo content cartridge
additional B2B demo content cartridge
demo content cartridge
demo content cartridge
demo content cartridge
demo content cartridge

Besides the component set the Responsive Starter Store also provides two assemblies as project blue prints, one for B2C (inspired-b2c) and one for B2X (inspired-b2x).

The Recipe: Set Up Project Based on the Responsive Starter Store describes in detail how the content of the Responsive Starter Store can be used as base for a customer project.

5 Used Technology

5.1 Bootstrap

The storefront of the Responsive Starter Store is based on Bootstrap, a HTML, CSS and JS framework for developing responsive projects on the web (used version at time of development 3.3.5).

Bootstrap includes a responsive grid system that by default appropriately scales up to 12 columns as the device or viewport size increases. It includes predefined classes for easy layout options, as well as powerful mixins for generating more semantic layouts. The storefront of the Responsive Starter Store uses this 12 column grid system as defined in Bootstrap. No changes were made. Therefore, the Bootstrap documentation can be used as reference for working with the Responsive Starter Store (English documentation, German documentation). All the described CSS classes should be usable within the Responsive Starter Store.

Besides the grid system several Bootstrap components and its Javascript components are used throughout the storefront like Modal, Carousel, Popover, Collapse. Any other Bootstrap components should be usable too since the complete Bootstrap framework is included in the Responsive Starter Store.

5.2 Less

With the integration of Bootstrap its underlying default CSS preprocessor - Less - was integrated in the Responsive Starter Store too.

For a convenient Less development environment a Less editor was integrated into Intershop Studio and a Less compiler was added as Gradle task.

For further information on how to work with Less in the Responsive Starter Store read the Cookbook - Storefront Less Integration.

5.3 BootstrapValidator

For the client side form validation the BootstrapValidator in version 0.5.0 is used. This version was used even though a newer version exists, since this older version is licensed under the MIT License. A documentation for version 0.5.2 can be found here. The current development version is called FormValidation but it no longer uses such an open licensing model. For documentation you can still refer to their web site but be aware of the necessary translations or newer features.

5.4 Slick Carousel

For product lists the fully responsive, swipe enabled, desktop mouse dragging, infinite looping, fully accessible with arrow key navigation slick carousel was integrated.

5.5 Fonts

As default font families for the Responsive Starter Store Roboto and Roboto Condensed is used.

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Support Tickets