eXtropia: the open web technology company
Technology | Support | Tutorials | Development | About Us | Users | Contact Us
Download resources
 ::   Free applications
 ::   Download license
 ::   Documentation
 ::   Free Support

Download FAQs
 ::   What do I do with a .tar file?
 ::   Are your products secure?
 ::   Do I need a web server to use your products?
 ::   What is Perl and do I need it to use your products?
 ::   What is the ADT?
 ::   What About Support?
webstore
WebStore Setup FAQ Donated by CC Edwards Co  

Web Store 1.x Docs
Sales: sales@ccedwards.com Tech: tech@ccedwards.com

STORE SETUP DOCUMENTATION

NOTE: THIS DOCUMENTATION IS FOR USE WITH WEB STORE 1.7 OR OLDER VERSIONS.  IF YOU HAVE WEB MERCHANT 2.0 OR HIGHER PLEASE RETURN TO THE MAIN SUPPORT PAGE AND USE THE OTHER DOCUMENTATION.   FREE INSTALLATION OF WEB MERCHANT 2.0 IS AVAILABLE FOR CURRENT HOSTING CUSTOMERS, CONFIGURATION IS AVAILABLE FOR AN ADDITIONAL $25.00.  NON-HOSTING CUSTOMERS OF C.C. EDWARDS CO.  PAY $199.95 FOR CONFIGURATION AND SETUP.

My store is installed but not configured.  How do I configure it?
Log in to your site via FTP.  Then using WordPad or Notepad edit the following files as detailed.  Do not attempt to change anything else.  It's not necessary.  When doing the editing you must first download the file then after you are done editing the file you must save the changes and upload it back to the server.

OPEN
: /cgi-bin/Web_store/Library/Web_store_order_lib.pl
Search for the word "replacethis" found in the line that says
<a href=https://ssl.businesshost.net/replacethis/securedorderform.cgi>
And replace the "replacethis" with your domain name, but leave off the "www" and "com". Save The File.

OPEN:  /cgi-bin/Web_store/Library/web_store.setup.frames.javascript
Replace the following lines
In the section
Order Form Definition Variables
$sc_sales_tax = ".07"; # 7%
Change this to your actual rate
@sc_sales_tax_form_values = ("MI", "Michigan");
Change this to your state information
$sc_order_email = "sales\@replacethis.com";
Change this to your e-mail address
In the section
# HTML Search Variables
$sc_root_web_path = "/web2/home1/replacethis-IP/cgi-bin/Web_store/Html/Products";
Replace this with the path on your server.
HINT: Log in to your site with CuteFTP and look in the right hand "server" frame and it will show you the path information.
$sc_server_url = "http://replacethis.com/cgi-bin/Web_store/Html/Products";
Replace this with the actual URL. Just replace "replacethis.com" with your IP number and it will work.
Under
Miscellaneous Variables
$sc_admin_email = "sales\@replacethis.com";
Change this to your e-mail address

OPEN: cgi-bin/Web_Store/HTML/outlet_frontpage_db.html
Edit the file to customize your front page with your own words and graphics.

OPEN
: Setup your ssl directory (credit card capture form processor)
Login Using Telnet with the information we sent you by e-mail
Using Pico As your editor (NOT FTP)

OPEN: the file securedorderform.cgi
Change the "
replacethis" with your domain name.

OPEN: the file securedorderform.setup
Change the "
replacethis" with your domain name.
There is several places to do this.

That's it.  Your store should be functioning.  Test it by going to your site administration consoles and clicking on CHECK STORE SETUP.  If anything is wrong it will tell you exactly what the problem is.

STORE CUSTOMIZATION DOCUMENTATION

How Do I Add or Delete or Modify the Product Groups or Categories in the left hand frame?

To modify your catagories edit the file toc.html
in the cgi-bin/Web_store/Html directory
find the block of text that says

<A HREF = "web_store.cgi?product=letters&cart_id=" TARGET = "main">list product catagory
here</A>

See where it says letters, simply replace letters with the appropriate category  from your database. To add more category , just copy and paste this again, and change the category  to point to the new category . When adding inventory with our Inventory Manager simply type the same category name and it will call all products with that group name.   The store has a default limit of 25 items per group, but there is no limit to the number of groups.  We can change you limit if you need it but the page load times will become extreme if we do extend it for you.  To add a product go to your site administration console and click on "administrate inventory" complete help documentation is installed on the add product screen.

