Knowledgebase: E-commerce/Alacart/Miva


What is Alacart?
Alacart is an e-commerce shopping cart designed for Burningbulb. It contains all of the functionality required to setup and run an internet shopping site. For more information on Alacart and its functionality please refer to the Alacart manual.

[ Back to Top ]


How many items will the basic Alacart program hold?
The basic Alacart program that comes will all Burningbulb accounts will hold a maximum of 10 items. To upgrade your Alacart program please contact the Burningbulb Sales Department for pricing information.

[ Back to Top ]


Can I upgrade my Alacart program to accept more items?
Yes. You can easily upgrade your Alacart program to accept more items. For more information contact the Burningbulb Sales Department.

[ Back to Top ]


What is the difference between Alacart Silver, Gold, and Platinum?
The only difference between Alacart Silver, Gold, and Platinum is the number of products the program is capable of handling. Alacart Silver comes with every Burningbulb account and can hold a maximum of 10 products. Alacart Gold has a maximum of 25 products while Alacart Platinum can handle a maximum of 100 products.

[ Back to Top ]


How do I change my Alacart password?
To change your password, perform the following steps:

1 - Go to: http://$domain.com/s-cart/admin/index.phtml (enter current password)

2 - Change the URL to http://$domain.com/s-cart/admin/setup.phtml

3 - Change the password

If you have forgotten your present password, contact support to have it reset. Be prepared to furnish proof of identity. Presently, requests coming from the official authorized e-mail address, as recorded in our databases, will be accepted.

[ Back to Top ]


My Alacart user name is not working. What could be the problem?
This frequently happens when a hyphen is used in the programs user name. When setting up an AlaCart shopping cart the username cannot have a hyphen. Therefore"user-name" would not work but "username" would. For additional assistance please open a Burningbulb Technical Support Ticket.

[ Back to Top ]


Why won't my shopping basket show the contents I've added?
AlaCart uses cookies to track a user's ordering actions. Make sure that you have cookies enabled in your browser. For additional assistance please open a Burningbulb Technical Support Ticket.

[ Back to Top ]


Why won't my logo show up on the checkout page?
The problem is that the URL entered for the logo was entered as an absolute path, not a relative path. Since the checkout page is secure, it tries to call the insecure path, and this causes the error. To correct, go to the "Look and Feel" page of the Administration Suite. Change the "Logo URL (path and name of logo on the server):" to a relative path. For example,

If it is currently:

http://$domain.com/images/alogo.gif

Change it to:

../images/alogo.gif

This will grab the logo in reference to the current directory (s-cart) and correct the problem. The "../" at the beginning refers to the /home/$user/$domain-www directory on the server, that is one directory up from the s-cart directory, /home/$user/$domain-www/s-cart.

[ Back to Top ]


Catagories is not listed in the pull-down list on the add products screen. Whats wrong?
When you add a category, you must define whether it contains subcategories or products. The default is products. If you change it to subcategories, then it will not appear in the pull-down list in the add product screen. Unfortunately, it cannot be changed after it has been created, so you will have to delete any that were incorrectly created, then recreate them correctly.

[ Back to Top ]


Will my added fields for a product listing appear when a category is selected?
The first listing of products only shows the pre-defined fields. When you click on the product name it will then show your added fields.

[ Back to Top ]


My Alacart authentication fails for the administration suite. Whats wrong?
If you are using a .htaccess file for authentication of your main web space directory (/home/$user/$domain-www) you may not be able to get into the Admin Suite of Alacart. You will need to remove the .htaccess file or remove the authentication from it in order to get into the Admin Suite

[ Back to Top ]


How do I edit the pre-defined category fields?
Unfortunately at this time you cannot edit the pre-defined category fields. If they do not apply to the product you are selling you must leave them blank.

[ Back to Top ]


Some of my orders fail but still get processed. How do I fix this?
Access the Merchant Account and set all AVS errors to "reject". Some examples of AVS errors that need to be set to reject are as follows:

