Zen Cart Integration

This does not imply that you can integrate the design studio directly into Zen Cart, so that Zen Cart sees the tool and the design tool communicates with the Zen Cart database. But rather, the wePrint Design Studio communicates with the shopping cart feature of Zen Cart.

Zen Cart - wePrint Integration

NEW Files Available: The files required for Zen cart integration can be downloaded HERE. Please read the guide below for details on configuring your store. Features:
  • Add items to your Zen cart from within the Design Studio. When the customer returns to the Zen cart the items will be in the cart.
  • Customer can add Design ID to item from within the product page.
  • Customer can search for there designs from within the store.
In order for the wePrint Design Studio to be able to communicate with the Zen Cart, the designstudio folder must reside within the Zen Cart folder. For example, if your Zen Cart is installed at: mydomain.com/store then the wePrint designstudio folder must be within the store directory, mydomain.com/store/designstudio. If the Zen Cart is installed at the top-level than the designstudio directory can reside at the top-level also.

Add to Cart Functionality


There are 3 new files that are needed to communicate with your Zen shopping cart:
  • wep_addcart.php
  • wepcart_options.php
  • zen-options.xml
This files need to be located in the top-level of your store. If you store is the top-level of your site (i.e. mydomain.com) then these files must be at the top-level of your site.

zen-options.xml
At this time, the zen-options.xml file is used to map the attributes in your store with the product options in the design studio. Each attribute within Zen cart has a numerical ID. This numerical ID needs to be manually mapped within the zen-options.xml file. Below is the zen-options.xml file from the Tshirt Pub demo:
<zenOptions>
 <Products>
    <product name="Adult-SS">2</product>
    <product name="Ladies-SS">4</product>
    <product name="Youth-SS">3</product>
 </Products>
 <Sizes id="1">
    <size name="S">1</size>
    <size name="M">2</size>
    <size name="L">3</size>
    <size name="XL">4</size>
    <size name="2XL">5</size>
    <size name="3XL">15</size>
    <size name="4XL">16</size>
 </Sizes>
 <Colors id="3">
    <color name="White">9</color>
    <color name="Black">10</color>
    <color name="Ash">11</color>
    <color name="Navy">12</color>
    <color name="Hot Pink">13</color>
 </Colors>
 <printLocations id="5">
    <location name="one sided">17</location>
    <location name="two sided">18</location>
 </printLocations>
 <designIDfield>4</designIDfield>
</zenOptions>

Zen Cart Options IDs

Each product and option within the Zen cart has a numerical ID assigned to it. The zen-options.xml file needs to contain these numerical ID's so that the design studio can correctly add products and options to the cart. The following steps decribe the mehtod for determining what IDs have been assigned by Zen Cart.
  1. Product ID's

    Go to Catalog=>Categories/Products and click on the category that contains your products. In our case, we have a Custom T-shirts category which has the three products - Adult SS, Ladies SS and Youth SS. The ID's 2, 4, and 3 need to be entered into the zen-options.xml file, as seen in the above code.
  2. Attribute ID's
    Each attribute has an ID (i.e. Size, Color, etc). In our demo site we have 4 attributes: - a text field for the design ID, a dropdown menu for size, a dropdown menu for color and a dropdown menu for print location. Go to Catalog=>Option Name Manager and locate the ID's for each attribute. Once you have these ID's, enter them into the zen-options.xml file, as seen above.

  3. Option Name ID's
    Each option within an attribute has an ID (i.e. S, M, L etc). In our demo site we have 4 attributes: - a text field for the design ID, a dropdown menu for size, a dropdown menu for color and a dropdown menu for print location. Go to Catalog=>Option Value Manager and locate the ID's for each option. Once you have these ID's, enter them into the zen-options.xml file, as seen above.

    Page 1 of Options:


    Page 2 of Options: