Re-Skinning Your CMS Website

DMXReady has developed this Skinning Tutorial to show you how to wrap CMS Suite with Professional Bootstrap themes from Wrapbootstrap. It does require getting into the html code of the web page-since every skin designer does things slightly differently, there is no way to fully automate the process. But with the step-by-step instructions below, you should have no problems doing it yourself - and you'll find that the results are well worth the effort!

Step 1: Download & Install Your Theme/Template

Now that you have found a Theme/Template you like, follow the instructions below.

  1. Download your Theme/Template.
  2. UnZip, extract, or otherwise move these files to the folder "/cmsv3/skins/ " folder on your hard drive. For example, if you downloaded a template called "mytheme" the folder would be: c:\My Documents\My Website\cmsv3\skins\mytheme

Step 2: Convert Your Theme/Template Into A Skin

These are the general steps to convert your Theme/Template into a skin. Please note that every Theme/Template is different, so adjust these instructions accordingly.

  1. Locate the index.html file that came with your template. For example: c:\My Documents\My Website\cmsv3\skins\mytheme\index.html
  2. *Create a new file called "cms-mytheme.asp" inside the folder /cmsv3/skins/mytheme/ (*Make sure you use the prefix "cms-" when naming your skin)
  3. Create a copy of the index.html and rename "cms-mytheme.asp"(*Make sure you use the prefix "cms-" when naming your skin)
  4. Save and upload your changes

Step 3: Re-Build Your Skin Using the CMS Include File Objects

Your CMS website uses Include File Objects to dynamically display database content. Simply copy and paste the include file object snippet into your template. You can place things like your header, your navigation bar, and your footer wherever you want on your page.

  1. Open your newly created master template file "/cmsv3/skins/cms-mytheme.asp" in code view.
  2. Familiarize yourself with the template layout and CSS architecture
  3. Copy and paste the following line at the very top of the file.

    <!--#include file="plugins/cms/templates/inc_dmxready_engine.asp" -->

  4. Continue to locate the dummy/placeholder content inside the code and replace with a dynamic content block (see chart below).
  5. Replace the contents between the specific <div> container (i.e. header, search, content, navigation, footer) with the appropriate include file object snippet.
  6. Save, upload the entire skins folder to your web server using your FTP software.

Step 4: Fine Tune

  1. Preview your newly skinned CMS website by pointing your web browser to: http://www.yourdomain.com/cmsv3/cms-mytheme.asp
  2. Preview the original index.html template by pointing your web browser to: http://www.yourdomain.com/cmsv3/skins/mytheme/index.html
  3. Open both files in code view and compare the 2 templates for differences in the css markup.
  4. Add any missing CSS markup to the code block templates or style page your content using built-in WYSIWYG editor using the original index.html file as your guide.

Note: To incorporate styles/features from your template you will need to add your html markup directly to your CMS page content using the WYSWYG editor.

Step 5: Publish Your New Skin

To make your newly skinned master template your website home page:

  1. Place a file called index.asp at the root of your domain (same location as your existing home page)
  2. Open the file and remove all code
  3. Add the following code block at the top of the page:

    <% Server.Execute("/cmsv3/cms-mytheme.asp") %>

  4. Save and upload to your server
  5. That's It! .... your newly skinned CMS website will automatically display when browsing to your domain www.yourdomain.com


Anatomy of Master Template

Page Header
CMS Engine — <!--#include file="plugins/cms/templates/inc_dmxready_engine.asp"-->
Meata Tags — <%=PageMetaDescription%>, <%=PageMetaKeywords%>
Favicon — <%=General_FavIcon%>
Page Body
Logo — <%=General_AppLogo%>
Search — <!--#include file="plugins/cms/templates/search/inc_search.asp"-->
Main Navigation Menu — <!--#include file="plugins/cms/templates/navigation/inc_navigation_main.asp"-->
Breadcrumbs — <!--#include file="plugins/cms/templates/breadcrumbs/inc_breadcrumbs.asp"-->
Side Nav

Side/Sub Navigation Menu —
<!--#include file=
"plugins/cms/templates/ navigation/
inc_navigation_sub.asp"-->
Main Content

Content Body — <!--#include file="plugins/cms/templates/body/inc_body.asp"-->
Page Footer Container
Footer Navigation Menu —
<!--#include file="plugins/cms/templates/footer/inc_footer_menu.asp"-->
Custom Footer HTML — <%=General_AppFooter%>

Data Objects & Include File Templates

CMS Engine
This plugin turns your template into a CMS

<!--#include file="plugins/cms/templates/inc_dmxready_engine.asp" -->

Meta Title Information

<%=PageMetaTitle%>

Meta description

<%=PageMetaDescription%>

Meta keywords

<%=PageMetaKeywords%>

Website Favicon

<%=General_FavIcon%>

Logo

<img src="<%=General_AppLogo%>"/>

Google Site Search Box

<!--#include file="plugins/cms/templates/search/inc_search_google.asp" -->

Shopping Cart Links

<!--#include file="plugins/catalogmanager/templates/store/inc_cart_login.asp" -->

Multi-Level Flyout Navigation
Multi-level flyout navigation: includes all levels of pages with horizontal/vertical flyout ajax menu built in.

<!--#include file="plugins/cms/templates/navigation/inc_navigation_multilevel.asp"-->

Multi-Level Side Navigation
Multi-level navigation: includes all levels of pages. Use this template if applying ajax from original template.

<!--#include file="plugins/cms/templates/navigation/inc_navigation_multilevel_side.asp"-->

Main Menu Navigation
Main navigation: includes only main pages (horizontal/vertical main menu).

<!--#include file="plugins/cms/templates/navigation/inc_navigation_main.asp"-->

Sub Menu Navigation
Sub-Level Navigation: includes sub level (child) pages.

<!--#include file="plugins/cms/templates/navigation/inc_navigation_sub.asp"-->

Breadcrumbs
Use this code to include breadcrumbs in the template

<!--#include file="plugins/cms/templates/breadcrumbs/inc_breadcrumbs.asp"-->

Main Content Area
Use to include CMS Page content & Plugin template

!--#include file="plugins/cms/templates/body/inc_body.asp"-->

Footer Navigation
Displays links to pages you defined in page manager

<!--#include file="plugins/cms/templates/footer/inc_footer_menu_horizontal.asp"-->

Footer Text
Displays content from the footer field defined in your customization --> settings.

<%=General_AppFooter%>

Bootstrap Javascript

<script src="/<%=folder_root%>/skins/bootstrap-v2.1.0/docs/assets/js/bootstrap.min.js"></script>

Disqus Comments Widget

<!--#include file="shared_library/tools/disqus/inc_disqus.html"-->

Share This Widget

<!--#include file="shared_library/tools/sharethis/inc_sharethis-horizontal.html"-->

Contral Panel Dashboard Window

<!--#include file="shared_library/control_panel/inc_admin_nav_bar.asp" -->