Address information is not provided for AVS Check (B)
AVS Error (E)
Retry, system is unavailable (R)
AVS is not supported by card issuing bank (S)
Address information for cardholder is unavailable (U)
Reject If Street Address Matches AND
First 5 digits of Zip Match (Y)
First 5 digits of ZIP Do NOT Match (A)

[ Back to Top ]


My Alacart program does not have an "add to basket" button?
Make sure that AlaCart is being called on port 7070. If it is called on the default port (80), sometimes the 'Add to Basket' button will not appear. Here is the format of the URL to call the program:

http://yourdomainname.com:7070/s-cart/index.phtml

To change this, perform the following steps:

1 - Go to: http://yourdomainname.com:7070/s-cart/admin/index.phtml
(you will have to enter your username and password to enter this page)

2 - Change the URL to http://yourdomainname.com:7070/s-cart/admin/setup.phtml

3 - Under "Change Paths", enter your username and password, and after "Your Domain Name", add :7070 to the end of your domain name.

4 - Click "Update Path".

[ Back to Top ]


What is Miva Merchant?
Miva Merchant is a dynamic browser based storefront development and management system that allows merchants to create and administrate multiple online stores from anywhere in the world. Miva Merchant has a complete set of wizards to simplify the process of building your store. The browser based administration interface provides access to an array of more sophisticated tools to maintain your catalog. Upsell merchandising and order fulfillment are @included. And Miva's modular architecture enables you with deep-down customization for your storefront.

[ Back to Top ]


Does Miva Merchant come on all Burningbulb accounts like Alacart does?
No, while Burningbulb does @include the Alacart shopping cart on our deluxe Burningbulb account the Miva Merchant Merchant must be purchased from the Miva Corporation. However, once purchased, Burningbulb will provide tech support on Miva and its integration with our servers.

[ Back to Top ]


Why would I want Miva over the basic Alacart program?
Overall Miva is a much more robust shopping cart program than Alacart. If you are interested in a very customized and professional shopping cart/storefront system Miva Merchant is much better suited for the job. Miva Merchant is highly customizable and can handle every aspect of an e-commerce store including billing and credit card processing.

[ Back to Top ]


What is the difference between Miva and HTMLscript?
Miva is simply version 3.x of HTMLScript. Any version before 3.x was simply called 'HTMLScript', and version 3.x is called Miva. The newest version of the Miva Engine is called 'Miva Empresa'.

How do I call Miva files on the web: http://$domain.com/apps/$script.mv

Where are the Miva Empresa files located: In the directory /home/$user/$domain-www/apps

[ Back to Top ]


What are the first steps to setting up Miva?
After Miva Merchant has been installed, follow these instructions to initialize. Remember to substitute your domain name for $domain.com. Here are the instructions for completing the Miva Merchant setup for $domain.com.

1 - In a browser, run: http://$domain.com/Merchant2/setup.mv
(a) Click 'Next' on first screen.
(b) Accept the License and click 'Next' on the second screen.
(c) Enter the license information, and press 'Next' on third screen.
(d) Enter the following on the fourth screen: [note: the '?' must be @included]

URL to Miva Merchant:
http://$domain.com/Merchant2/merchant.mv? (default)

Secure URL to Miva Merchant:
https://$domain.com/Merchant2/merchant.mv?

Secure URL to Miva Merchant Administration:
https://$domain.com/Merchant2/admin.mv?

Base URL for Graphics:
http://$domain.com/Merchant2/ (default)

Secure Base URL for Graphics:
https://$domain.com/Merchant2/

Root Directory for Modules:
/Merchant2/ (default)

Secure Root Directory for Modules:
/Merchant2/

(e) Create a user name and password to administer the Mall and press 'Next'.

2 - The user should then set up their catalog with the administration module:
http://$domain.com/Merchant2/admin.mv?

(a) Step 1: Add a 'Store'
- Expand 'Stores', then select 'Add Store'.
- Enter a 'Store Code' and 'Store Name'.
- Select a Tax Module, Currency Module, and User Interface.
- Click 'Add'.
- Enter any additional information.

