basket page, bypass and go directly to checkout – If you want to place an item into the users cart but do not want to take them to the basket page.  Instead click on a product and take them directly to checkout.  If you want it to be the default, this directive in catalog.cfg should work:

SpecialPage     order   ord/checkout


catalog, delete – Four steps

1. Remove the Catalog line from interchange.cfg, i.e.

perl -pi.bak -e 's/^Catalog\s+construct.*//' interchange.cfg

Or use your favorite editor.

2. Remove the link program (i.e. /cgi-bin/construct).

3. Remove the HTML directory (i.e. /home/httpd/html/construct).

4. Remove the catalog directory (i.e. ~/catalogs/construct).

color, change category background color – edit /var/lib/interchange/foundation/templates/foundation/theme.cfg and change category CATEGORYBAR_BG color from #993333 (red) to #339933 (green) or #333399 (blue) or #663399 (violet).  Restart interchange.

clear out old sessions when interchange dead or not responding - see sessions, expired – purge

Credit card info workaround –

In the directory /usr/lib/interchange/lib/Vend or wherever your IC install is in the /lib/Vend directory there is a file called Order.pm.

 Note: I don't recommend you do this unless you are an experienced IC developer and have an understanding of IC structure.

 Do a find and replace in your favorite editor for the following in the following section only:

Section: sub route_order (2 places)



Replace with:


 This will print the full credit card number and info on the mail to store owner.  There maybe one other line that needs to be fixed that was sent to me by another developer. I will post it Monday when I'm in the office.


database structure – http://interchange.redhat.com/cgi-bin/ic/dev-4.8/icfoundation_13.html

debian packages - http://mirror3.cs.wisc.edu/pub/mirrors/linux/debian-ipv6/dists/sarge/ipv6/binary-hppa/Packages

root@debian-2~: dpkg -l *interchange*
ii interchange 5.2.0-1 e-commerce and general HTTP database display system
pn interchange-cat-foundatio <none> (no description available)
ii interchange-doc 4.8.3-1 Interchange Documentation
pn interchange-ui <none> (no description available)
pn libapache-mod-interchange <none> (no description available)

debug – create a detailed debug log to help track down problems. To enable it, do the following:

1.     edit interchange.cfg and remove the '#' where Variable DEBUG 1 is defined.

2.     edit the source module that affects the feature you are looking at. Most of the work is done by .pm modules in the lib/Vend subdirectory of where interchange is installed (/usr/lib/interchange in my case). There are many lines that begin


Use your editor to remove the '#' comment character and save the modules.

3.     restart interchange

 As you run your tests, messages will be collected in "/tmp/icdebug" that will be very helpful.

When you are done don't forget to reverse the process.

Demo mode – “General” area in preferences

interchange dead or not responding - see sessions, expired – purge

directories –

Interchange software directory: /usr/lib/interchange
Catalogs directory: /var/lib/interchange
cgi-bin directory: /var/www/cgi-bin.
.cfg files (catalog.cfg, interchange.cfg) – /usr/lib/interchange

disk full - see sessions, expired – purge



emails – racke@linuxia.de

error log - /var/log/interchange

expired sessions, purge – see sessions, expired – purge


flypage – controls what shows up for an item

Fred's Hardware - original

Fred's Hardware modified admin page


.gifs – see logo

global variables –

·        See list of: /var/lib/interchange/foundation/products/variable.txt.

·        More: /usr/lib/interchange/foundation/templates/foundation/theme.cfg and /var/lib/interchange/foundation/templates/foundation/theme.cfg

·        Add a new variable: from the front end, go into admin, Administration, Preferences, Admin Layout, New Entry.  In the form that comes up, enter the variable name for “Variable Name”, the variable value for “Variable”, and either select an existing “Preferences Area” or make up a new one.



id – “interch” is the default admin ID

initial setup values – /var/lib/interchange/foundation/config/additional_fields

interchange dead or not responding - see sessions, expired – purge

interchange download




logos – /var/lib/interchange/foundation/images/foundation



logo, company, change – edit /var/lib/interchange/foundation/templates/foundation/theme.cfg and change THEME_LOGO from __THEME_IMG_DIR__/logo.gif to __THEME_IMG_DIR__/mylogo.gif.  Make sure mylogo.gif is in /var/lib/interchange/foundation/images/foundation (or maybe /var/www/html/overland/images/foundation).  Restart interchange.


merchant account – www.costco.com, 1 (877) 807-6239  Costco Merchant Services


not responding - interchange dead or not responding - see sessions, expired – purge


order number, change from TEST0001– edit /var/lib/interchange/foundation/etc/order.number


parameters, pass

How do I pass values to the usertag if want to call the usertag from an interchange page?

If it is called like this




