close ad
Important WebAssist Announcement
open ad
View Menu

Web development tutorial

PowerStore Theme API

Tutorial created by Ray Borduin, WebAssist

Categories: PowerStore


You can customize a PowerStore theme by editing various API tags in the theme_settings.xml file. This document covers the most common API tags for PowerStore themes.

Each theme (Default, Dark, Purple, and Crazy) has it's own theme_settings.xml file and can be found at [PowerStore root]/webassist/themes/[theme name]/theme_settings.xml. Please note that you must have activated your PowerStore to access these files. If you can't find them on your local machine, check the server where PowerStore is hosted.

<theme_map default="page.dwt.php">

theme_map is the main wrapper for the entire theme. All tags within the theme will be placed within theme_map.

  1. default: this is the default Dreamweaver template used for the theme. If a page isn't specifically directed to use a template ( See theme_pages ), the default template will be used. This file is located under the templates directory, and any additional templates added to the theme should be placed in this directory.

theme_pages determines which pages use which template. See theme_page below for information on setting pages to use specific templates.

<theme_page reg="" page="" />

theme_page allows for specifying certain pages or all pages in a directory to use a unique template besides the default template set in theme_map

  1. reg: reg determines the page or directory to use the custom template. special characters need the escape symbol ( \ ) before the actual character. A leading / is required, as well as an ending /i for the tag to work correctly.

    1. Example: reg="/\/admin\//i" for the /admin directory
    2. Example: reg="/index\.php/i" for the index.php file

  2. page: page determines the template used for the page or pages set in reg. This file is located under the templates directory, and any additional templates added to the theme should be placed in this directory.

theme_images is where images used in the theme are set. See theme_image below for information on setting images within templates.

<theme_image name="Logo" id="logo" img="headerLogo" subfolder="logos" page="templates/index.dwt.php,templates/page.dwt.php" />

theme_image determines individual images used within the theme

  1. name: name determines the name for the specific image that will appear in the PowerStore Design Settings tool for the theme
  2. id: id is the ID for the image. This will determine the alt tag for the image
  3. img: img is the id for the image within the template
  4. subfolder: subfolder is the folder the image exists in
  5. page: page is the template, templates, or CSS files that the image file is used in. This can be a single file, or several files, seperated with a comma

theme_defaults is the default settings for the Additional Options for the theme

<theme_default name="Catalog" value="default /">

theme_default sets the default for the two Additional Options options

  1. name: name determines which option is select. This will be Catalog or Registration
  2. value: value is the value the option defaults to
<wastylegroup value="" name="Global Styles">

wastylegroup groups together styles

  1. value: value is the specific id of the style group being exposed in the CSS file
  2. name: name is the name of the group shown in the Design Setting UI

waexposedtags hold all waexposedtag entries for the wastylegroup

<waexposedtag name="" tag="" id=""></waexposedtag>

waexposedtag shows the information for each exposed tag within the wastylegroup it's under

  1. name: name is the name the exposed tag will be listed as in the Design Settings UI
  2. tag: tag is the specific tag that is being edited
  3. id: id is the id for the tag to be used in the style sheet when the tag is edited

wafonts contains all font information for the theme


wafontface contains all font families available within the theme. See option below for more information on creating specific font families

<option value=""></option>

option is an entry for each font family that can be used within the theme

  1. value: value will be the font family available. Example: Arial,Helvetica,sans-serif


arrow downWhat to do next...

These API tags can be used to customize the most commonly changed theme settings for PowerStore. There are additional tags that can be changed for more customization.

arrow downReviews and comments

Comments will be sent to the author of this tutorial and may not be answered immediately. For general help from WebAssist, please visit technical support.

Sign in to add comments

Build websites with a little help from your friends

Your friends over here at WebAssist! These Dreamweaver extensions will assist you in building unlimited, custom websites.

Build websites from already-built web applications

These out-of-the-box solutions provide you proven, tested applications that can be up and running now.  Build a store, a gallery, or a web-based email solution.

Want your website pre-built and hosted?

Close Windowclose

Rate your experience or provide feedback on this page

Account or customer service questions?
Please user our contact form.

Need technical support?
Please visit support to ask a question





Ease of use


security code refresh image

We do not respond to comments submitted from this page directly, but we do read and analyze any feedback and will use it to help make your experience better in the future.