| 1. | Unzip the AShop program files on your local computer.
|
| 2. | Ensure that your FTP client is set to upload php files and images in binary mode. Upload the AShop files and folders to the server. The AShop Deluxe files and folders may be installed in the public root directory or in a subdirectory. A single domain license can be used to install the shopping cart in any number of subdirectories with different names. The AShop directory structure must remain the same as in the distibution packate for each installation. Note that the Unix/Linux file system is case sensitive. For instance, if you name the folder ashop in all lower case, the setting within config.inc.php must also be ashop (not AShop). If the program files are installed in the public root OrderForm pages will work anywhere in the public root and in subdirectories just below the public root directory.
|
|
OR |
|
Note: When AShop is installed in the public root directory, OrderForm code can easily be used in all of the HTML pages in the public root and directories just below the public root directory. However, in this case, other scripts running in the same public root directory, hidden files (.htaccess), and FrontPage configuration may conflict with the AShop scripts. If there is a lot already going on in the public root or you are not sure, it is safer to install AShop in a subdirectory.
| 3. | Change permissions of the following directories and files to 777. Note: The only gateway directories that are required are the ones for the currencies that will actually be used by the shopping cart. Unused gateway directories may be omitted.
|
| · | admin/fulfilment
|
| · | admin/gateways (only necessary if processing U.S. dollar)
|
| · | admin/gatewayscad (only necessary if processing Canada dollar)
|
| · | admin/gatewayseur (only necessary if processing Euro currency)
|
| · | admin/gatewaysgbp (only necessary if processing Great Britain pound)
|
| · | admin/gatewayssek (only necessary if processing Swedish Kroner)
|
| · | admin/gatewayssgd (only necessary if processing Singapore dollar)
|
| · | admin/receipts (if you want to save original customer receipts)
|
| · | admin/config.inc.php
|
| · | banners
|
| · | images
|
| · | images/logo.gif
|
| · | ioncube
|
| · | previews
|
| · | prodimg
|
| · | products
|
| · | updates
|
| 4. | Create a database for AShop and add a user with a password to the database. If you do not have access to create a mySQL database on your server, then contact your web host technical support to have this done for you. You will need the path to the database (if it is not localhost), the database name, user name and password. The user must have all privileges for database table mods and creation of new tables.
|
| 5. | Open config.inc.php in a text editor such as NotePad or within your FTP program and edit the following variables BEFORE running install.php:
|
| $databaseserver = "location of the mySQL database"
|
| The database is usually located at "localhost". If the database is hosted remotely or on a different server, this setting may be something like "mysql.server_name.com" or http://mysql.server_name.com.
|
$databaseuser = "user name that you added to the database that you created"
$databasepasswd = "password for the user name that you added to the database"
| 6. | Run install.php from a browser. This will create the database tables. To do this, enter something like this into your browser address bar: http://www.yourdomain.com/install.php or http://www.yourdomain.com/ashop/install.php depending on where the AShop files and directories are located.
|
| 7. | Enter your name, email address, and Registration Key Code in the spaces provided.
|
| 8. | You will then be redirected to the third party software integration page. You can skip this step by clicking the Skip This Step button at the bottom of the page. If you wish to add third party integration later, it can be done through the admin panel in the Store Configuration > Shop Parameters > Advanced Options menu. To add third party integration during the installation process, enter the full server path for each supported third party software application that AShop Deluxe will integrate to.
|
| · | ListMessenger (Lite and Pro)
|
| · | ListMail Pro
|
| · | phpBB
|
| · | AutoResponse Plus
|
| · | Password Administrator+ (PA+)
|
| · | Password Robot
|
9. Remove the install.php file from the server. Installation of the program files and database is now completed.
The next page will be the Administration Panel login. The default password is "ashopadmin". Login and setup the Store Configuration, then Edit Catalog to add categories and products. For security we recommend that you change the administrative password.
Note: From now on, login to the Administration Panel by opening the /admin/login.php script.
Example: http://www.yourdomain.com/ashop/admin/login.php
Setup Of Shopping Cart Design, Layout and Selling Options
Customize The Shopping Cart
After the initial installation of program files and the database is completed, the shopping cart can be customized and configured in various ways. Shopping cart pages, receipts, email notices, images, buttons, and page text for each language can be modified to suite your needs. Here is a quick list of the most important considerations during initial setup.
Custom Page Templates
If you have not already seen the tour of AShop Deluxe, go back and look at the section about page templates. It describes how page templates are included by the program. HTML templates are simply HTML web pages with a place where the shopping cart content appears. A separate page template is used for the catalog, delivery, checkout and affiliate support pages.
Layout Menu
Login to the admin panel. In the Store Configuration/Layout menu, set the default colors, sizes, fonts, widths, borders, thumbnail image size, and various other parameters, which are used in the dynamically generated areas of the shopping cart pages.
Pre-designed Themes
If you don't need custom page templates and you just want to begin using the cart with a canned look, select a theme in the Layout menu. Themes can be a complete collection of page templates with buttons and pre-configured Layout parameters. Or, themes may only include a set of buttons, or only Layout parameters. Each them has a config file, which specifies how much it does and sets Layout parameters. The parameters in the theme.cfg.php file can be set so that the theme's config settings override the admin panel Layout settings and if the theme includes page templates, they can override the root AShop page templates.
What! No themes to select from? There is a selection of themes and buttons on our site, which may be downloaded for free and used with AShop Deluxe. Select a theme package, download it to your computer and unzip it. Upload the folder containing the theme to the themes directory where AShop is installed. Then, select the theme in the Layout menu.
Language Sets
Each supported language has a unique set of files called a Language Set. When a language is selected the program uses the corresponding language set. Each language set includes a set of images, a set of language text files, and a set of receipt templates. To change the text in shopping cart pages, edit the corresponding language file(s). The program file distribution packages contain only an English language set. More language sets are available for download from our site.
Portable Catalog and Category Tree
The separate category tree and product listing areas of the catalog can be inserted into pages as separate components and included in custom PHP and HTML pages. With this method, the category tree can be placed on the right side of the page or omitted from the page entirely. There is no limit to the number of custom catalog pages that can be made using this method.
Greeting Message & Content When Catalog Is First Opened
A file named first.html may be used to display product specials or messages to customers when the catalog is first accessed. An example of first.html is included with the program file distribution package. The first.html file works exactly opposite of page templates. Instead of the the content outside of the tags being used by the program, the content between the <!--AShopstart --> <!-- AShopend --> tags appears in the product listing area of the catalog when it is first opened. If the first.html file is not present in the AShop root directory, then the catalog will instead open with the top product category appearing.
Separate Shopping Cart Buttons and Checkout Links In HTML Web Pages
AShop Deluxe supports several methods of linking to the shopping cart from HTML web pages and email messages. See the Order-Link and OrderForm help topics. See the Order-Link Tech Tip for specific step by step instructions. Also, some example files are included with distribution packages for new installation.
Payment Processing Options
The shopping cart supports a variety of payment methods and integrates with most popular payment services such as Authorize.net, PayPal, Verisign, Card Services International, WorldPay, and many more. The degree of difficulty to set up each payment option varies widely. Instructions are provided as needed for the payment services that are supported by AShop. If you do not find instructions for your payment service in this help documentation, see if it is listed in the payment processor cross reference chart. There might not be instructions if the payment option requires only the merchant ID to be entered in AShop. If a payment service is not listed in the cross reference chart, it is probably not supported by AShop.
Receipt (orderid) Numbers
When the shopping cart is installed, the first orderid number will begin at 1. New orderid numbers will then auto increment from the highest existing orderid number in the orders database table each time a new order is created. The beginning orderid number can be increased using a database management tool such as phpMyAdmin. Either add a row with the higher orderid number or, if the highest existing orderid number is not needed for anything else (for instance it is an incompleted/unpaid or a test order), change the highest orderid to the higher number. Subsequent new orders will then auto increment higher orderid numbers. See also: Receipt and Order Reference Numbers
Time Zone Offset
Many times the server time is different than your time zone and some servers may be set by Greenwich Mean Time (GMT). To adjust the time stamp for orders and stats, set the timezoneoffset in Store Configuration > Shop Parameters > Advanced Options. The value of the offset is in seconds. To add time enter only the digits. To subtract time, enter a minus sign in front of the digits. Example, Your time zone is 2 hours later than the time zone of the server. To adjust the time so that it matches your zone on receipts and notices, you would enter -7200, which is minus (60 seconds times 60 minutes times 2 hours).
Sales Taxes
If you are selling products that require sales tax calculations, visit Store Configuration > Taxes.
Shipping Calulations
If you are selling products that require shipping calculations, visit Store Configuration > Shipping.
Purchase Agreement Required Before Checkout
A purchase agreement may be included with acceptance required before checkout and payment. Create a file named agreement.txt. Put text or HTML content in the agreement.txt and upload it to the directory where AShop is installed. There is an agreementEXAMPLE.txt file included with the new installation packages. The agreement will then be required for each order before checkout. Note: This is completely separate from individual product license or terms of sale agreements.
Affiliate Program
If you are using the affiliate program, set up the default commission values before adding products. Otherwise, skip this step.
Fulfilment Notices & Automated Processes
eMail notices can be sent automatically based on which products are ordered. An automation fulfilment option can be used to activate third-party programs. SwiftCD automatic CD fulfilment service is also supported. To send fulfilment notices or activate fulfilment automation, set up the fulfilment options first and then assign each product to a fulfilment option.
Visit Counter
There is an automatic visit counter in catalogue.php and search.php, which counts unique visitors. The current number of visitors, visitors today, and grand total (since last reset) displays in the admin panel index page.
See instructions to include the visit counter in other pages on the web site.
Technical Support
If you run into trouble, contact us. Technical support is free for trial installations. Technical support and software updates are provided free for one year after a permanent registration key is purchased. After the first year, technical support and software updates may be subscribed to for $60 annually. Technical support, software updates, and installation service for our software is always provided free by request for domains hosted with AShop Web Hosting Service and for AShopCart