GT Support Pages

General

Where do I find the Getting Started Guide/Help Files?

You can find it by clicking here.

You can also find all the help files here.

Version 1.0 help files can be found here.

How do I replace the default homepage on my site?

To do this you will need at least an FTP client (eg: CuteFTP, WSFTP, etc) and a possibly an Webpage Creation program (eg: Dreamweaver or Adobe GoLive).

Please follow these steps:

Create your page that you want to display on your site. Please consult the documentation for the program that you are using for more details on how to create a page. (If you people to access your shop, please make sure you link through to http://www.yourdomain.co.uk/shop/ - replacing www.yourdomain.co.uk with the your site's domain name).
Set-up your FTP details in your FTP client. (You will have received these details when your site was set-up. Please e-mail support, if you have not received these).
Browse to the public_html folder on your site. This will involve going up two levels then entering the public_html folder, your FTP client should now point at "/public_html".
You may find a page index.htm (or index.html). It is suggested that you rename that to something else, in case you want to access it later.
Make sure that your new page is name index.htm, if not then please rename it.
Upload your new index.htm file (and any images) to the /public_html folder on the server. (The FTP client will have documentation on how this is done)
Disconnect your FTP Client and check the page with a public_html browser.

If you need to make any changes then repeat the process except step 1, where instead of creating a new page, you will need to edit your existing one.

NB: Please note that we can NOT provide any direct support for the use of FTP clients and Webpage Creation Programs. You should first check the manual or contact the manufacturer directly.

How do I link my current site to my GT Shop?

Before you try and link to your shop, it would be wise to make sure that you've created some products and categories in your shop (make sure a rebuild has been done).

To link to the shop you will need to create some links in your current site to:
http://www.domain.com/shop/index.htm
(where www.domain.com is the domain name for your shop).

To edit the links in your current site, you will need to edit the pages on your current site (we can't provide help with this). To make these changes you may need to contact the person who did your original site design.

How do I activate Product Pop-ups? (and make changes to them).

Product Pop-ups are activated through the Program Setup section of the admin system. Look for the heading "Use product pop-ups?:", select "yes" then you will find the following details:

Trim after a maximum of ?? characters This sets the number of characters that GT will display of your product description before it shows the pop-up link. (eg: if you enter 100, GT will show the first 100 characters of your product description before showing the pop-up link). If you want a pop-up to appear regardless of the description length, then enter a 0 into this box, the pop-up will always be displayed.

Pop-up width: ?? pixels height: ?? pixels This sets the width and height of the pop-up window that is displayed. You should change these as best fits your site.

Once you've completed these boxes then click the "Update Geeky Stuff" button at the bottom of the page.

I'm using frames on my site but I keep getting new windows opening when I click a link.

When using frames Get-Trolleyed needs to know what the name of the main frame where it results will be appearing. To set this, login into the admin system and go to the Program Setup secion. Find the heading: Main Frame Name. If you enter the name of your main frame then GT will show everything inside that frame. When you've entered this, click the "Update Geeky Stuff" button at the bottom of the page.

What is the path to my Primary Log File?

This is the address to find the log files for your website. You may need to contact your hosting company to get the address to type in here. (If you are hosted with Get-Trolleyed then please contact us for the location).

How do I hide the Quantity Box?

If you want to hide the quantity box (and set a default quantity for all the products) then use the following guide:

FTP into your site and download /trolleyed_admin/conf.txt (Make sure you keep a copy of the original file in case anything goes wrong!)
Open up conf.txt in notepad (or another text editor).
Replace the following lines:

# if you are allowing quantity to be chosen, how do you want the user to select it?
quantity_html = '<B>Quantity:</B> <INPUT TYPE="TEXT" NAME="quantity" SIZE="2" MAXLENGTH="2" VALUE="1">';
with:
# if you are allowing quantity to be chosen, how do you want the user to select it?
quantity_html = '<INPUT TYPE="HIDDEN" NAME="quantity" VALUE="1">';
Save the conf.txt file.
Upload again to the trolleyed_admin folder (you will need to overwrite the current one.
Rebuild the shop to make your changes live.

How do I change the Quantity Box into a Drop Down List?

If you want to set-up your shop so that you have a select box for the customer to select the quantity, then you can do so as follows:

FTP into your site and download /trolleyed_admin/conf.txt (Make sure you keep a copy of the original file in case anything goes wrong!)
Open up conf.txt in notepad (or another text editor).
Replace the following lines:

# if you are allowing quantity to be chosen, how do you want the user to select it?
quantity_html = '<B>Quantity:</B> <INPUT TYPE="TEXT" NAME="quantity" SIZE="2" MAXLENGTH="2" VALUE="1">';

with:
# if you are allowing quantity to be chosen, how do you want the user to select it?
quantity_html = '<b>Quantity:</b> 
<select name=quantity>
<option value=1 selected>1</option>
<option value=2>2</option>
<option value=3>3</option>
<option value=4>4</option>
</select>';
You can add extra lines, with the number increasing, as necessary until you reach your desired maximum.
Save the conf.txt file.
Upload again to the trolleyed_admin folder (you will need to overwrite the current one.
Rebuild the shop to make your changes live.

How do I create my own Special Offer Templates?

In the admin directory, you will find a file called offer_templates.txt. This file contains the Perl code templates for the special offers.

The items in a shopper's cart are stored in a "hash of a hash" called %cart_item. For simplicity, we'll refer to the keys as primary and secondary, ie:

$cart_item{'primary key'}{'secondary key'}

The hash's primary keys are the product IDs of items in the cart combined with options selected (if appropriate). The secondary keys are the attributes of the item. For each product, the following secondary keys exist/are calculated:

options - options selected (may not exist)
quantity - quantity of item in carts above
unitprice - unit price of item

When part of a special offer, the following secondary keys are added to the hash:

d_unitprice - unit amount of offer. This is subtracted from the order total at checkout time
offer_quantity - the number of times the offer has been qualified for. Eg, if it was "buy three, get one free", and the shopper had ordered 'six', then the offer_quantity would be two
hookline - message to display in cart and in order to explain the offer

Each offer template has several sections...

offer_template_id line - unique identifier for the offer template
offer_description line - initial hookline to offer administrator when setting up the offer
criteria line - any special instructions that make the order valid
criteria_code line - Perl statement that must be true for the amounts entered for that offer
code section - code to execute on %cart_item to add the offer details

Code must end with return 1; or the eval fails.

Elements entered in braces in the code are read by the special offers admin script and presented as inputs for the administrator to complete. Valid inputs (where X is a digit) are:

(product_X) - a valid product ID
(quantity_X) - a valid, positive quantity
(percentage_X) - an integer percentage > 0

If you've got this far and still want to try and create your own special offer templates, take a look at the existing ones first and make sure you understand them before proceeding.

Notes

Each product ID is allowed to be in one offer only. This is to avoid possible looping of offers.

Eg, if you had an offer of "buy Product X and get Product Y free", and also had an offer of "buy Product Y and get Product X free," the scripts would start to cry...

Think hard about the implications of an offer when creating it. We lost a little sleep over "buy X, get Y free" as far as rounding quantities up or down went. Finally, we decided that the only way to do it was to force the shopper to take the free ones, even if they may not want them.

Eg, say the offer was "Buy three and get one free" and they wanted to buy six. We could have charged them for five and given them one free, but we decided to charge them for six and give them two free.

What # variables can I use in the E-mail templates found in Order Processing and in my HTML templates?

There are quite a lot of variables you can include, but the chances are that you won't be using all of them! each variable must be enclosed within # characters, eg #inc_tax_unitprice#, when inserted in the appropriate template.

#product_name# - the name of the product selected (used in the add_prod.htm and view_cart.htm templates)

#prodid# - the product ID of the product selected (used in the view_cart.htm template)

#product_options_html# - where to display the selected options for that product (in the add_prod.htm and view_cart.htm templates).

#quantity# - the quantity of the product ordered with specific options chosen

#unitprice# - unit price of product added to cart - automatically includes VAT if VAT selected in the shop attributes section of the global admin section. Only used in the tpl_addprod.htm template.

#total# - total for number of new product offered - automatically includes VAT if VAT selected in the shop attributes section of the global admin section. Only used in the tpl_addprod.htm template.

#viewcart_url# - marker for script generated link to the view cart page. Only used in the tpl_addprod.htm template.

#associated_products# - Where to display the message detailing associated products for that product (if defined). Only used in the tpl_addprod.htm template.

#weight# - unit weight of product, if postage worked out by weight

#inc_tax_unitprice# - unit price of product, inclusive of tax

#ex_tax_unitprice# - unit price of product, exclusive of tax

#unit_price_tax# - #inc_tax_unitprice# minus #ex_tax_unitprice#

#inc_tax_unitprice_total# - unit price of product times quantity ordered, inclusive of tax

#ex_tax_unitprice_total# - unit price of product times quantity ordered, exclusive of tax

#hookline# - "hookline" of special offer (see special offers section for details)

#inc_tax_offerprice# - unit value of offer, inclusive of tax

#ex_tax_offerprice# - unit value of offer, exclusive of tax

#offer_quantity# - number of units of offer qualified for

#inc_tax_offer_total# - unit value of offer times number of units of offer qualified for, inclusive of tax

#ex_tax_offer_total# - unit value of offer times number of units of offer qualified for, exclusive of tax

#inc_tax_products_total# - total of all products ordered, inclusive of tax and any offers that may apply

#ex_tax_products_total# - total of all products ordered, exclusive of tax and any offers that may apply

#products_total_tax# - #inc_tax_products_total# minus #ex_tax_products_total#

#postage# - the postage type selector in tpl_addprod.htm and tpl_viewcart.htm

#country# - country selector in tpl_addprod.htm and tpl_viewcart.htm, country selected in checkout form

#vat_no# - VAT number input in tpl_addprod.htm and tpl_viewcart.htm, displays entered VAT number in checkout form

#inc_tax_postage# - postage amount, inclusive of tax

#ex_tax_postage# - postage amount, exclusive of tax

#postage_tax# - #inc_tax_postage# minus #ex_tax_postage#

#ex_tax_grand_total# - #ex_tax_products_total# plus #ex_tax_postage#

#inc_tax_grand_total# - #inc_tax_products_total# plus #inc_tax_postage#

#grand_total_tax# - #products_total_tax# plus #postage_tax#

#postage_band# - name of postage type selected (as defined in the postage rates section)

#weight_total# - total weight of order in weight unit, if you are working out postage by weight.

#order_details# - used in tpl_checkout.htm to mark where to display order summary. Used in e-mails, printouts and faxes to show details of the order, as defined in the Inc/Ex VAT order details templates.

Can I change the list of countries that is displayed?

Download the iso_countries.csv file from the /trolleyed_admin folder. Open this file in a Spreadsheet or text editor (whichever you prefer).

Remove all the lines that you don't want to be displayed. Please make sure that non of the other information is change, as this may affect connections to payment systems.

Once you've done then save the file and re-upload to the /trolleyed_admin folder. When you go back onto the site the list will just display the ones that you have left

Can I remove the Country Select from the Cart?

First remove the #country# tag from the tpl_viewcart.htm and tpl_addprod.htm templates. You will then need to add the following:
<INPUT TYPE="hidden" NAME="country_id" VALUE="217">
When the user get to the checkout the country will already be selected for them.

The value 217 refers to the United Kingdom, if you want to use another country then please replace 217 with the id of the country that you want. Please see the /trolleyed_admin/iso_countries.csv file for a full list.

Can I remove the Postage Select from the Cart?

This is done in exactly the same way as for the country select. Except you will need to put the following:
<INPUT TYPE="hidden" NAME="postage_band" VALUE="postage_name_goes_here">
Where postage_name_goes_here is the name of your Postage band (eg: UK).

Contents / Next