Please raise your hand if you've ever wanted to display some dynamic Hotcakes Commerce data in a specific spot and in a specific way within your overall website design layout? And besides that, you really didn’t want to give administrators the option of changing its placement within site?
Creating a custom module can be a daunting task for first-timers and you are still left with the fact that a custom module has to be placed within a content pane within your overall theme design. The very nature of this type of extension allows administrators the ability to move it around on the page(s) at will.
Creating a custom viewset is a much more familiar proposition for those familiar with the
Hotcakes Commerce extension points, but the fact still remains that custom views are rendered within the context of a Hotcakes Commerce module, which in turn brings you right back to the scenario above – allowing administrators the ability to move it around on the page(s) at will.
Well, there's good news: Creating a powerful, custom
Hotcakes Commerce theme object doesn't have to be that daunting. With the right starter project and understanding at your disposal, you could easily display the desired dynamic Hotcakes Commerce data within your site pages -- all without a huge budget or time investment.
Download the free theme object extension install package on GitHub, and we’ll walk through exactly how to use it in this Part 1 of the blog series. In Part 2, we’ll go even deeper and show you how to utilize the starter Visual Studio project from GitHub or Codeplex. The project is also listed on DNN Forge. When we're done you'll know exactly how to create a powerful custom Hotcakes Commerce theme object that leverages the server-side API to get the exact dynamic data and display it as you wish. Ready? Let's dive in.
9 Easy Steps to Installing this Powerful Custom Hotcakes Commerce Theme Object
Before we look into the steps, please note this theme object requires DNN 7.4.1 or higher and Hotcakes Commerce 1.8.7 or higher.
Step 1
Download the theme object installation package from GitHub to a local directory of your choice. You’ll want to download the file named “HotcakesCartItemCount_1.0.0_Install.zip”.
Step 2
Login to your CMS instance as a SuperUser (host) and visit Host > Extensions.
Step 3
Click on “Install Extension Wizard”.
Step 4
In the popup, click “Choose File” and select the installation package downloaded in Step 1.
Step 5
Click “Next”.
Step 6
Click “Next” on the Package Information screen.
Step 7
Click “Next” on the Release Notes screen.
Step 8
Accept License and click “Next”.
Step 9
Upon installation success, click “Return”. If you have issues with the installation, please feel free to Create an Issue on GitHub.
2 Easy Steps to Integrate this Powerful Custom Hotcakes Commerce Theme Object With Your Theme
Step 1
Within your theme file (ASCX) file, register the theme object by inserting the following code at the top of your file. There may be other theme objects already registered. That’s okay, just add this one to any line within the other registrations.
Step 2
Place the following code at any desired location within the same theme file.
See, nothing fancy going on here. As long as you are comfortable editing your theme files, it is all quite simple!
In Part 2, we'll dig deeper into the code so that you'll be able to utilize these concepts to create your own powerful custom Hotcakes Commerce theme object using the server-side API.