(b) Step 2: Convert the existing Koolcat catalog [if you had one].
- Expand the new store.
- Expand 'Utilities'
- Expand 'Import Data'
- Select 'KoolCat v1.x Data Import'
- Leave the 'path to koolcat.conf' blank, and select 'Import'.
- You will see the import, and a message stating 'Import completed successfully'.

(c) Step 3: Add a Payment Module
- Expand 'Payment Modules' under the new store.
- Select 'Add Payment Module'
- Select a module(s) and select 'Add'.

(d) Step 4: Add a Shipping Module
- Expand 'Shipping Modules' under the new store.
- Select 'Add Shipping Module'
- Select a module and select 'Add'.
- Add a Shipping Method and the price and click 'Update'
- Repeat until all methods are added.

(e) Step 5: Add a Sales Tax Module
- Click on Tax link.
- Change the prompt [to something like 'Sales Tax']
- Enter Tax choices [such as 'CA' and 'Outside CA'] and click 'Update'
- Repeat until all tax choices are entered.
(f) Edit the configuration further as you wish for the Store.

3 - Go to the merchant and begin!
http://$domain.com/Merchant2/merchant.mv?

[ Back to Top ]


How do I add CyberCash to the Miva Merchant?
Merchant 2 users will not need to install CyberCash for their whole domain. Simply follow the below instructions:

First, the CyberCash libraries must be installed and referred to in /etc/miva.conf. Clients can get this information from either CyberCash or Miva. Without these libraries, CyberCash will not work.

Once the CyberCash libraries are installed:

Go to your admin:

http://$domain.com/Merchant/admin.mv

click on stores
click on the arrow next to the name of your store
click on payment modules
click on Add Payment Module
select Cybercash
change http://cr.cybercash.com to https://cr.cybercash.com/cgi-bin/
type in your Merchant ID
select whether you want to do online or offline transactions
click on update

-----------------------

Merchant users:

Cybercash must be installed first!!!!!!!!!!

In a browser, go to:
http://$domain.com/Merchant/admin.mv

click on stores

click on the arrow next to the name of your store

click on payment modules

click on Add Payment Module

select Cybercash

change http://cr.cybercash.com to https://cr.cybercash.com

type in your Merchant ID

select whether you want to do online or offline transactions

click on update

[ Back to Top ]


My CoolCat product codes are not displaying correctly. What could be the problem?
If Koolcat users have a problem with product codes not displaying correctly or negative sums in the shopping cart, it could very well be because they are using a "-" (dash) instead of an "_" (underscore) in the product code. Koolcat sees this as a symbol denoting an operation, i.e. subtraction, and not just a character. If the dashes are replaced with underscores the problem should be solved

[ Back to Top ]


I lost my Miva password. How do I retreive it?
If someone should lose their login and/or password for the administration of Miva Merchant, then they are going to have to reinstall the whole program again.

To do this they would:

1. Rename the Merchant directory to Merchant_old.

2. Ask support to install Miva Merchant as if for the first time.

3. Once the new Merchant directory is installed, you must the run the "setup.mv" again.

4. When the cart is functioning properly, delete the Merchant_old directory to conserve space.

[ Back to Top ]


What should I do if my checkout page in Miva is blank?
If selecting "Checkout" in Miva Merchant brings up a blank page, try the following:

1 - Check the source "View Page Source" in your browser.

2 - Go to the bottom of the source. If there is an error about not finding a module file (usually db.mv), continue with these instructions.

3 - To fix this, do the following:
(a) Go into the Miva Merchant Administration Package.
example:
https://$host.server.com/$domain/Merchant/admin.mv?
(b) Expand "Mall", then "Modules".
(c) Select "Module Paths".
(d) Enter the following under "Secure Root Directory for Modules:"
/$user/Merchant/
[where '$user' is replaced by your own control panel user name]

-------------------------

With Merchant2, the exact opposite is the case:

(d) Enter the following "Secure Root Directory for Modules:"
/Merchant2/

[ Back to Top ]


© 2003 Burningbulb.net