[sometag $data1 $data2]



You can't mix Perl and ITL Like that. But you can do:




return $Tag->sometag($data1, $data2, $body);


The $body of course is the container text between [sometag] and [/sometag]. It isn't used in your example, but since you defined hasEndTag it will be handled.

Password, Look for in: /var/lib/interchange/sam/products/access.asc

password for admin no longer works/is corrupt –

Delete access.gdbm

Use a command line viewer to look at access.asc, or even better, to edit it.

It appears that you can have the second field blank (the password field) and it will let you in.

Once access.gdbm is deleted, a new one will be generated from access.asc

Please specify the MailOrderTo directive – if you get this problem when you first create a catalog, it probably means you selected something other than “interch” for the user.  Just use “interch”.  That seems to be the only one that works.  (http://interchange.redhat.com/archive/interchange-users/2001/msg08665.html)

Product template – pages/flypage.html.  You can make a template page for any item (i.e. 00029.html) and put it in the catalog's pages directory, and IC will use that instead of flypage, giving you some ability to customize the look and feel on an item-by-item basis.  Probably better is to use PageSelectField to choose from a series of templates based on a property of the product... or perhaps to store display attributes in a database keyed by item sku, category or some other relation and use those to set page properties on the fly...

Purge expired sessions – see sessions, expired – purge



RedHat logo bottom, get rid of – see templates

RedHat logo top, get rid of – change NO_REDHAT_LOGO global variable.  It’s set to 1 in /usr/lib/interchange/lib/UI/pages/admin/do_save.html

Restart interchange – interchange -r


“see also…”, get rid of – rename /var/lib/interchange/foundation/templates/components/random to something else

sessions, expired – purge

/usr/lib/interchange/bin/expireall -r

or, if already in /usr/lib/interchange/bin

./expireall -r

these instructions used to be here but now are here

“specials”, get rid of – rename /var/lib/interchange/foundation/templates/components/cross to something else

stopped, interchange dead or not responding - see sessions, expired – purge

subcategories – GC>>An example:

I have a Parent category named Figurines. There are sub categories under this one named Wildlife, Angels and Fantasy.


·        Wildlife

·        Angels

·        Fantasy

In the Layout section of the UI you are presented with 3 sections across the page. The left one is where you will see things like "New Items", "specials", "Gift Certificates", and such. You want to hit on the plus sign here to create a new category. Scroll down on the left side and it should say 'NEW'. Change that to 'Figurines' and make sure that it is labeled as 'Name' instead of using a link or page, or whatever. (I'm not looking at the page, but doing it from memory) Click on the button to save it.

When the screen returns in that left hand box you will see 'Figurines'. Select that. In the middle of the screen should be an empty box. Click on the plus sign below that. Further down on the screen you will see 'NEW' in a box. Change that to 'Wildlife'. There is an option for you to put in an Interchange page. Select the page that you want it to go to. Or, you can put in your search criteria. Click on the save button.  Open up your store and you should see these in the left frame. 'Figurines should not be 'hot' but 'Wildlife' should be.


template, change – Open IC Administration. Click the Content button. Click Template Edit in the sub-menu. A box will show three templates. You must edit each one.

TEST0001, change – edit /var/lib/interchange/foundation/etc/order.number

Thumnails in results page

In Admin, go to Content, Page Edit, edit the “results.html”

You’ll see something like this:

<table width="90%" border="0" cellspacing="0" cellpadding="3">

<tr class="contentbar2">


  <td align="center"><b>SKU</b></td>

  <td align="center"><b>Stock</b></td>

  <td align="center"><b>Price</b></td>

  <td align="center"><b>Qty</b></td>

  <td align="center"><b>Buy</b></td>


replace “SKU” above with “Picture” (assuming you want to get rid of SKU and put in the thumbnail in its place.  Go down further ‘till you find:

<tr valign="middle">


      <INPUT TYPE=hidden  NAME="mv_order_item"  VALUE="[item-code]">

      <a href="[area [item-code]]">[item-description]</a>


      <td align="center">[item-code]</td>

      <td align="center">


      my $q = q{[item-data inventory quantity]};

Replace <td align="center">[item-code]</td> with:

<td valign="top" width="40">

        [if-item-field thumb]

         <a href="[area [item-code]]">

         <img border="0" src="thumb/[item-field thumb]">



         Not Available





Traffic Statistics, reset – delete logs/usertrack.  Or look in the admin ui, Preferences > Directories and Paths > UI_TRAFFIC_STATS


undefined catalog – make sure "Server name" and "MailOrderTo" don’t have too many characters in the domain name.  For instance "ecommerce-webmasters.com" and "ecommercewebmasters.com" do not work but “mochak.com” does


variables, setting – see global variables