How to write a Theme for SmartStore.NET
Files and folders:
- /Content (optional)
- /Views (optional)
- /Views/Shared/ConfigureTheme.cshtml (optional)
- /Content/_user.scss (optional)
The file theme.config is the most important file of a theme. Here, you can configure the basic values such as title, author or version. Also, you can declare variables that can be configured by the user.
Attributes of the Theme-Node
- baseTheme: determines the theme from which your theme is derived (find more information about theme inheritance further below)
- title: determines the title of your theme
- previewText: determines the preview text which is shown within the admin area next to the theme
- author: contains information about the company or person who has written the theme
- version: determines the version of the theme
Before you start a design from scratch, you can also derive everything from a base theme and just alter the parts of it that you don't like. Therefore, you just need to determine a base theme within the baseTheme attribute in the theme.config.
We've structured our css files to be very granular so that in most cases, you only need to overwrite small parts in order to change the design of a certain area. Sometimes, you may just want to change or add a line, in which case we recommend using the file
_custom.sass to overwrite other css declarations. This is an empty file that gets rendered last, so its declarations have the highest priority. When you work like this, you can update your base theme to a higher version without any problems. You have the latest code and your changes remain as they were before the update.
Whereas the file _
custom.sass is set up to be edited for theme developers, the file
_user.sass is there to be edited by shop admins.
You can also derive your theme from one that has also been derived from another, thanks to multi-level inheritance. The SmartStore.NET theme engine tries to locate the actual physical file by looking up all corresponding paths in the hierarchy chain.
If you just want to alter certain lines in a particular css file, you can also import the css file of one of the parent themes and add your lines to it. This way, your theme keeps up to date with the current code and your changes also remain intact.
You can define your own variables within the
variables node in the theme.config file. These variables can be used within your css. There are 5 different variable types as listed below:
Select: any value defined within a corresponding selection. The
selectalways has to refer to the
selectnode (see example above). Variable type and select id are separated by a #
String: string value
Color: hexadecimal color value
Boolean: boolean value (true or false)
Number: integer value (e.g.: 1, 2, 1024)
The file ConfigureTheme.cshtml has to be placed in the directory
Views\Shared. Its purpose is to provide an administration area for your theme. This is optional as long as you derive from a base theme. You only have to create it when you have defined new theme-specific variables. To add an editor for the variables that are defined in your theme.config, simply add the following code for every variable you have determined.
This code will automatically render an editor depending on the variable type.
Boolean: Selectbox (with the values true or false)
Once you've defined your variables, you can use them in css like this:
The preview.png will be shown within the admin area, where the themes are selected by the Shop-Adminstrator.
/Content directory, you can override any content of the base theme or the
/Content directory from the SmartStore.Web project.
When you want to restructure the HTML structure, you need to have a look in the
/Views directory in the SmartStore.Web project where all views are located. Once you've found the view that contains the HTML you want to alter, create a directory with the same name in your theme and copy the view into it. Now, you can alter the HTML structure within your theme.
Should you need to access your own resources for a theme, you can refer to them in
Views/Shared/Head.cshtml as follows.
To package a theme so that it can be installed by SmartStore.NET, open the SmartStore Packager
The root path is your
SmartStore.Web project which contains your theme. After entering this path, you can read the extensions that are included within. Then, you just choose your theme and an output path and click on
Sass is a CSS pre-processor, meaning that it extends the CSS language, adding features that allow variables, mixins, functions and many other techniques that allow you to make CSS that is more maintainable, themable and extendable.
Bootstrap is the most popular HTML, CSS, and JS framework for developing responsive, mobile first projects on the web.
Font Awesome gives you scalable vector icons that can instantly be customized — size, color, drop shadow, and anything that can be done with the power of CSS.
ASP.NET MVC gives you a powerful, patterns-based way to build dynamic websites, enabling a clean separation of concerns, giving you full control over markup for enjoyable, agile development.