Beginner's Guide to nopCommerce Theme Development (ASP.NET MVC Based e-Commerce Solution) – Part 1

DZone 's Guide to

Beginner's Guide to nopCommerce Theme Development (ASP.NET MVC Based e-Commerce Solution) – Part 1

This beginner’s guide to nopCommerce theme development will introduce you to the basics of creating a nopCommerce theme. This post is aimed at beginners, it presumes that you have a basic knowledge of nopCommerce and are familiar with HTML & CSS. Read on for more.

· Web Dev Zone ·
Free Resource

This beginner’s guide to nopCommerce theme development will introduce you to the basics of creating a nopCommerce theme. This post is aimed at beginners, it presumes that you have a basic knowledge of nopCommerce and are familiar with HTML & CSS. Any front-end developer(s) will also be able to benefit from this post.

A theme is a collection of property settings that allow you to define the look of pages and controls, and then apply the look consistently across pages in a Web application, across an entire Web application, or across all Web applications on a server. Themes are made up of a set of elements: skins, cascading style sheets (CSS), images, and other resources. At a minimum, a theme will contain skins. Themes are defined in special directories in your Web site or on your Web server.

A theme can also include a cascading style sheet (.CSS file). When you put a .CSS file in the theme folder, the style sheet is applied automatically as part of the theme. You define a style sheet using the file name extension .CSS in the theme folder. (Source: http://msdn.microsoft.com)

What Is a Theme in nopCommerce?

A nopCommerce theme is a collection of files that can easily change the design of your website including its layout. A theme is used for having a consistent layout and appearance across all pages or an entire website. nopCommerce theme consists of several supporting files, including style sheets for page appearance and supporting images. A nopCommerce theme is only intended to change the look on the front-end (public store), i.e. what an online visitor sees when they browse your store site.

What Can Themes Do on NopCommerce Site?

  • Theme(s) can display the content and data stores by your nopCommerce in a defined manner (as per the requirements of the store site) 
  • Theme(s) can change the layout of your nopCommerce site: static or responsive and one column layout or two column layout
  • Theme(s) can offer a consistent user experience across multiple devices for your nopCommerce store site (across multiple platforms/devices)
  • Theme(s) can customize the typography and design elements via CSS

Structure of Theme Folder in nopCommerce (What's Required)

In order to work with nopCommerce, it is important to understand the structure of the files and folders.

Location of theme(s) in nopCommerce: All themes are located under nopCommerce root folder/Themes/

Image title

  • Content Folder: It consists of all the stylesheets and images
  • Views Folder: It consists of all the MVC razor views (i.e. web pages that contain the HTML markup and server side code)
  • preview.jpg Image File: Thumbnail (or a screenshot) of your theme that can be used a preview
  • theme.config File: This files consists the theme information such as theme name and its description.

Here is an example of “theme.config” file:

<?xml version="1.0" encoding="utf-8" ?>
<Theme title="Default clean" 
     previewText="The 'DefaultClean' site theme.">

Difference Between a NopCommerce Theme and a NopCommerce Plugin

A nopCommerce theme controls the overall presentation of the store site (i.e. public store) whereas a nopCommerce plugin is used to extend the functionality of nopCommerce site.

While creating a nopCommerce theme, it is important to keep one in mind that a theme should not add any kind of critical functionality to the site. If a theme adds any kind of important functionality, that feature can be lost if a store admin changes the store theme.

How to Install and Apply a Theme in NopCommerce

Let's assume you just downloaded a new theme which is in a zip file.

Extract the contents of your zip file and copy it under "Themes" folder like shown in the figure below:

Image title

In order to apply this new theme, go to: Administration > Configuration > Settings > General And Miscellaneous settings

Note: You can also go to this URL to access administration section - http://www.yourdomain.com/admin

Image title

Select new theme from the “Default Store Theme” and click Save.

Image title

Now, go to public store. You should be able to see the new theme on your website.

Right-to-left Theme Overview

nopCommerce also supports right to left version of the public store theme. nopCommerce default public store theme "DefaultClean" comes with the feature of right to left version style sheet. If you are creating your own theme then you can do so by overwriting all the horizontal positioning attributes of your CSS stylesheet (styles.css) and save it in a separate stylesheet by naming it as “styles.rtl.css”.

To enable "Right to Left" version of theme (as long as your theme supports it), go to:

Administration > Configuration > Languages

Image title

Click on "Edit" a language:

Image title

Now, make sure that "Right-to-Left" option is enabled.

Image title

Note: The active theme should support RTL (have appropriate CSS style file) and it affects only public store.

Creating/Writing Your Own Theme (Using Current / Default Theme)

Open your nopCommerce solution or website (web version) in Visual Studio - Go to this location:

If using sourcecode: \Nop.Web\Themes\

If using web version: \[Project Root]\Themes\

  • Select any default / current theme

Image title

  • Right click on the theme > select COPY

Image title

  • Select "Theme" folder > Right click > PASTE

Image title

  • You will get something like " DefaultClean - Copy"

Image title

  • Rename it - whatever you like to be the name of your new theme – For an instance, let's say: NewTheme

Image title

  • Now inside your New theme folder "NewTheme" > open "theme.config"

Image title

  • Change the current/existing theme name with your new theme name "NewTheme"

Image title

  • Now, inside your new theme folder "NewTheme" > Content > Images add your new images in "images” directory and start updating / customizing your style.css according to your requirements.
  • If you would like to test the changes > Go to Admin section > Apply your new theme > Save change and preview your public store.

    Image title

    Understanding Responsive Design

    Responsive Web Design is simply a design of a website that changes its layout according to different screen sizes in order to fit the content properly when it comes to a desktop, smartphones, tablets and other mobile devices. In this definition, there is a keyword here “properly” – In this context, by “properly”, it means consistent. While working on a responsive design, the web developers have to make sure that the user experience of a website remains consistent throughout all the devices, irrespective of their screen size.

    nopCommerce default theme (DefaultClean) does support a responsive design out of the box that is optimized for all screen sizes and this approach is handled via media-queries in the CSS. This allows your online ecommerce store layout to display the content of your website by automatically adjusting the viewing area depending on the size of the screen.

    Image title

    .net framework, asp.net, asp.net mvc, design, ecommerce, guide, template, theme, web developement, webdev

    Published at DZone with permission of Lavish Kumar . See the original article here.

    Opinions expressed by DZone contributors are their own.

    {{ parent.title || parent.header.title}}

    {{ parent.tldr }}

    {{ parent.urlSource.name }}