ad banner module for xcart documentation

Example of how to setup 3 banners on your X-cart store

Step 1 - Setting Up The 3 Banner Types In The X-cart Admin

1. Log into your X-cart admin
2. Click on the "Ad Banner" link
3. Scroll down till you see the "Banner Types" section
4. Enter the text (for example): "bottom_left_menu"
5. Click "Add New Type"
6. Enter the text (for example): "bottom_middle"
7. Click "Add New Type"
8. Enter the text (for example): "bottom_right_menu"
9. Click "Add New Type"

Step 2 - Adding The Banner Code To Your Website

1. Open up skin1/customer/home.tpl in your favorite template editor (notepad works fine for this)
2. To place the "bottom_left_menu" banner
   1. Find this code: {include file="help.tpl" }
   2. After the help include, insert this code: { include file="customer/main/ad_banner.tpl" banner_type="bottom_left_menu"}
   3. Note how we changed the "your banner type here" text in this include line to be the banner type you created in the admin
3. To place the "bottom_middle" banner
   1. Find this code: {include file="customer/home_main.tpl"}
   2. After the help include, insert this code: { include file="customer/main/ad_banner.tpl" banner_type="bottom_middle"}
   3. Note how we changed the "your banner type here" text in this include line to be the banner type you created in the admin
4. To place the "bottom_right_menu" banner
   1. Find this code: {include file="customer/home_main.tpl"}
   2. After the help include, insert this code: { include file="customer/main/ad_banner.tpl" banner_type="bottom_right_menu"}
   3. Note how we changed the "your banner type here" text in this include line to be the banner type you created in the admin
5. Code insertion all done! You can do this as many times as you like. Once for each banner spot you want to have on your site.

Step 3 - How To Add Banners To Your Site

1. Log into your X-cart admin
2. Click on the "Ad banner" link
3. Fill in any fields you want in the "Add Banners" section. Note that only the "image" OR the "HTML banner" sections are required.
4. Note that we recommend the priority be about 10 or greater for better random rotation of the banners.