Templates

This documentation only applies to versions 3.6.9 and higher.

Template tags are used within your shop’s Templates to display information dynamically or otherwise customize your shop, providing the tools to make it as individual and interesting as you are. Below is a list of the general user tags available in WP e-Commerce, sorted by function-specific category.

Usage:

A quick 5 step guide to creating a new theme layout for your products page:

  1. Goto your wp-e-commerce plugin folder
  2. Find the Themes folder (wp-e-commerce/themes)
  • Duplicate and rename the Default folder (wp-e-commerce/themes/default)
    note >> if you rename your new theme folder newtheme then the css file MUST be called newtheme.css
  • Find the file products_page.php in your newly renamed folder and make your HTML and css changes in this folder.
  • In the admin section under setting>presentations you will be able to select your new theme.

    • This code closely follows the way the wordpress loop works, however we do not yet support using a query like the wordpress query system works, for instance, this can be used to replace the system for displaying products in a page, not for placing single products in the sidebar.

    The relevant files are located in the wp-shopping-cart/themes directory.

    The new PHP files are:

    - products_page.php
    - single_product.php

    EDIT FROM SHAYNE:

    Just to clarify a little on the theme engine…

    You now have 2 new files in your themes directory (for each theme: default, ishop, marketplace, etc). One for products page and one for single product page.

    You can do all of your editing to these files now (to change the look/feel of page) and not have to edit several different files in the root of “wp-shopping-cart”.

    When upgrading you will only need to backup your theme folder, since it contains these new files that you have edited and your stylesheets. Place them back into new shopping cart (after upgrade) and you’re back in business!

    Hope that helps….

    There will be more files in future, and all wpsc themes must have these files in order to work.

    Breadcrumbs:

    wpsc_has_breadcrumbs()

    $wpsc_query->have_breadcrumbs()

    $wpsc_query->the_breadcrumb()

    wpsc_breadcrumb_url()

    wpsc_breadcrumb_name()

    Page Numbers:

    wpsc_has_pages()

    $wpsc_query->have_pages()

    $wpsc_query->the_page()

    wpsc_page_url()

    wpsc_page_number()

    Misc:

    wpsc_category_class()

    fancy_notifications()

    Products:

    $wpsc_query->have_products()

    $wpsc_query->the_product()

    wpsc_the_product_id()

    wpsc_the_product_title()

    wpsc_the_product_permalink()

    wpsc_the_product_description()

    wpsc_the_product_additional_description()

    wpsc_the_product_image()

    wpsc_the_product_thumbnail()

    wpsc_product_has_file()

    wpsc_the_product_price()

    wpsc_product_is_donation()

    $wpsc_query->product['price']

    wpsc_product_has_stock()

    wpsc_product_rater()

    do_action(’wpsc_product_addons’, wpsc_the_product_id())

    wpsc_akst_share_link(’return’)

    Custom Meta:

    $wpsc_query->have_custom_meta()

    $wpsc_query->the_custom_meta()

    wpsc_custom_meta_name()

    wpsc_custom_meta_value()

    Variations:

    $wpsc_query->have_variation_groups()

    $wpsc_query->the_variation_group()

    wpsc_vargrp_id()

    wpsc_vargrp_form_id()

    wpsc_the_vargrp_name()

    $wpsc_query->have_variations()

    $wpsc_query->the_variation()

    wpsc_the_variation_id()

    wpsc_the_variation_name()

    •