### ### FishCart Per Client Installation Template ### versie 2.2 ### ### PLEASE READ THE DOCUMENTATION IN "./docs/README" AND "./docs/FAQ" ### IN THE MASTER DISTRIBUTION BEFORE TRYING TO MODIFY THIS FILE FOR ### THE FIRST TIME. THE DOCUMENTATION WILL EXPLAIN CONCEPTS THAT ARE ### ESSENTIAL TO PROPERLY SETTING VALUES IN THIS FILE. ### # Copy and modify for each client. This template must be in the # ../fishcartsql.db directory for the installation scripts to find it. # # See the '-n' option to the install*.pl scripts. # # Set up the custID, domain, etc. variables below, then look over the # rest of the %inst array for other things that have to be changed. # Be sure and set database passwords for the public, admin and split # cc database users. # These entries are outside of the %inst array as they are used to # fill in multiple values in %inst. # The $databaseeng variable is set by the -d option of the install*.pl # perl scripts; the value defined is stored in the file 'database.pl' # in the master distribution root directory; the file 'database.pl' is # included by the install*.pl scripts. # Cart template set to install; the default is the 'public01' set. # The template set name is the name of the directory below the cart # distribution root that the files are stored in. $template_set = "public01"; # 'custID' is a unique string to identify this particular catalog. This # is important in some SQL engines, as this is what distinguishes one # set of tables from another within the same database. Typically this # will be a string of 3-6 characters that will describe each client's # installation. See README for more information. # # The custID should be unique for each client across all carts on # a particular server. # # ex: an installation for acme.com might use an ID of 'acme'. # # DO NOT LEAVE THIS BLANK. $custID = "atz"; # The third level domain of the machine hosting the catalog, typically # "www" to form the URL "www.theirdomain.theirtld". "secmachine" is # the third level for the secure URL. Both of these must be given, # even if they are the same. $machine= 'www'; $secmachine= 'www'; # The ports supplied below are normally blank. If your application # requires a non standard port, specify below; the colon ':' must be # included as part of the application. $port=''; # default non secure server port is 80 #$port=':8080'; # example of a different non secure server port $secport=':80'; # default secure server port is 443 #$port=':444'; # example of a different secure server port # If you forget the ':' before the portnumber you will get errors during # normal operation. # The virtual domain name and top level domain for the machine hosting # the catalog. The first parameter is the second level domain only. # # example: for acme.com, set $domain = 'acme' $domain = 'fishcart'; # com, org, net, fr, it, etc. DO NOT USE A LEADING '.' # Use 'com.au' or 'co.uk', etc. for countries that add a country code # # example: for acme.com, set $tld = 'com' $tld = 'org'; # URL for the site's home page; edit as needed for your application. # # This does not normally need to be changed because it is composed of # values defined above. $homeurl = "http://$machine.$domain.$tld"; # URL for the unsecure catalog site; edit as needed for your application. # # This does not normally need to be changed because it is composed of # values defined above. $catalogurl = "http://$machine.$domain.$tld$port"; # URL for the secure catalog site; edit as needed for your application. # # This does not normally need to be changed because it is composed of # values defined above. $secureurl = "https://$secmachine.$domain.$tld$secport"; # if you don't have SSL enables you should change this to # $secureurl = "http://$secmachine.$domain.$tld$port"; # path to this cart's document root directory # (DO NOT END WITH '/') # # example: if the top of the acme.com web tree is /home/httpd/acme # set $droot = '/home/httpd/acme' $droot = '/opt/usr/atz/www/htdocs'; # path to this cart's secure document root directory # (may be the same as docroot -- DO NOT END WITH '/') # # example: if the secure pages for the acme.com web tree are in # /home/httpd/acme, set $sdroot = '/home/httpd/acme' $sdroot = '/opt/usr/atz/www/htdocs'; # the location of the secure server might be different. In this # example it's the same location # directory under the docroot and secroot where the cart is # to be installed; if in the web tree document root, leave blank # # example: if the acme.com fishcartsql is going to be installed in # the 'catalog' directory with a URL of http://www.acme.com/catalog/ # set $fcroot = 'catalog' (NO SLASHES) $fcroot = 'shop'; ### ### In the associative array below, ### NEVER change the left hand side; ### ONLY change the right hand value. ### %inst = ( # name of the host where the database engine is installed # uncomment only one of these # Solid does not use this parameter # ### MySQL name if on same server "databasehost", "localhost", # sometimes an ISP has a special MySQL server and you will # need to use the value below. ### MySQL alternative if the SQL server is on a network server ### example: "dbhost.acme.com" #"databasehost", '', # name of the installed database (uncomment only one of these) # # for mysql, set this to a unique value for each fishcart # installation ex. 'acme_catalog' # ### typically used for MySQL "databasename", 'atzdb', ### Solid unix pipe socket database connections on same server #"databasename", "upipe solid", ### Solid TCP/IP socket database connections on a network server #"databasename", "tcpip somehost.somedomain.tld 1313", # System DSN: name of the system DSN for the database in use # if used on an NT server, username and password if needed # applies especially to the fc_functions ASP files # # leave blank if not used on NT "sysdsn", '', "dsn_uid", '', "dsn_pw", '', # default installed language # see ./docs/languages.php for the available language # ISO codes and names "langiso", 'nld', "langname", 'Dutch', # In this example I'm using Dutch as the default language # default Associate ID; the value assigned to the AID if an AID # is not explicitely passed in the URL when a user enters the cart # for the first time (when the order is initialized) # # leave null if you don't need it; see docs/README for more info "default_aid", '', # default font appearance opening tag # NOTE: be sure to define 'fontclose' if you define this # # example: # 'fonttag', '', 'fonttag', '', # closing font tag; if 'fonttag' is not null, define this to # be '' # # 'fontclose', '', 'fontclose', '', # the /etc/passwd name of the account that owns the directory # where fishcart is installed (the 'catalog' directory for our # example acme.com installation "account", 'atz', # the /etc/passwd name of the account that owns the directory # where the secure fishcart pages are installed (the 'catalog' # directory for our example acme.com installation # # (may be the same as "account") "secaccount", 'atz', # order file system account owner name/group (/etc/passwd, /etc/group) # (may be the same as "account") # ### used only for special order file processing, which is NOT ### part of the default fishcart installation; leave blank unless ### you specifically know what is needed here "ordacct", '', "ordgrp", '', # Full organization name # use HTML markup in this name if needed "company", 'FishCart dot org', # the DOCROOT relative path to the default background graphic # # for the example acme.com fishcart installed in /home/httpd/acme, # if the background image is /home/httpd/acme/images/fond.gif, # set this to '/images/fond.gif' # # leave blank if you do not know what this will be at installation # time; it can be set later in the fishcart maintenance pages "backgraphic", '', # the DOCROOT relative path to the default masthead graphic # (graphic across the top of the pages) # # for the example acme.com fishcart installed in /home/httpd/acme, # if the background image is /home/httpd/acme/images/mast.gif, # set this to '/images/mast.gif' # # leave blank if you do not know what this will be at installation # time; it can be set later in the fishcart maintenance pages "mastgraphic", '', # this is the address to which fishcart orders will be sent # (i.e. to the merchant for processing) "orderemail", "orders\@$domain.$tld", # this is the From: address from which emailed confirmation orders # to the purchaser will be sent "orderconf", "custsvc\@$domain.$tld", # CyberCash Information # Use only if you are using the CyberCash clearing choice "cybercash_id", '', "merchant_key", '', # this client's SQL database public username/password # this is for limited access to the tables by the public # fishcart pages # # see ./docs/README for an explanation "userid", "${custID}public", "userpw", 'public', # Since this is an example I can use public DON'T do it on a live # cart! # this client's SQL database admin username/password # this is for full maintenance access to the tables # by the fishcart maintenance pages # # see ./docs/README for an explanation "admid", "${custID}admin", "admpw", 'admin', # Since this is an example I can use admin DON'T do it on a live # cart! # this installation's SQL split CC database username/password # fill in only if using split CC delivery # # a unique SQL database user/password for split credit card # number deliver is recommended for security reasons "dbdname", 'sbsplit', "dbdpass", 'dbsplitpasw', # even if you don't intend to use Credit Card payment you should # fill something here. If you don't you will get errors during # the rest of the install. ### Solid SQL Server Only # # Solid database fully privileged administrator account # required to be able to initially set up cart tables and users # assume the admin login, but can be changed as required "solid_adm", "${custID}admin", "solid_pw", "", # this client's Web page template SQL table # (if using mysql fill in your database name, otherwise leave empty) ### ### PRESENTLY UNUSED -- LEAVE BLANK ### "tpldbase", "atzdb", # don't mind the presently unused, if you're using MySQL you should # fill in the same name as under database # PGP key ID: the hex PGP key ID, if used, as '0x????????' # # leave blank if using split cc or unencrypted delivery "keyid", "", SNIPPING the other part of cust.db