PowerStore Theme API

Tutorial created by Ray Borduin, WebAssist

Categories: PowerStore

2 ratings | Sign in to rate this tutorial | View comments

next section

API

<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>

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>

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>

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>

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>

wafonts contains all font information for the theme

<wafontface>

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

</wafontface></wafonts></waexposedtags></wastylegroup></theme_default></theme_defaults></theme_image></theme_images></theme_page></theme_pages></theme_map>

What 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.

Reviews 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.

2 ratings | Sign in to rate this tutorial