To modify your front page edit the file outlet_frontpage_db.html
in the cgi-bin/Web_store/Html directory .
This is just a simple HTML document nothing magic here.

I want to change how the shipping charges are handled by the store script. How do I do this?
Using WordPad open the following file.
/cgi-bin/Web_store/Library/web_store.setup.frames.javascript
Replace the following lines
Shipping and handling can be the most difficult field to configure. 99% of the time the reason is not understanding the fields and having the variables in the wrong field. When placed correctly it works flawlessly. Don't bother looking all over the place these are the only options to configure, if it doesn't work, you have either a case sensitive issue or you put the per piece rate in the quantity field or another relational transposition.
This defines your shipping variable used on the order form
@sc_order_form_shipping_related_fields = ("22-shipping");
In the Order Form Definition Variables Section
There are five fields in the shipping variable logic array.

shipping related field|subtotal price|quantity|measured value(not used unless large editing)|amount to charge
This creates a per piece rate charge
@sc_shipping_logic = ("handling||1||8.00", "handling||2||16.00", "handling||3||32.00", "handling||4||40.00", "handling||5||48.00", "handling||6||56.00", "handling||7-||64.00");
This creates a % by dollar volume charge
#@sc_shipping_logic = ("usps|1-|||15%", "ups|1-|||18%", "dhl|1-|||35%");
This creates a per piece rate without regard to type shipping method
@sc_shipping_logic =
("|1-1||6.00");
("|2-5||15%");
("|10-||0.00);
This equals 1 Item is $6.00
2-5 Items equals 15% of cost.
10 + Items equals Free Shipping.

Shipping can be either a % of the cost or a per piece rate. Or a combination of both depending upon the number of items ordered. Before making changes to this file, make a backup copy in case you make a mistake. We will charge you $50.00 per hour to correct your mistakes if we are asked to do so. Also, we set the store script to 15% of cost by default as part of the installation.
Save the file as a text file. Upload it via FTP using ASCII method. Binary Upload can destroy the file.

Can I work with the database directly?  Can I add options for color and sizes, etc.?

Yes and Yes.

To add or delete inventory you simply edit the data.file
in the directory cgi-bin/Web_store/Data_files/
This is how the data file looks

20171|letters|119.95|20171clocks|<img src="http://www.yourdomain.com/152f.jpg">|Authentic
rendition of a century-old clock, hand-carved of genuine teakwood. 9 1/2" x 4" x 17 3/4" high. 119.95|

This is what it means
item # | catagory | price | part number | image tag reference | product description and price displayed in
store |

upload all your pictures to the docs directory and point the image tag to it's location. You can not
load pictures from inside the cgi-bin directory.

All you do is change the information and upload it.

Presto...the webstore will create all HTML on the fly for you.
If you want to use options in your database, for things like ring sizes, dress sizes, etc. You will have to manually update your database. The syntax is like this.
20171|letters|119.95|20171clocks|<img src="http://www.yourdomain.com/152f.jpg">|Authentic
rendition of a century-old clock, hand-carved of genuine teakwood. 9 1/2" x 4" x 17 3/4" high. 119.95|%%OPTION%%option.html
Where option.html is the name of a HTML file uploaded to the HTML/Options directory. Several are loaded for you already if you want to test this. If you need multiple options simply call a different HTML file that you upload to this directory.

How do I change the background color, text colors, etc. on the product generated pages? 
Using FTP OPEN: cgi-bin/Web_store/library/web_store_html_lib.pl
Complete documentation is located inside this file.

I used a HTML editor on the front page where the search box and now the cart dumps it's content, what do I do?

First of all we instructed you to use a word processor.  Some non-cgi compliant editors strip a couple lines of code from the outlet_frontpage_db.html file.  You need to replace it.  If you need to use an HTML editor use one that is CGI/Perl compliant, such as coffeecup.
This is the line that it removes.
<INPUT TYPE = "hidden" NAME = "page" VALUE = "outlet_frontpage_db.html">
<INPUT TYPE = "hidden" NAME = "cart_id" VALUE = "%%cart_id%%">
This line should follow
<FORM METHOD="POST" ACTION="web_store.cgi" ENCTYPE="x-www-form-urlencoded">
But remain before the field arrays start.