AShop V User Guide AShop Software © Copyright 2002 - 2010
AShop V User Guide Table of Contents 0 8 Part I About AShop 1 About ................................................................................................................................... AShop 8 2 Overview ................................................................................................................................... Of AShop 8 3 AShop...................................................................................................................................
Contents 3 Wholesale Catalog .......................................................................................................................................................... 67 AShop Software .......................................................................................................................................................... Affiliates 69 Digital Product............................................................................................................................
AShop V User Guide Payment Gateway .......................................................................................................................................................... Modules 138 25 Sales ................................................................................................................................... Office Configuration 141 Sales Office .............................................................................................................................
Contents 5 Payment Page ......................................................................................................................................................... Cannot Be Found 177 PayPal Duplicate ......................................................................................................................................................... Transaction Message 177 PayPal - Suspected ..................................................................................................
AShop V User Guide 31 Details ................................................................................................................................... Page Generator 226 32 Penny ................................................................................................................................... Auctions 227 33 Up Selling ................................................................................................................................... 228 34 E-cards .......
Contents 9 Bills................................................................................................................................... and Recurring Billing Part VII Shopping Mall 7 295 300 1 Shopping ................................................................................................................................... Mall Introduction 300 2 Shopping ...............................................................................................................................
AShop V User Guide 1 About AShop 1.1 About AShop AShop - PHP Shopping Cart and Order Management version 5 Developed by Andreas Rimheden and Rob Harris Copyright © 2002-2010 – All Rights Reserved Worldwide AShop Software Use of AShop software is subject to a software license agreement. Included in this documentation are instructions for installation, setup, and usage of the AShop shopping cart with Sales Office order management section. 1.
About AShop 9 The Sales Office works as a separate section of AShop with its' own login. Click here for a tour of Sales Office. How to use the Sales Office AShop is a Shopping Mall The Shopping Mall features of AShop lets other businesses and individuals sell their products through your online shopping cart. It includes a system for members to join, manage their products and earn commissions through a central order processing, payment processing, and digital product delivery system.
AShop V User Guide you are satisfied that the program will serve your needs, then purchase and register a permanent license key to continue using the program. Limited Warranty AShop Software warrants that the software will perform without defect, within the functionality that is in the program at the time of purchase. This warranty is for one year from the date of purchase.
About AShop 11 the left, it is probably because you have an old browser or JavaScript is disabled. Download a current web browser to fix this. To print help topics without printing the table of contents (Internet Explorer), right click in the right side panel where the topic is located. A shortcut menu will open. Click "Print". This will send only the right side (topic) panel to the printer. Step 2.
AShop V User Guide Permanent registration keys are available through our online store. Installation of Software & Database Install AShop 1. Unzip the AShop program files on your local computer. 2. Ensure that your FTP client is set to images in binary mode. Upload the AShop files and folders to the server. The AShop V files and folders may be installed in the public root directory or in a subdirectory.
Installation & Setup 13 Note: .htaccess files are included in the products and updates directories to protect product files. These files may not appear within your FTP explorer on the server side after you have uploaded them, because a file with a name that begins with a punctuation mark is treated as a hidden file in Unix/Linux, but can usually be seen within your hosting services online file manager. 4. Create a database for AShop and add a user with a password to the database.
AShop V User Guide 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. A sample set of product categories and products are installed for you but these can also be modified or removed.
Installation & Setup 15 adapted to the theme. 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. 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.
AShop V User Guide 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.
Installation & Setup 2.3 17 Page Templates How AShop HTML Page Templates Work If you have not already seen the tour of AShop, go back and look at the section about page templates. It describes how page templates are included by the program. The AShop page templates are simply HTML pages with the AShop start and stop tags inserted where the AShop content is to appear.
AShop V User Guide mentioned line: Note: If a template is not present, AShop will generate a catalog page anyway and the default logo.gif image, which can be uploaded through the Layout menu, will appear at the top of the page above the dynamically generated content. When a page template is present, it's body tags, such as background, text, and link colors may override the default page settings made in Layout.
Installation & Setup 19 (catalogue.php) you will also need to modify this template: catalogue.html – used by the simplified product catalog and search pages IMPORTANT! Many payment gateways will host your payment confirmation page through their SSL connection. When they do this, they take a snap shot of your page and nest it within their page at their URL. If this is the case, the hyperlinks within the thankyou.html template must use absolute URL's for links to work and for images to appear.
AShop V User Guide language module you need to replace it with this type of code: Where the "HOME" part should be the name of the language constant you want to use, in this case it will show the word "Home" in the language selected by the visitor. Open the storefront.inc.php language module in a text editor to see which constants are available and to add your own constants if needed. Newsletter Module If you are using the Autoresponder-Service.
Installation & Setup 21 ?> The name of each category is a link that should lead to a page that shows the products that belong to the category, the $catalog parameter determines which page the links lead to. To create a custom list of categories you can use the layout parameter to get the full category tree as an unordered list:
AShop V User Guide each language in its lang.cfg.php file will be used instead, which can be used to redirect the customer to a different page for each language. The TopForm Module If you use the catalogue.php script as your storefront instead of the more advanced modular index.php script, it will include a form at the top of the page with the search box, the subtotal of the cart contents and the View Cart and Checkout buttons. These can be placed individually instead, using the topform. inc.
Installation & Setup 23 This will show only the customer profile links: Displaying the product list or search results The catalogue.php script shows the list of products for a selected category while the search.php script shows the results of a search. They can either be used standalone or as part of a modular storefront script.
AShop V User Guide gif\"> get_permalink()."\" target=\"_blank\">".$item>get_title()."
"; } ?> To change the news feed just set the $feedurl parameter to the URL of any RSS news feed you want. It can even be used with AShop's own RSS feed generator to show new items from another shop, if you run more than one. 2.5 Style Sheets - CSS The settings in the Layout menu are used to set styles in catalog pages through the includes/ashopcss. inc.
Installation & Setup 25 English language receipt templates are included in the AShop installation package. Receipt templates for other languages are downloadable from our web site. The receipt templates can be edited to suit your needs. Customer and order information is included in the receipts by using %tokens%. See below for more about editing receipt templates. Save & View Original Receipts To save original receipts, change the permissions of the admin/receipts directory to 777.
AShop V User Guide · Customer History - Navigate to a customer record through Customers and Messaging and click on the history link . Click on the Order ID number link and then select to view or download the receipt. Resending Receipts and Re-activing Orders A copy of the original receipt can be resent from Sales Reports in edit mode. If the order included downloadable products, the download may be reactivated at the same time.
Installation & Setup 27 Example: English language receipts are named receipt-en.html and receipt-en.txt. Modify the text in receipt templates as needed, but do not change or remove the divider comment tags and token names. Here is a list of tokens and how they are used in receipt templates.
2.9 AShop V User Guide %unlockkeys% Any Software Registration Keys (if applicable) %subscriptionlinks% %password% Display instructions on how to access the subscribed directory Handling payment option. Display notice that the payment was made using the Manual End Special Instructions portion of the receipt.
Installation & Setup 29 Browse the database table named orders. 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 and save the change (click Go). Subsequent new orders will then auto increment to higher orderid numbers.
2.10 AShop V User Guide Message Templates AShop sends out email messages under some circumstances and most of them can be customized by editing the corresponding message template. All message templates can be found in the templates directory, where you also find the receipt templates and page templates. These are the ones that are currently available: · affiliatesignupmessage.html - this template defines the message that is sent to affiliates when they sign up. · membersignupmessage.
Installation & Setup 31 Custom Catalog Page Layout The category tree and product listing areas can be placed separately within each web page. The product listing area can be included separately... ...and the category tree can be included separately. PHP tags are used to include the product listing and/or category tree as separate components within local web pages. The includes will work in files ending with .php extension.
AShop V User Guide Category Tree below. Search Box Options · $search = "off"; The search box does not appear in the page. Example: · $search = "find.html"; The search box is activated and it appears above the product listings. Use this same include method to create a second page where the search results will appear.
Installation & Setup 33 catalogue.php or it must have the catalogue.php include in the page so that the product listings (for the selected category) will appear in the body of the page. To include the category tree in a subdirectory below the directory where AShop is installed, add a chdir (""); parameter. Example 1: Category include is in a page one directory below the AShop root.
AShop V User Guide There are two ways to include the lists, either through Javascript or a PHP include. This is how to use the Javascript version... And this is how to use the PHP include version... include "includes/toplist.inc.php"; Note that the second version only works in a PHP script. Parameters may be added to both versions of the script to customize the output.
Installation & Setup · · · · 35 layout = 0 : show top sellers and latest additions below top sellers (the default mode) layout = 1 : show only top sellers layout = 2 : show only latest additions layout = 3 : show latest additions as boxes, this mode is currently only supported by the Javascript version This example will show only the latest additions, using the PHP include, and will limit the list to 4 items: $layout = 2; $items = 4; include "includes/toplist.inc.
2.14 AShop V User Guide Language Selection Language Selection For The Retail Catalog and Customer Messages The language that is displayed in the retail catalog and in receipts to retail customers can be selected and set as a preference for each customer. If no language is selected, the preference defaults to English. The preferred language is set in a cookie by navigating to the language.php script and then clicking on a language icon/link or by navigating to the language.
Installation & Setup 37 http://www.ashopsoftware.com/dlcounter/downloads.php Language selection can only be done for language sets that have been installed in AShop. 2.15 Language Specific Files and Folders There are three areas that have language specific files. Each language is identified by a 2 character abbreviation, which is used for language subdirectory name, for image file names, and in receipt.html file names. For instance; en for English, sv for Swedish, etc. 1.
AShop V User Guide 3. There is a set of receipt templates for each language. The receipt templates are located in the templates directory. There is a plain text receipt template and an HTML receipt template for each language. Plain text or HTML receipt is selected through the admin panel > Configuration > Shop Parameters menu. Tokens are used to show customer and order information in the receipt. Start and stop comments are used to separate each section. clip of receipt-en.
Installation & Setup 39 above is an English language file below is the same language file translated in Japanese 2. Edit the lang.cfg.php file. Change the language name. Set the $langredirect if using language specific catalog pages. Leave the $langredirect empty for the catalogue.php script to open when a language is selected. 3. Create a set of button images with text in that language. Name the images with the 2 character suffix just as the -en and -sv images are already named.
AShop V User Guide receipts), translate the text, rename and save it with the corresponding 2 character language suffix. See also: Language Selectable Catalog Pages 2.17 Language Selectable Catalog Pages Language Specific Catalog Pages The product listing area and the category tree can be inserted into php pages as separate includes. There is no limit to the number of unique pages that can be created in this way, which makes it possible to use this to create one storefront page per language.
Installation & Setup 41 "action=checkout" in the link. The Order-Link (buy link/button) html code that is copied directly from the AShop admin panel runs the shipping.php script. With shipping.php, when shippable or taxable products are added to the cart the shipping information form appears (before the View Cart page) so that shipping and taxes will be included in the View Cart page from the beginning of the shopping session. basket.php - The basket.
AShop V User Guide A drop-down selection box can be substituted for to offer only fixed quantities. Add to Cart Order-Link Hyperlink With Text Or Image A hyperlink may be used instead of the form. PAGE 43
Installation & Setup 43 View Cart Check Out Text Link Check Out View Cart Image Link Check Out Image Link View Cart Form Button
Installation & Setup 45 For example, this link would buy one small white shirt. http://www.yourdomain.com/ashop/shipping.php?product=151&quantity=1&attribute=68:718| 65:708 To change the link so that more than one product can be added to the cart, include the "add=1" attribute. http://www.yourdomain.com/ashop/shipping.php?product=151&quantity=1&add=1 &attribute=68:718|65:708 To create a form with drop-down selectors, copy the Order-Link form code from the link code generator for the main product.
AShop V User Guide
Installation & Setup 47 multiproductEXAMPLE.html).
Installation & Setup 49 AddType application/x-httpd-php .php .phtml .php4 .php3 .html .htm 2.22 Move or Copy AShop An existing shopping cart may be moved or copied from one location to another. Before installing AShop in a new location, run the ashoptest.php script, which tests for required functionality and installs the correct IonCube loader for the operating system and version of PHP that is running on the server. 1. 2. 3. 5. 6. 7.
AShop V User Guide Security Features The AShop admin login is password protected. The default password that is installed with the program is ashopadmin. This should be changed after installation. If you forget your password, it can be looked up with your server's database browsing tools such as phpMyAdmin or through Shell access. 20 Minute Inactivity Security Check - The admin panel login times out after 20 minutes of inactivity. By adding the line: $noinactivitycheck = "false"; anywhere in the config.
Installation & Setup Shopping Cart Catalog Mode Selection Save Cart enable/disable Add to Cart Confirmation Window enable/disable Link From Thank You Page Items Per Page AShop Affiliate ID Receipt Mail Format html/text TeleSign Customer ID Wholesale Catalog enable/disable Wholesale Catalog Volume Discount Settings Download Password Duration Number of Downloads Allowed Per Password Random Key Code Delivery Selection Edit Product Flags Advanced Options Layout Upload Logo Image File (default page heading) Th
AShop V User Guide Extra Form Fields (only available for payment gateways that use the AShop Secure orderform script) Deliver Before Payment enable/disable Test Mode enable/disable Automatic Delivery enable/disable Payment Gateway Description Text On Order Page Thank You Message Fulfilment Add New Fulfilment Options Three Options, add as many as you like of each Email Order Notices To Fulfilment Services SwiftCD.
Installation & Setup AShop Software © Copyright 2002 - 2010 53
AShop V User Guide Change Password The default username and password for the admin panel is: ashopadmin. After installing AShop, the administrator's password should be changed. Enter the old password, then enter the new password twice. Note: If you forget and lose your password, you can have it sent to you by email by clicking the "Did you forget your password?" link on the login screen. Just leave the username field blank to get the main shop administrator password.
Installation & Setup 55 that is set here also controls which payment options are available. Only payment options that support the selected currency will be available within Payment Options. Catalog Mode The Catalog mode is typically set to Shopping Cart, which enables selection of more than one product per order and any quantity of each product. Use Single Product Order to go straight to checkout when a product is put in the cart, allowing only allow one product per order.
AShop V User Guide complete contact information - The checkout orderform will require name, email address, physical address, and phone number. Up sell If there are products that are related to the ones a customer currently have in his/her cart they will be shown on a special up sell page when the customer checks out. Use this to offer special deals or remind your customers about other items that may be of interest to them. This option lets you select how many such up sells to show: 0-2 products.
Installation & Setup 57 Telesign Customer ID Telesign automated telephone call verification service is optional. Leave the box blank to disable the service. Enter a valid Telesign account number to activate the service. Note that it only works for payment options that use a locally hosted payment form (orderform). Non-fixed Voip (Voice Over Internet Protocol) and untraceable cell phone numbers are often used by criminals to get around phone verification.
AShop V User Guide A password is e-mailed to customers upon receipt of payment. This password is required to access the downloadable products. The password will expire after the number of days that is set in the Allow Download For box. Setting the allowed download days to 0 disables that restriction. Allow (quantity) Downloads Per Product Each password will work to download a product file this many times within the number of days that Allow Download For is set to.
Installation & Setup 59 Member Catalogs Member products may be displayed in dynamically generated catalog pages in one of two ways: · Unchecked - all members products are displayed within one dynamically generated catalog. · Checked - each member has an individual dynamically generated product catalog where only his/her products appear. Member Product Management When set to Simple Mode or Advanced Mode, each member may add and edit his/her products.
AShop V User Guide the Edit Catalog menu. These comments will display above the Price in the Product Catalog. Advanced Options Only change these settings if you understand what you are doing! At the bottom of the Shop Parameters page click the Advanced Options link to set the Shop URL, Secure URL, File System Path, Secure File System Path, time-zone offset, and path or URL to other third party software. 2.23.
Installation & Setup 61 2.23.5 Shopping Cart Catalog Mode Catalog pages are dynamically generated by catalogue.php or index.php for customers to make selections, and purchase products. The behavior of the shopping cart when products are added to the cart will be determined by the Catalog Mode setting. Shopping Cart Catalog Modes The Shopping Cart Catalog can be used in 3 different ways.
AShop V User Guide An "Add to Cart" button will appear next to each product within the catalog. At the top of the catalog will be the "View Cart" and "Check Out" Buttons, along with a Search and Subtotal feature. The Shopping Cart contents can be viewed at any time by clicking on the "View Cart" button. The customer will be directed to the Basket to proceed with the order. If products have been added to the cart that require shipping or tax, a link to calculate will appear in the Basket.
Installation & Setup 63 In this mode, the "View Cart" and "Check Out" buttons do not display within the store catalog page. Neither do the Subtotal or Search features. Customers may select one product from the catalog by clicking on a "Buy" button and will be directed to Check Out and proceed with the order. They will not see the Basket page. If the product has a shipping charge or is taxable they will first be directed to the shipping information form.
AShop V User Guide * the shopping cart basket Clicking on the Calculate link will open the shipping information form. *shipping and taxes information form After the shipping information has been entered, the shopping cart contents will appear with shipping and taxes added.
Installation & Setup 65 If more than one payment option is set, the "Checkout" button will show a list of payment options to select from. If only one payment option is set, the payment options are skipped and the secure payment gateway form appears. * payment gateway selection They are then directed to a secure payment form for the select payment option where billing information is collected and processed.
AShop V User Guide * secure payment gateway · The transaction details, customer's name and shipping information are recorded in the database. · Upon submission of the payment form, a receipt is e-mailed to the customer. Notice of the transaction with customer's IP address is e-mailed to the store administrator. · If a downloadable product was purchased, an automatically generated password and a link to the download page are e-mailed to the customer.
Installation & Setup 67 A confirmation notice is sent to the customer by email. Once the customer is registered they can save the contents of the shopping cart. Enter the name of the saved cart contents and click the Save Cart button. Any number of carts can be saved and recalled at a later time. When the customer comes back at a later time they can login at the View Cart page. They will find they can load or delete the shopping cart contents they have saved. 2.23.
AShop V User Guide Wholesale customers must sign up for an account. (wholesale/signupform.php) Upon submitting the application, the customer receives an email notice that the application has been received and the shop administrator receives a notice that the customer has submitted an application. The shop administrator can then login to the administration panel to view the customers information. Upon approving the customer for a wholesale account, the shop administrator can then activate the account.
Installation & Setup 69 customer will receive an email notice with their wholesale account login information. Products are set as active in the catalog by checking a box in add products or edit products. When the wholesale catalog is active, a check box will appear to make each product active and there will be a place to set the wholesale price.
AShop V User Guide commission rate is currently 3% of the order totals. Link code is automatically generated in the affiliate support panel. When new affiliates sign up through your link, you will begin earning second tier commissions each time they sell an AShop product! A Product And Customer Service To Be Proud Of AShop affiliate sales software is easy to use and packed full of useful features. It is backed by great customer service and full technical support.
Installation & Setup 71 Automatic Delivery is optional with payment gateways that support the feature. When Automatic Deliver is used, customers still receive the password and link by email AND upon completion of payment, they will be automatically logged into the product delivery page. The password can be set to expire in a number of days and/or after a number of downloads. This is set in Shop Parameters. 2.23.10 Layout From the AShop Administration main menu, click Configuration on the left side menu.
AShop V User Guide AShop Software © Copyright 2002 - 2010
Installation & Setup 73 Upload Logo Image This logo image file will be displayed on any page that does not have an HTML page template attached to it. The main pages will use a page template if present. If a page template is not present, the logo will appear at the top of the page. Some message pages do not use templates and will always display the logo image at top of the page. The language selection page also displays the logo image. Theme Selection A theme is a canned set of design components.
AShop V User Guide Notes about Layout settings Layout settings can be overridden by the presence of settings in AShop HTML page templates and style sheets. Some pages do not use page templates. For instance add to cart confirmation windows and attribute selection windows do not use a page template and will always use these settings.
Installation & Setup 75 Forms Colors Forms background color This field sets the background color in forms used to collect shipping and billing information. Forms text color This field sets the text color used in forms that collect shipping and billing information. Forms border color This field sets the color of the border around forms. Product Layout & Colors Item border color The products are displayed in the catalog within tables (boxes). The border color of these tables is set here.
AShop V User Guide condensed layout Show product file info If you sell downloadable products their size and filetypes will be shown next to the name of the products, unless you deactivate this option. Product sort order Lets you select if new items should appear at the top of the product list or at the bottom, by default. You can always reorder them using the "Up" and "Move to top" buttons, but this option can save you some time if you want them to be ordered in a certain way.
Installation & Setup 77 are called "tablesize1" (default is 700 pixels) and "tablesize2" (default is 500 pixels). Top form layout If you use the simplified catalogue.php storefront instead of the modular index.php storefront you will see a box at the top of the product list with a search field, a subtotal field and the buttons View Cart and Checkout. This option lets you determine if the box should use two rows or one.
AShop V User Guide Detailed cart list on checkout This will render a tale similar to the one on the View Cart page, at the top of the Checkout page, instead of just displaying a text list of the cart contents. 2.23.11 Payment Options From the AShop Administration main menu, click Configuration on the left side menu. This will open the Configure AShop menu. Then select "Payment Options".
Installation & Setup 79 Option Name The payment Option Name appears in the payment selection page if there is more than one payment option. If there is only one payment option created for the shop, then checkout skips the payment selection page and this Option Name is not seen. Payment Gateway This will already be set when the payment method is added. Payment Fee A payment fee may be added for each payment option. The amount set here is rounded to 2 decimal places.
AShop V User Guide merchant account. For PayPal, it must be a verified business account primary e-mail address. Transaction Key (AuthorizeNet SIM only) See AuthorizeNet Payment Integration SSL URL to Logo Image The payment form can optionally include an image of your choice. This most commonly used for the store logo. Since the payment form is accessed through a secure socket layer (SSL) connection, the image URL must also be an SSL connection in order to avoid annoying warning messages.
Installation & Setup 81 Text on order page (Manual method only) When a manual payment option is selected during checkout, customers are directed to the order form page to enter their name and contact information. This text will appear on the order form page above the form fields. Thank you message Upon receipt of the order, customers are redirected to the confirmation page. You can include your own personalized thank you message and ordering instructions to appear on this page.
AShop V User Guide Fulfilment products are grouped for each order. Multiple products in the same order are automatically grouped for each fulfilment option. For instance, if five products are ordered, with two using fulfilment option A and three using fulfilment option B, only two fulfilment notices will be sent; one with two products for A, and one fulfilment with three products for B.
Installation & Setup 83 3. Assign products to fulfilment option. Select the fulfilment option that the product will activate when it is ordered and then click the Submit button. When a product with an email fulfilment option is ordered, notice is sent with customer information, products ordered and the additional message text.
AShop V User Guide Kunaki CD Service Kunaki (www.kunaki.com) is an on demand CD duplication and fulfilment service. The Kunaki fulfilment option sends an XML message to Kunaki to order a CD which is copied by them and sent to your customer.
Installation & Setup 85 AShop will by default tell the Kunaki CD duplication system to ship the CD by USPS Priority Mail for orders within the USA and Air Mail for international orders. If you need to customize the shipping of your Kunaki CDs you can edit the file admin/fulfilment/kunaki.ff with a text editor and change the $internationalshipping and $usshipping options to the shipping options you want to use.
AShop V User Guide Affiliate Signup The affiliate signup fulfilment module makes it possible to automatically sign up customers as affiliates. This way you can turn customers into affiliates that promote your products, you can also sell access to your affiliate program or upgrade affiliates to a higher commission level if they pay for this. Set the option "Run once" to "Per order" to sign up every customer as an affiliate when they place their first order through your shopping cart.
Installation & Setup 87 · Variable Names - Since each website script can use different names for variables and form fields that they can accept you can map the fieldnames of the fields that AShop sends to match the ones your external software uses. Each field is listed with a box where you can fill in the name your software uses. For example the AShop order ID field can be called: "invoicenumber" if your software needs that name.
AShop V User Guide 4. Assign each product to the automation fulfilment option through the Edit Catalog menu. 5. If your product has any attributes you can send them to the external software. Each one of your products' attributes are listed with a text box that will let you map its' name to the name that is used by the receiving software.
Installation & Setup 89 5. Add a new Automation fulfilment option and set its' URL to where the buyupload.php script is located on your site. 6. Ensure that the Fieldname - order ID is set to: "orderid". 7. Enter the text: "pass=mypassword" (changing the "mypassword" part to what you set the $password variable to in the buyupload.php script) in the text box labeled: "Other fields + values" and click Update to save the settings. 8.
AShop V User Guide
Make sure that the action parameter of the form tag contains the right URL to your buyupload.php script if you have placed it in another directory than the default on your site. 10.Installation & Setup 91 If there is at least one taxable or shippable product in the basket, The View Cart page will include an additional row for Shipping/Sales Tax with a link to the shipping information form. If there are taxable products, but no shippable products in the basket, the shipping information page asks only for the country and state in order to determine if sales tax is required and to apply the correct rate for the locality.
AShop V User Guide The street address and shipping contact phone number is not required until Checkout. The shipping information is saved for each customer. The shipping contact phone number is saved in the Customer Profile. If a different billing phone number is entered during the payment process, then it will also be saved (as an alternate phone number for the customer). Related Topics Each product is set as taxable in the Add Product or Edit Product page.
Installation & Setup 93 Shipping Method In the Shipping page, there is a main Shipping Method selector. The Storewide shipping and individual product shipping options are dependent on the Shipping Method setting. For example, if the main Shipping Method is set to FedEx, only FedEx options will be available in related settings and options. If UPS is selected, then only UPS settings and options will be available. If Custom shipping options are selected, only custom settings and options will be available.
AShop V User Guide ...and UPS is available, but FedEx is not available in the per product shipping options. When Custom is selected as the Shipping Method... ...only Custom Shipping Options are available through the Configuration > Shipping page... ...FedEx and UPS options are NOT available for each product Shipping options.
Installation & Setup 95 Customer Selectable Service When the shipping amount is requested during a shopping session, the state, zip, and country is required. (The street address and shipping contact phone number is not required until Checkout.) When FedEx or UPS is selected as the Shipping Method, the Options include Yes/No selector for Customer Selectable Service. When this is set to Yes, customers will have selectable service options.
AShop V User Guide Note that when the main Shipping Method is set to FedEx or UPS AND Customer Selectable Service is set to Yes, custom shipping options are NOT available in the per product shipping options. Storewide Shipping Each product may have an individual shipping calculation method OR it may be included in the Storewide Shipping calculation. The storewide can be FedEx, UPS, or a flat rate per pound.
Installation & Setup 97 To add a country to the list, click the Add Country button. A new selection box will appear where another country can be selected and added to the list. To remove a country from the list, select Remove This Country from the drop-down list. When the form is submitted, that selection box will be removed.
AShop V User Guide 2.23.17 Taxes Sales tax options are set in the Taxes menu in your AShop Administration Panel. Administration Panel > Configuration > Taxes Sales Tax Options Sales Tax Type - Select which country or regional tax will be applied to orders. For instance; US sales tax, VAT (European Union), or GST/PST/HST (Canada).
Installation & Setup 99 For Canada sales taxes the province that is set here is used to determine HST, GST, or PST. EU VAT Origin Country - When Request VAT Number From Customer (see below) is checked, a VAT Registration Number text box appears within the shipping form. EU businesses can enter their VAT Number to be exempted from the tax. The country that is set in EU VAT Origin Country is excluded from the VAT exemption and will be charged VAT even if a registration number is entered by the customer.
AShop V User Guide All local tax rates that you save will be added to a list and can be updated by changing the tax rate and clicking the Update button. When a customer from the area defined in this table buys from you the additional rate will be added to the sales tax. For example, if you are located in Florida and a customer from the Monroe area of Florida buys an item the sales tax will be the 6% you have defined on the Taxes configuration page plus the 1.5% local tax rate, a total of 7.5%. 2.23.
Installation & Setup 101 Shipping options are set within Configuration > Shipping & Taxes. To create a new shipping option or modify an existing one, click on the Shipping Options link in the bottom menu bar. Create A New Shipping Option 1. Enter the Description that customer's will see. 2. Enter the Fee that will be added to the order when this shipping option is selected. 3.
AShop V User Guide Move An Existing Shipping Option Up A List Of Shipping Options 1. Click Move Up. 2. Repeat as Necessary. 2.23.20 Shipping Discounts Shipping discounts are created and modified in Configuration > Shipping and Taxes, in the bottom menu bar. Shipping discounts are based upon the quantity of shippable products in the shopping cart basket.
Installation & Setup packages as needed when the maximum weight for each package is exceeded. First set up Storewide Shipping through Configuration > Shipping and Taxes. or or Then set Shipping for each product that is to use Storewide Shipping. Weight for each product can be entered in decimal lbs or in pounds and ounces. Decimals are converted to pounds and ounces.
AShop V User Guide 2.23.22 UPS Options The UPS online rate lookup provides different rates based on various shipping parameters. These options are used for all UPS shipping calculations. The options may change depending on current selections. 2.23.23 FedEx Options The FedEx online rate lookup provides different rates based on various shipping parameters. These options are used for all UPS shipping calculations. The options may change depending on current selections. 2.
Installation & Setup 105 For each supported currency there is a set of payment gateway modules, which contain settings for each gateway. The gateway modules are pre-configured and under most circumstances do not require modification. More about payment gateway modules. Curl with SSL The Authorize.net SIM method and other payment connection methods where the payment page is hosted on the payment gateway server typically do NOT require Curl or SSL.
AShop V User Guide This feature only works for payment options that use an SSL connection to your local orderform.php script to collect credit card information. It does not work for PayPal, Authorize.net SIM or any of the other payment options where the payment form is hosted on the payment processor's server. Payment options that support extra fields are listed with an X under "Orderform" in the payment gateway cross reference chart.
Installation & Setup 107 The data can be included in receipts by inserting the %customer_info% token into the receipt template. 2.24.3 Manual Order Activation Any of the payment options in AShop may be set up to delay delivery of products, even after real time payment has been completed by the customer.
AShop V User Guide 2.24.4 Traffic Exchange Credits A manual traffic exchange is a service where members view each others advertisements. In return for viewing or "surfing" advertisements you get credits which can be used to show your own advertisements on the exchange. The more views the more credits and the more credits the more members will be shown your ads.
Installation & Setup 109 AlertPay, you will need to go through AlertPay's website review process: 1. Login to your AlertPay account and click My Account->Profile->Websites. 2. Click "Add Website" and enter your website details on the next page. 3. Click "Send" to have AlertPay check the site and allow credit card payments from it, if it is accepted. IPN Setup AShop uses AlertPay's Instant Payment Notification (IPN) system to process orders when they are paid.
AShop V User Guide 3. 4. Transaction Key. Create a Transaction Key. Your security secret answer, which was created when you opened the Authorize.Net gateway account, will be required. You may obtain a new Transaction Key as often as you wish by providing your Secret Answer. You may choose to disable the old one immediately by checking the Disable Old Transaction Key(s) option. If you do not immediately disable the old value, it will automatically expire in 24 hours.
Installation & Setup 111 net. Settings > Transaction Submission > Payment Form > Form Fields - The payment form fields can be set to view, edit, or required. The shipping information fields are usually not necessary to view or require in the payment form as shipping information is already collected within AShop V for products that require shipping or tax calculations. See also: AuthorizeNet Payment Form Settings Transaction Submission > Password-Required Mode - This should be checked.
AShop V User Guide There are also some additional fields that are optional and usually not needed. 2.24.9 Authorize.Net AIM AuthorizeNet AIM payment integration is set in the AShop Administration Panel through Configuration > Payment. Important: In addition to adding the AuthorizeNet AIM payment option within the AShop Administration Panel, the receipt and response URLs must be set within your Authorize.Net Merchant Account Settings. See instructions below.
Installation & Setup 1. 2. 3. 113 Click the Payment Gateway text box and select Authorize Net AIM. Click Add. Set the following as needed within the AuthorizeNet payment option form. Merchant ID (required) The Merchant ID is assigned by AuthorizeNet. It is viewable through the Authorize.net merchant panel under Settings > Security > API Login ID & Transaction Key and is labeled "API Login ID". Transaction Key (Required) The Transaction Key is required in order to connect to the AuthorizeNet AIM method.
AShop V User Guide will not verify addresses while the payment form is in test mode. To run test transactions for AuthorizeNet, enter the following credit card number and any future date: 4111111111111111 (4 and fifteen ones). The personal information and address can be anything since it will not be verified, but in order to test the e-mail receipt function, you must enter a valid e-mail address.
Installation & Setup 115 To use the recurring billing features of CCBill you will need to set the recurring price of your products. This is the price that the customer will be charged monthly, starting 30 days after the initial payment, while the price you set in the "Price" box is the initial payment. You can set this option by opening the page Edit Catalog, locating the product and clicking Edit, or by adding a new product using the New Product button at the top of the page.
AShop V User Guide Note: The secure URL for AShop is set in Shop Parameters > Advanced Options. The security secret in AShop must be the PIN number for the Echo account. 2.24.14 eWay (Australia) The eWay payment gateway service does not require any setup, just an active account. Simply enter the eWay account number in the Merchant ID setting for the AShop payment gateway option. To test the eWay payment gateway without having an account, set the Merchant ID with the test account number 87654321.
Installation & Setup 117 5. If you wish to do so; you can edit the Option Name, add a Payment Fee, add a Payment Description, and even edit the Thank You Message that appears upon successful completion of a transaction. 6. Don't forget to click the "Update" button to save the changes you made. 2.24.17 IC Pay IC Pay is one of the few payment services that will process payments for sales of adult content. IC Pay provides a secure connection to a payment page, which is hosted on their server.
AShop V User Guide 2.24.18 LinkPoint Basic - Card Services International LinkPoint Basic payment integration is set in the AShop Administration Panel through Configuration > Payment. AShop Settings Under "Add a new payment option..." 1. Select LinkPoint Basic from the drop-down selection box and click Add. 2. 3. 4. Set the Store ID in the Merchant ID text box. Note: Be sure you enter your LinkPoint Store Number, not your merchant number.
Installation & Setup 3. 4. · · · 5. 6. 7. · · 8. 119 Click "Settings" Enter the following settings: For Order submission form URL enter: http://thecustomersashopurl/checkout.php For Thank you page URL enter: http://thecustomersashopurl/order.php. Check both checkboxes below this setting. For Sorry page URL enter: http://thecustomersashopurl/order.php. Check both checkboxes below this setting. Click the Submit buttons at the the bottom of the page to save these settings.
AShop V User Guide LinkPoint Basic Merchant Panel Settings - Required Before the LinkPoint Basic payment integration will work with AShop V, some URLs must be set within the LinkPoint Central merchant panel. 1. 2. 3. 4. · · · 5. 6. 7. · · 8. Login at LinkPoint Central Click "Customization" Click "Settings" Enter the following settings: For Order submission form URL enter: http://thecustomersashopurl/checkout.php For Thank you page URL enter: http://thecustomersashopurl/order.php.
Installation & Setup 121 Linkpoint does allow multiple referrer URLs. They call it an 'Order Submission Form URL'. According to their tech you just put a space after the first URL Address, then add the second, but the settings are limited to 127 characters total. 2.24.20 Manual Payment By Check or Money Order Manual payment options are for processing orders where payment will be made by check, money order, or some other form or third party or delayed payment.
AShop V User Guide Create A Manual Payment Option Create a manual payment option through the Configuration > Payment menu. Check the Deliver Before Payment box only if you wish to provide immediate access to digital products and subscriptions before the payment is processed and activated. Activating Manual Payment Orders Immediately To activate orders immediately upon submission of the manual payment form, edit the manual.gw module in the admin/gateway directory for US currency.
Installation & Setup 123 Security Secret: yesguy Test Method The following credit card number works for testing. 4111111111111111 (that's 4 and 15 ones) Use this credit card number and any future expiration date. Their test server uses the penny value of the charged amount to simulate different types of responses. .00, .01 and .04 will approve and all other values will decline.
AShop V User Guide When an offline credit card payment option is selected, the customer is redirected to a payment form through a secure connection. The secure connection URL is set in Shop Parameters > Advanced Options. When checking out using this payment method, AShop automatically changes the URL to the Secure URL and redirects to the secure payment form. Customer Payment By Credit Card Customers enter credit card and billing information into the secure payment form and submit it.
Installation & Setup 125 subscriptions will be fulfilled. Links and passwords will be included in the receipt. Processing And Activating Orders There are several ways to access the credit card information for processing. 1. When the offline credit card processing method is used, the administrator's order notice will contain a link to login through a secure connection and view the credit card information.
AShop V User Guide Create An Offline Payment Option Create an offline payment option through the Configuration > Payment menu. Check the Deliver Before Payment box only if you wish to provide immediate access to digital products and subscriptions before the payment is processed and activated.
Installation & Setup 127 VISA MasterCard American Express Discover"; Common Problems The offline credit card processing option requires an SSL connection for the entry of credit card information by customers and subsequent viewing of the credit card information when it is processed by the AShop administrator.
AShop V User Guide PayPal payment integration is set in the AShop Administration Panel through Configuration > Payment. To add PayPal gateway service as a payment option; 1. Open the Administration Panel, select Configuration, and then Payment. 2. Click on the drop-down Payment Gateway box, select PayPal and click Add. 3. Enter the Merchant ID for your PayPal account (e-mail address). PayPal Instant Payments require a verified business account.
Installation & Setup 129 IT = Italian JP = Japanese US = American English · The locale in the shipping address sets the language in the PayPal payment page. For example, if you sell shippable products and the customer selects Spain for the country field in the shipping information page, the language (lc value = ES) parameter will automatically be sent to PayPal to select Spanish for the payment page. This value overrides the value that is set in the paypal.gw file.
AShop V User Guide An application through paypal.com is required and fees must be paid before Website Payments Pro or Express Checkout will work in the shopping cart. To use the Payment Pro options you will need a certificate file, a Merchant ID, and a password. Login to your PayPal account and go to the Website Payments Pro section. A. Login to your PayPal Pro enabled PayPal account and click Profile. B. Click "Request API credentials" under the section "Account Information". C.
Installation & Setup 131 3. Setup PayPal Website Payments Pro in AShop A. Login to your AShop V administration panel and click Configuration->Payment. B. Select PayPal Direct Payment and click Add. C. Enter the PayPal certificate API Username into the box labeled Merchant ID and enter the PayPal API Password into the box labeled Security Secret. Then click the Update button. 3. Setup PayPal Express Checkout in AShop A. Login to your AShop V administration panel and click Configuration->Payment. B.
AShop V User Guide C. Enter the PayPal certificate API Username into the box labeled Merchant ID and enter the PayPal API Password into the box labeled Security Secret. Then click the Update button. 2.24.28 PayPal PayFlow Link AShop Administration Panel Settings Verisign PayFlow Link payment integration is set in the AShop Administration Panel through Configuration > Payment.
Installation & Setup 133 Assure box is checked for Silent Post URL and enter http://www.yourwebsite.com/ashop/order.php This allows PayPal to post the info back to the cart with the Silent Post URL, but allows you to send people back to the website with the Return URL. Otherwise the orders are not recorded and receipts are not sent. The PayFlow payment form must be configured to collect the billing address and email address of your customers.
AShop V User Guide Total amount: between $1.00 and $150 Expiration date: Apr 2004 Address* : 8320 SOUTH HARDY DRIVE City* : TEMPE State* : AZ Zip* : 85284 * Only needed to get an exact AVS match 2.24.31 PaySat PaySat payment integration is set in the AShop Administration Panel through Configuration > Payment. AShop Settings 1. Open the Administration Panel, select Configuration, and then Payment. 2. Click on the drop-down Payment Gateway box, select PaySat and click Add. 3.
Installation & Setup 5. 6. 7. 135 Open the AShop file /admin/gateways/plugnplay.gw in a text editor. About half way down the page, there is a setting for the accepted credit cards. Delete the ones that are not accepted. name=\"card-allowed\" value=\"Visa,MasterCard,Discover,Amex,Diners,JCB,MYAR\">"; Save the plugnplay.gw file on the server. Plug-N-Pay Settings There are not any settings required in the Plug N Pay merchant panel in order to use it with AShop.
AShop V User Guide transaction. 6. Don't forget to click the "Update" button to save the changes you made. 7. To setup the postback to the Ashop V order processing follow the steps above in step 4 and then enter: http://www.yoursite.com/ashop/admin/psbill.php in the text input box on that page (replacing "http:// www.yoursite.com/ashop" with the right URL to the site). Then click the "Get Password Script" button and cancel the download that will result from this. 2.24.
Installation & Setup 137 ** Note TeleSign Phone Verification works with Payment Gateways, such as these, that use the AShop payment form: Authorize.Net AIM, Verisign PayFlo Pro, eSelect, Echo, and offline processing. It does not work with payment options where the payment form is hosted on the processor's server such as: Authorize.Net SIM and the majority of other payment options. ** TeleSign Phone Verification is not a Payment Gateway in itself, but a tool to help prevent credit card fraud. 2.24.
AShop V User Guide 6. Save Changes. Note: WorldPay grabs the callback URL page and displays it from their server. If you are using HTML page templates, the images and links within the delivery.html template must have absolute URL's. As mentioned in previous notes, there are other settings that you will probably want to change in the WorldPay Administration Server. After completing any other changes and successfully testing the payment process, uncheck the Test Mode box as mentioned in step 2.
Installation & Setup 139 · gatewayssek - Swedish Krona · gatewayssgd - Singapore Dollar · gatewaystec - Traffic Exchange Credits For each currency there is a set of payment gateway (.gw) files. Each payment gateway file is named with an abbreviation for the payment service that it is configured to work with.
AShop V User Guide $gw_orderid ... $gw_shipcountry = the field names of all the order information. Change these to the field names required by the the payment gateway. For example: if the gateway requires a variable named totalamount which should contain the amount to be paid then the $gw_amount variable should be set to: "totalamount". Fields not needed by a specific gateway can be set to "".
Installation & Setup 141 If the payment has failed then the variable $result["ERROR"] should be set to the error returned by the gateway. parse_response($gateway_input) - maps the fields returned by the payment gateway to the corresponding variables used by AShop. 2.25 Sales Office Configuration 2.25.1 Sales Office Configuration From the AShop admin panel, click on the Sales Office link in the main navigation bar on the left. At the top of the page, select Configuration.
AShop V User Guide blocked and messages to/from that sender will automatically be saved in the same customer's history. Mail Server Type Mail may be received in the Sales Office inboxes from a POP3 or IMAP mailbox. The IMAP setting is only available if the IMAP extension is installed on the server. Otherwise, it will default to POP3. When the Mail Server Type is changed, the Port settings for customer and vendor mail (see below) will automatically change to the default port for that server type.
Installation & Setup 143 The POP3 mailbox will be checked and mail downloaded automatically to the customer inbox upon logging into the Sales Office. If the admin email setting, which is set in Configuration > Shop Parameters is set to the same address as the Sales Office customer email address, all admin notices will post directly in the Sales Office customer inbox (not sent by email to the POP3 mailbox).
AShop V User Guide Office, each order begins with a quote. When a quote is converted to a bill there are bill options, which will be preset with these values and may then be edited for each bill. 2.25.2 Add/Edit Users The AShop Sales Office may be used by an individual or by multiple users. There is no limit to the number of users that can be created in the Sales Office. When logged in as admin all available data is visible and all options are available.
Installation & Setup 145 Edit Sales Office User Click on the profile icon to the right of the user that is to be edited. Edit the settings and then click Update to save the changes. Delete Sales Office User Click on the trash icon to the right of the user that is to be deleted. A confirmation page will open. Click yes to delete the user. Note that the admin user cannot be deleted. 2.25.3 Vendors and Products To create purchase orders and track order status each product must be assigned to a vendor.
AShop V User Guide Add New Vendor Click on the New Vendor button. Add the vendor contact information and click Save. Assign Each Product to a Vendor Assign each product to a vendor through the AShop admin panel Edit Catalog menu. Click on the edit button for each product. When at least one vendor has been added, there will be a drop-down selector in each product page. Select a vendor and save the product. Note that products are not required to be assigned to a vendor.
Installation & Setup 147 2.25.4 Contact Forms AShop contact forms post directly to the Sales Office inbox (database) and do not send any email. An image recognition character entry requirement in the form prevents most automated spam submissions. When used with an https connection, the AShop contact forms provide a secure way to receive sensitive information from a web site submission. The contact form requires three files, which are distributed in the emerchant directory. · mailform.
AShop V User Guide value="%firstname%". Each text field should have a value such as this, which corresponds with the field name. The tokens are used by mailform.php to repopulate the fields if there is a validation error and the page must be reloaded. The thankyou.html file is simply an HTML file. There is nothing special about it except for the name and location. 2.25.5 Quote Header/Footer Each order begins as a quote. Quotes may be saved and sent to customers by email.
Installation & Setup 149 Authorize.net ARB Authorize.net ARB billing templates create ARB (automated recurring billing) in your Authorize.net account from product or subscription orders that are placed through the shopping cart and through the Sales Office. Each ARB is created from the credit card information that was used to pay for the order. If more than one of the products in the order is assigned to an ARB billing template, an ARB will be created in Authorize.
AShop V User Guide AutoBill Recurring Bills When a recurring bill template is set to initiate an AutoBill and a product, which is set to use that billing template is ordered through the shopping cart or the Sales Office, the Sales Office will subsequently create new unpaid orders for the product and send invoices on a preset billing cycle. If more than one of the products in the order is assigned to a billing template, a recurring bill will be created for each of the products individually.
Installation & Setup 2.26 151 Third Party Software Integration 2.26.1 Third Party Software Integration To integrate AShop to any of the third party software applications that are supported by AShop V: 1. Follow the installation instructions for each application. Setup the program and test to ensure that it is working correctly. Note: AShop Software does not provide free support for third party application installation or usage.
AShop V User Guide Administration Panel > Edit Products for each product. To be able to use the email method a mail filter needs to be installed which runs an ARP script automatically when a message is sent to a certain address. Note: See ARP instructions for installation of ARP and mail filters. You don't need to have a mailbox for each email address that is to be used in ARP.
Installation & Setup 153 xml.php script in the box labeled Email Marketer URL on the page Advanced Shop Parameters in your AShop Administration Panel. Then enter your IEM XML Username and XML Token in the boxes Email Marketer User and Email Marketer Token.
AShop V User Guide stored in a subdirectory to the directory that the PA+ scripts are installed in or there may be only one set of corresponding .txt files in the directory that PA+ is installed within (not a subdirectory). The only thing AShop does differently with PA+ integration is to write to those .txt files instead of to a .htpasswd file. Note: When we originally created integration to PA+, in version 3.
Installation & Setup 155 installed on the same server as AShop and the path to Password Robot is set within the third party software integration, each subscription can instead be managed after the initial order by using the more advanced features of Password Robot. How AShop V Integrates To Password Robot Password Robot is a Perl CGI program that lets you easily manage access to an unlimited number of password protected directories.
AShop V User Guide than you need. When you have signed up you will be assigned a Vendor code by Secure eBook. You can look this up on the page My Account->Account Information in your Secure eBook account. On this page you will also find an option to Enable SDK. Check this option and enter your own security secret in the box SDK Secret Keyword. Now you have all the information needed to setup a fulfilment option in your AShop: 1. 2. 3. 4.
Installation & Setup 157 Login to your Secure eBook account again and open the page My Products->Create a new Product. Enter the product ID in the box "Shopping Cart Product Code". Fill out the rest of the form with the values you want to use for your eBook and select "eBook Activation" as the "Protection Type"...
AShop V User Guide delivery is working properly you should open the file automation/secureebook.php in a text editor - for example Windows Notepad - and change the line: $testmode = true; to: $testmode = false; You will find this line near the top of the file. Don't forget to upload the file when you have made the change. 2.26.9 Aweber Aweber is one of the most popular hosted autoresponder services available on the web. You can sign up for an account with them at: www.aweber.com.
Installation & Setup 159 make it accept calls from your AShop to register members. Inside the functions.php file for your Wordpress theme, insert a code like this: /* AShop remote registration payment */ add_action("init", "make_registrationlink"); function make_registrationlink(){ $secretkey = "myownsecrectkey"; if($_GET["make_registrationlink"]){ $subscr_id = $_GET["orderid"]; $custom = $_SERVER["HTTP_HOST"]; $item_number = $_GET["item"]; $reg = $_GET["reg"]; $checkreg = md5($subscr_id.$item_number.
AShop V User Guide automated, the customer will still need to complete the last step manually: selecting a username and password for their account. When a customer buys a product that is integrated with Wishlist Member they will receive an email with a link that takes them to that last step. The Wishlist Member integration is done through the automation fulfilment feature. The first thing you need to do is to edit the wlmember.php script, which you can find in your automation directory.
Installation & Setup 161 In the
AShop V User Guide Catalog" in the menu, locate a product you want to connect to the autoresponder and click Edit on that product. On the page that opens you should find a box labeled "Fitlist Pro Responder ID" where you should paste or enter the id of your autoresponder. Now your AShop is set to automatically sign customers who buy this product up with your Fitlist Pro autoresponder.
Installation & Setup 163 Be sure to click the "Upload and Restore" button. 2.27.2 Updating Software Versions As of version 4.2.6, software updates and patches are distributed through the admin panel in the resources page. The technical support and updates must be current and active for the license key and resources to be visible. Update Instructions Updating from one version to the next, it is typically simple. 1.
AShop V User Guide CUSTOM IMAGE FILES (If there are not any new button image files in the update package or if the original button images that came with the program have not been changed, skip this step.) If any language specific image files in the images directory or within a theme/images directory have been replaced or modified, do not upload the entire images directory. Instead, check the mod dates for new images and only upload new button images that have been added to the program.
Installation & Setup 165 · IonCube decryption is working. · The AShop Software license server can be reached AShop Pre-Installation Test The ashoptest.php script can be used to ensure that the server configuration is compatible with AShop before uploading all of the progam files, creating a database, and installing the program. The ashoptest. php script checks and reports the status of the server configuration as it relates to AShop.
AShop V User Guide work, but we are not sure which ones or how to check for all of them. If this test fails, you can still install and run AShop. If there are no PHP warning messages at the top of AShop pages, then the setting is probably ok. fsockopen-function is working The fsockopen-function is used for server to server communication. It is required to update the IonCube loader and to register the license key.
Installation & Setup 167 resilien/public_html/yourdomain/ashop/admin/login.php(2) : eval()'d code on line 102 Some servers have trouble with an empty line feed at the end of config.inc.php. The empty line feed appears to be inserted by some FTP client programs when uploading PHP files. To fix the trouble in admin/config.inc.php, remove the extra line feed(s) at the end of config.inc.php and, if necessary, try a different FTP client. 2.28.1.5 Database Not Found When install.
AShop V User Guide program files. · If you are still having issues with the IonCube loader not passing the ashoptest be sure that the PHP extension_dir is set to a complete file system path, like for example: "/usr/lib/php4". This can be modified in the file php.ini (typically found in /etc) but you must have system administrator privileges on the server to be able to change the file so you might need to ask your hosting provider to fix this problem for you.
Installation & Setup 169 Check the ioncube directory permissions. They should be 777. If not, change the permissions and run ashoptest.php again and refresh the FTP browser. If running ashoptest.php does not get the correct loader, there is most likely a restriction imposed on server to server communications, which is preventing the download. If this is the case, manually upload the ioncube loader and run ashoptest.php again.
AShop V User Guide
The extra line breaks will obviously cause the resulting page to look different than intended and quite likely will cause the page to be severely distorted. The solution is to join the HTML code. This can be done by copying the HTML source code and pasting it into a text editor that has a "Join Lines" feature, such as NoteTab Pro or it can be done manually. The resulting code should look something like the following. Text within the table cell.Installation & Setup 171 Warning: Cannot set time limit in safe mode in /home/virtual/usr/html/ashop/admin/ mailcustomer.php on line 11 set_time_limit() lines and the PayFlow Pro modules are affected by safe-mode. set_time_limit() can be commented out and the program will still run and send mail. To use the PayFlow Pro payment option, safe-mode must be off. 2.28.1.13 Time Zone Offset Many times, the server or hosting service is located in a different time zone than where the merchant is located. AShop V User Guide Note: There is a bug in pre 4.2.x versions of PHP that may cause "open_basedir restriction" messages to appear when OrderForm pages are located within subdirectories. This can be avoided by locating the OrderForm pages in the same directory as AShop or by updating the version of PHP that is running on the server to a more recent version. 2.28.1.16 Mail Blocked By Spam Filters AShop receipts, order notices, messaging to affiliates and customers are not received. Installation & Setup 173 2.28.2 File Download Issues 2.28.2.1 Downloaded download.php Instead Of Product File If a customer reports that he downloaded a file named download.php instead of the product file, your product file is most likely missing. Check that your "products" directory have 777 permissions, then check the Edit Files page for the product in your admin panel and reupload any missing files. 2.28.2. AShop V User Guide 2.28.3.2 Error 97 - Authorize.Net SIM When submitting an order to the Authorize.Net SIM payment form... Error (97) This transaction cannot be accepted. or Error # 97 The time period for this request has expired. This is most likely caused by the clock on your server set incorrectly. If the server is set to adjust itself to Daylight Savings Time, it should be changed so that the time is consistent throughout the year. See http://www.sluggis.com/error97. Installation & Setup 175 2.28.3.4 Credit Card Fraud Prevention Credit card fraud can be a nuisance and can indirectly damage your credit. Credit card issuing banks and organizations have developed security devices to prevent unauthorized use of credit cards. Not all banks support all security devices and not all payment processors or payment gateways support them. AShop V User Guide AVS Address Verification System AVS is supported by most US credit cards and is not supported by non-US banks. As with the security code check, it may work for you or not depending on where your customers are located. For merchants who ship goods mostly within the US, the Address Verification System is a must have. Even within the US, there will be a small percentage AVS declines due to non-supporting banks and trouble with PO box addresses. Installation & Setup 177 the payment confirmation page can appear. "This page contains secure and non-secure items. Do you want to proceed?" Eliminate the secure/non-secure content message by using a secure (SSL) connection for all of the image links on the page. Example: Secure URL: https://www.yourdomain.com/ashop/images/logo.gif 2.28.3. AShop V User Guide 2. Change the starting orderid number to a higher number such as 1000 or 10000. This can be done from a command line or with the aid of a database management tool such as phpMyAdmin. 2.28.3.9 PayPal - Suspected Payment Manipulation After PayPal payment, the following message is received by the AShop administrator. Suspected payment manipulation: customer@emailaddress. Installation & Setup 179 find the IP of the paypal.com domain. HTTPS Proxy Settings. Some servers are set up with Curl on a proxy server. If the proxy server path is not set, the above error may occur. See the help topic for Curl SSL. 2.28.4 FrontPage 2.28.4.1 FrontPage Removes AShop Tags When publishing the web using Microsoft FrontPage 2002, htm and html files may be overwritten even for page files that are not included in the local web site (on the PC). AShop V User Guide background: #ffffff; width: 145px; height: 21px; font: 11px verdana, arial, helvetica; color: #000000; text-align: left;" > 2.28.5.2 HTML Within Product Descriptions HTML can be used within the product description to format the layout and text. It can also be used to add images and links. Here are some instructions and tips for using HTML within the product descriptions. Installation & Setup 181 The code can also be manually selected by switching to HTML code view, highlighting the source code and copying it with Ctrl + C or the mouse shortcut menu Copy tool, but you must be careful to include all of the opening and closing tags. Paste the HTML into the product description using Ctrl + V or the Paste tool from the right click shortcut menu. AShop V User Guide Click the Submit button at the bottom of the page to save the changes. When the product is viewed in the AShop catalogue view, the HTML will be rendered right along with the rest of the page. 2.28.6 Autobill 2.28.6.1 Cron Errors If you are receiving Cron errors each time the autobill.php script is run or at least each time it is trying to create new bills, check that the command line version of PHP on your server is not operating under safe mode. Manage Products 3 Manage Products 3.1 Edit Catalog 183 Catalog pages are dynamically generated by index.php or catalogue.php for customers to make selections, and purchase products. Shopping pages may also be created by inserting Buy buttons in HTML or PHP web pages using the Order-Link method. In any case, the behavior of the shopping cart when products are added to the cart will be determined by the Shopping Cart Catalog Mode setting, which is in Configuration > Shop Parameters. AShop V User Guide To add a new category, from the Administration Panel, click Edit Catalog. 1. Click on the "New Category" button. 2. Enter the name of the new top-category. Optionally enter a description for the category. Note: To add a sub-category you must first be viewing the category you want to make a sub-category for then click the "New Category" button. You must also change the type to Subcategory. Manage Products 185 3. Select owner. Leave it set to Administrator if you are not using the Shopping Mall features. This setting lets you assign a product category to a specific shop within your mall and the category will only be visible in the shop that owns it. The Administrator is the default and the only shop if you are not using the Shopping Mall. 4. Set the language. Leave it set to Any if the category is to open for all language preferences. AShop V User Guide 2. Edit the category name and description, then click Submit to save the changes. Manage Products 3.4 187 Remove Category From the Administration Panel, select Edit Catalog 1. To remove a category, click on the "remove" link underneath the category name. Warning! Removing a top-category permanently deletes any sub-categories and products that are stored in that category! Removing a sub-category permanently deletes any sub-categories and products that are stored in that sub-category. 2. A warning notice will be displayed before the category is removed. AShop V User Guide To move a category to the top of the category list, click on the Move to top link. 3.6 Manage Content Content items are HTML and/or text that can be inserted anywhere in your product catalog. This can be used, for example, to add information about current special offers or inform the customer about other, related products. To add a content item open the page Edit Catalog in your administration panel and click the button: New content. Manage Products 3.7 189 Manage Products From the Administration Panel, select Edit Catalog. Products can be all in one category or they can be organized within categories, subcategories and sub-sub-categories. Click on the category name to view products in each category. If there is a sub-category, it will display below the selected category. To view its products, click the sub-category name. If there is a sub-sub-category, it will then appear below the selected sub-category. AShop V User Guide · Hide product codes in descriptions using HTML comment tags. Concerned about customers seeing the product codes? Put the product codes in the descriptions and enclose the keywords or product codes within HTML comment tags. The comment tags will keep the code from appearing in the catalog pages, but the search tool will still find the keywords and product codes even when they are between comment tags. 3. Manage Products 3.9 191 Add Products From the Administration Panel, select Edit Catalog. See also: Import Products Before adding the first product to the catalog, set the Thumbnail Image Size in Layout so that resizing will be consistent for all products and their thumbnail images. 1. Select the category that the product will be added to. If one does not exist, you must first add a new category. 2. Click on the New Product button at the top of the page. 3. Enter the Name, Price, and Description. AShop V User Guide cart is configured. For example, when the Shopping Mall is being used there will be a setting to assign ownership of the product to administrator or a member there may be a setting for Vendor and product cost. Not all of the possible settings are shown here. Product Options · Catalog Status - Choose whether you want the product to be displayed in the catalog or not. Note: In the Edit Catalog menu, you may also click the Active/Inactive icons to change the catalog status. Manage Products 193 AShop will optionally integrate with several popular PHP applications such as mailing list, bulletin board, and password management programs. If the third party application is installed within the same server account and the path is set within the admin/config.inc.php, a drop-down selection box will appear on the add product or edit product pages. Select the group that this product is to be associated with. See Installation of AShop - Third Party Software Integration. 4. 3.10 AShop V User Guide 5. Click the Update/Delete button to upload the files you have selected. 6. Click the Finish button and proceed to the Shipping Calculation Method page. 7. Choose the Shipping Calculation Method you desire and click Submit. Edit Products From the Administration Panel, select Edit Catalog. Select the category that the product to be edited is in. Navigate to the product and click the button for the area that is to be edited. The Search tool can be used to find products. Manage Products 195 product through Edit Catalog > Flags. · Make HTML - Generate/Edit product detail pages. Change META tags for the product detail pages. · Update - Update is a method of sending messages and file downloads selectively to customers who have purchased a specific product. · Gift - Send a message with a link and password for a free downloadable product file. A default text message is written within the message field. This can be edited so that you can use any message you desire. 3.12 AShop V User Guide Edit Product Inventory The Product Inventory settings will let you keep track of how many items you have in stock and when a low stock warning should be displayed to you and your customers. The inventory is also visible as a small icon next to the name of each product on the Edit Catalog page. If there are items in stock the inventory meter icon will be green and nearly full. Manage Products 197 Categories will be displayed with a Move here button beneath them. To display sub-categories, click on the top-category name. Sub-categories will be displayed under their top-category with a bullet in front of them. 3. Click the "Move here" button beneath the category that you wish to move the product to. The product will then be displayed within the new category. Note: You can copy the product to another category while keeping the product in its existing category as well. AShop V User Guide Move a product up within a category 1. Select the category that the product is in. 2. Click the Move Up button beneath the product. The product will move up one place within the selected category. 3.14 Discount Coupon Codes There are two ways that discounts can be created and redeemed in the shopping cart. Per Order Discounts An unlimited number of per order discounts may be created. Create per order discounts in Edit Catalog. Manage Products 199 Per Product Discounts Per product discount codes are created each product in Edit Catalog. Per product discounts may be entered by customers on checkout, just like per order discounts, but they will only be applied to the price of the associated product. You can only add one per product discount code for each product. Create a Discount Code For Each Product 1. Navigate to the category where the product discount is to be added or edited. 2. AShop V User Guide Only customers who are logged in will be able to use these discounts and when they use them, this will be recorded to prevent further use. Create a Gift Certificate If you have a customer who you would like to send a gift certificate to, you can do so using the one-time discount feature: 1. Add a product with a price of $0.00 (no taxes or shipping). 2. Click the "Discount" button for that product and add a one-time discount for that customer (or customers) as described above. Manage Products 201 * Note that the initial price is already set into the first pricing level. Add this one first before adding additional pricing levels. 4. Add additional pricing levels. Click the Add button each time a new pricing level is inserted. In this example, prices (set specifically for the quantity of this product only) are $4.00 per item. When 3 5 more are purchased they are $3.00 each additionally. When 6 or more additional are purchased they are priced at $2. AShop V User Guide In the actual product catalog the price will show the Pricing Description that you entered in Step 1. 3.16 eBay Item ID When products are listed in an eBay store and have only the PayPal payment option set for the eBay listing, payment for the eBay item can be linked to AShop. eBay Orders Paid Through AShop To use this feature, you need to have a premier or business PayPal account. No other payment gateways will work. Manage Products 2. Add the product to your eBay store and set the payment options to only PayPal. 3. Enter the eBay Item Number in the product settings in Add Products or Edit Products. 203 The ebay.php works like order.php but uses the eBay Item Number instead of the productid to identify which product has been purchased. Note: The affiliate tracking will not work for products sold on eBay. AShop V User Guide store. 1. 2. 3. Set the eBay item number to the same as the product ID in Edit Catalog > Edit (for the product). The IPN URL setting in the PayPal account must be set to where the ebay.php is located unless you make an unencrypted "Buy Now" button, which will let you add the IPN URL as a hidden field named: notify_url. For example: PAGE 205 Manage Products 205 License agreements are added in Add Products or Edit Products. Navigate to the product you want to add a license agreement to and click the "Edit" button. Click the "Add license agreement" button and enter your license agreement information. Click the "Submit" button to save your changes. Note: The license agreement can contain HTML formatting and links. Tip: If you upload a text document named agreement. AShop V User Guide actual data is renamed and saved under a different file name in a protected folder on the server. When delivery of the product file is authorized, AShop displays the original product file name to the customer, but the original file (that was renamed) is actually downloaded. The name and location of the product on the server is never available to the public and is only accessible through the AShop program. 3. Manage Products 207 To upload product files larger than the limit set by your servers PHP configuration: 1. Upload the product file to the ashop/products folder via FTP or using your hosting service's file management program. 2. AShop checks to see if there are any product files that have not already been recorded into the database and will display a drop-down selection box within the Add Product or Edit Product window where the file can be selected. 4. AShop V User Guide The update notification can be sent in both Plain text or Html formats. When the form is submitted, the file is uploaded to the updates directory and the message with a password and download link is sent to all customers who should receive the update. When customers download the file, a notice is emailed to the shop administrator with the customers name and IP address. 3. Manage Products 1. 209 Click the Gift button to open a menu where you will enter the customer's Name, Email Address, Subject, and an HTML or Text format message. Note: Use tags such as %email% in the message to send the customer's email address and % password% for the login password. 2. Click the Send Gift button to send the customer their free downloadable gift. Free Products When the total of all the products in a customer's shopping cart equals zero dollars, whether the products have a price of $0. AShop V User Guide membership. Expired passwords can be removed manually by running a script or the process can be automated by running a Cron job on the server. AShop V also integrates with the free s2member Wordpress plugin for selling access to a protected Wordpress site. 3.22 Membership Configuration Memberships provides a method to sell password-protected access to specific folders (directories). To add a membership, you must first create a subdirectory to hold the protected content. Manage Products 7. 211 Click the Submit button to save the product information. AShop will now protect the directory and prepare it for use as a membership product. Note: Since AShop uses .htaccess password protection, this feature is only available on Linux/Unix servers. Customers May Recover Forgotten Passwords If a customer, who has purchased a subscription product, cannot remember their password, they can retrieve it. If they call sendsubscrpass. AShop V User Guide mailed store receipts that are sent to customers. Discount Coupon Codes may be created for subscription products. 3.23 Key Codes Key-codes are typically used to unlock trial software, activate phone cards, distribute passwords, or to send unique information with the purchase of a product. When a product that has key codes is purchased, a key code is sent to the customer by email. Key codes can be distributed with any product in the AShop catalog except subscriptions. Manage Products 213 Each time a key code is ordered, AShop checks how many unused keys are left in the database. When there are less than 4 keys left a warning message is sent telling the shop administrator to upload new keys to the database. If there was no keys available at all the warning message tells the shop administrator to send one manually to the customer and includes a link to the customers email address. The key codes may be distributed in random order or in the original text file list order. AShop V User Guide To set the shipping charge calculation method, click on the drop-down box labeled Shipping Option. Each product can use a different shipping option. An unlimited number of products with different shipping options can be mixed in each order. Each shipping option calculates independently in the background and then they are added together for the total shipping charges. Manage Products 3. 215 Click the Submit button. UPS – This shipping option uses the United Parcel Service Online Tools to calculate U.S. and Canada Ground rates in real time based upon the shipping weight and origin of each package for each product and the destination zip code of each order. There is no limit to the number of packages that can be calculated for each product and each package may have a different origin zip code. AShop V User Guide 1. Select FedEx from the Select option Drop-down box. A shipping origin and weight per package form will appear. 2. Enter the zip code of the shipping origin and the weight of the first package. 3. If the product ships in more than one package, click Add package. A new row will appear. 4. Enter the origin zip code and shipping weight for each package and repeat the process as needed. 5. Click the Submit button when finished. Manage Products 1. 2. 3. 4. 5. 217 Select Watkins ML from the Select option Drop-down box. A shipping origin, class, and weight per package form will appear. Enter the zip code of the shipping origin, class, and the weight of the first package. If the product ships in more than one package, click Add package. A new row will appear. Enter the origin zip code, class, and shipping weight for each package and repeat the process as needed. Click Submit when finished. AShop V User Guide Quantity Based Shipping can be set for each product. In this example, if quantity 1 to 4 of this product is ordered, shipping will be the quantity of this product times $4.52. If quantity 5 to 9 of this product is ordered, the shipping will be the quantity of this product times $2.50. If quantity 10 to 14 of this product is ordered, the shipping for this product will be the quantity times $0.50. Manage Products 219 2. Enter the amount of shipping that is to be charged for quantity 1 or more and click the Update button. This amount will be multiplied times the quantity of products in the basket until the quantity of this product is greater than the next quantity level. (in the next step) 3. After the form is updated, a second row will appear. Enter the quantity to begin and set the shipping amount to charge, then click Add Row. 3.27 AShop V User Guide Zip Zone Shipping Rates Zip zone rate tables provide a method to set 7 shipping zone rates for each product. The zone is looked up from a custom zip code table that is created for each shipping origin. If products that have zip zone shipping are in the cart, a shipping information form appears when checking out. The first three digits of the zip code are used to lookup the zone and the shipping rate that is set for that zone (for that product) is added to the order. Manage Products 5. 221 Repeat steps 3 and 4 until you have the desired amount of zip zones covered. The Zip Zone tables consist of two columns and as many rows as you need. The left hand column is the first three digits of the zip code. The right hand column is the zone that will be looked up when a zip code starting with the corresponding first three digits is processed for an order shipment address. It is not necessary to put every zip code in. only the points where there is a change in the zone. 3.28 AShop V User Guide Product Attributes Product attributes provide a method to specify specific versions or variations of each product when adding the product to the shopping cart. The selected attributes are sent in the receipts and order notices and are also recorded in the sales history. An unlimited number of product attributes can be set for each product. Manage Products 223 Each product attribute alternative can be optionally set to override downloads, shipping charges, and/or sales tax. This is useful where one product might be delivered in various formats. An example of where this might be used is where music titles are available for the same price in several different formats. No shipping or tax would be charged for the MP3 file download in the U.S., but it might be taxed in the UK. AShop V User Guide Attribute alternatives can have a different price set for each alternative. Check the "Activate separate buy buttons and/or prices" box to allow each alternative to have a separate price and separate buy buttons for each in the catalog. Check the "Activate separate shipping options" box to have the option of setting each attribute have no shipping and/or no sales tax. To delete an alternative simply click the "Delete" button. Manage Products 225 To change the caption, edit the text and click Update. To exit without changes click the back button or another menu selection. To edit alternatives, click the Alternatives button. Edit or delete the alternatives as needed, then click the Save button. Attributes for Downloadable Products When you have a downloadable product there is an extra check box labeled "Activate separate download options" If you upload multiple files for a product. AShop V User Guide The product ID is not included by the automation fulfilment feature but there is a way to include this or any other product specific information you want to send. An attribute with 1 alternative to the product you wish to use the automation for. You can for example call this attribute "Product ID". Set the single alternative to the product ID for your product or to any other identifier you wish to use. Manage Products 227 The Make HTML tool will use a page template, get product information and images, and create a new HTML page from the page template and product data. Buy buttons can be automatically generated in each product page. 1. Design a page template and save it to the templates directory. An example named template. html is included with the new installation files. You can also use the AShop page layout templates. 2. AShop V User Guide Now you need to add at least one product that uses the Bid code fulfilment option. 1. 2. 3. 4. 5. 6. Open the page Edit Catalog. Select the category you wish to put the bid codes product in. Click New product and fill out the forms. When the new product has been added click the Attributes button. Add an attribute with 1 alternative. Call it "Bids". Enter the number of bids you want to sell, for example: 30, into the box labeled "1:" and click Save to store the new attribute. 7. Manage Products 229 upper right corner of one of your product listings on the page Edit Catalog in your administration panel: This will select the product and let you choose another product which is related to this one. Click the green accept icon in the upper right corner of the product you wish to select or the red cancel icon to get out of the relate products mode. AShop V User Guide to be his/her own email. They can even be sent to multiple email addresses if needed. They can include an automatically generated gift certificate code which is used on the checkout page in a similar way to how the per order discounts work, except that these codes will not give the same discount any number of times, they only let the customer buy for a certain amount just the way a gift certificate works in a physical store. Manage Products 231 You can define the area where the text should be placed on the card. Just click on the image icon next to the box "Text top" to define the upper left area. A window will open with the e-card image. Click on the image where you want the upper left corner to be: Do the same thing for the lower right corner by clicking the image icon next to the box "Text bottom right". If you want to you can fine tune the text area by changing the resulting coordinates in the two boxes. AShop V User Guide the card product. Then click "New product". Fill out the "Add product" forms just like you would normally do when adding a new product, by giving the product a name, description, price and so on. When the product is added click the Attributes button in its listing. Add one attribute for the personal message. It should have zero alternatives and you might want to set it to more than one row of text to make it easier to add a longer message. Manage Products 233 Select your e-card fulfilment option in the "Select Options" box on the Fulfilment Options page. This will bring up some new input fields on the page, one for each attribute you created for your product. AShop V User Guide When the customer buys the card it will be sent by email to the address specified in that window, which can be a different person than the one buying the card. The email will look something like this: The text on the card in the email is selectable and can be copied and pasted by the recipient to make it easier to use any gift certificate or unlock key codes. Customers & Sales 4 Customers & Sales 4.1 Manage Sales From the Administration Panel main menu, select Customers. There are two main sections: Customers and Messaging View/Edit/Delete Customer Profile View Individual Customer Purchases Mail To Individual, Selected, Or All Customers Sales Reports Generate Sales Reports For Date Ranges Order Reports By Date, Price, or Customer Download Reports In Comma Delimited Files For Viewing Off-line 4. AShop V User Guide Email Messaging to Customers To email a message to one customer Click on the e-mail link for the selected customer. This will open your default e-mail program, such as Outlook Express or Eudora. To 1. 2. 3. e-mail a message to selected customers Place a check mark in the box next to each customer that you wish to send a message to. Enter the Subject and Message text into the corresponding text boxes. Click the "Mail to selected" button to send the message to selected customers. Customers & Sales 237 editor. You can then copy the HTML code and paste it into the message box to send newsletters, advertisements, and other notices to customers or affiliates. Note: With this setting, carriage returns within the message box do not generate line breaks and must always be inserted with or tags or the text will all flow together in the resulting email message. AShop V User Guide 3. 4. To view the customer's profile data without editing it, simply click another menu option or page back when finished viewing. To edit the customer's data, type or paste the new information into the appropriate text boxes and overwrite the pre-existing data as needed, then click the Update button. The new data will replace the previous data and you will be redirected back to the Customers and Messaging page. Customers & Sales 239 To view a customer's sales history: 1. Click on the Statistics icon, , next to the selected customer. 2. A Sales Report page will open for the selected customer with the date, time, product name, and referring affiliate ID and name for each order. · To send an e-mail message to the selected customer, click on the customer's name. Your local mail program will open and be addressed to the customer. AShop V User Guide · Payment Status: Unpaid, Paid, Chargebacks or All · Date Range From: date, To: date Sorting and Grouping The filtered report data may be grouped and sorted to view the data from different perspectives. · Order By: Date, Amount, Customer ID, Product, Downloadable Product, Physical Product · Sort Order: Ascending or Descending order. View - Download - Edit The View and Edit buttons display the report in the browser, but different data and links appear in the right column. Customers & Sales 241 Chargebacks - Reversals A chargeback in AShop V creates a transaction equal and opposite to the original transaction. The reverse transaction is dated with todays date so that the sales reports can be reconciled with bank deposits. To Chargeback an order and the corresponding affiliate commissions, click on the Cancel Sale icon, , next to each order record. AShop V User Guide Recovering Incomplete and Failed Orders Preliminary Orders A preliminary orderid is created each time a customer begins to add products to his/her cart. A preliminary order is saved in the database for each shopping session so that many customers may shop at the same time and also to enable more data to be processed for each order. Payment gateways limit the amount of data that can be passed through the payment process. Customers & Sales 243 history.. The Incomplete/Failed Orders report provides a way to view preliminary orders to find one that failed, and then activate the order so that a store receipt will be sent and the order will be recorded in the shopping cart history. Payment is NOT submitted to any payment service during this process. 1. From the Sales Report page, under Incomplete/Failed Orders, click Edit to show all of the preliminary orders. 2. AShop V User Guide included in the customer's receipt. 4.6 Chargebacks - Reversals A chargeback in AShop creates a transaction equal and opposite to the original transaction. The reverse transaction is dated with todays date so that the sales reports can be reconciled with bank deposits and refunds. To Chargeback an order and the corresponding affiliate commissions, Open Sales Reports and select the date range of the transaction to be reversed. Customers & Sales 245 Chargebacks appear in reports with red text and negative amounts. There is an icon next to each chargeback, which displays the comment when the mouse is passed over it. Note: If your mail server is in a different time zone and the $timezoneoffset is not set to adjust for the difference, very recent sales transactions may not be included even when the "To:" date is set for the current date. This happens when the order is stamped with a time that is ahead of your current time zone. AShop V User Guide You will see a page where you can select to resend the receipt, change the email where it will be sent, send a copy to the administrator, and select to reset the allowed download days and allowed number of downloads. Click the Submit button and the Receipt will be resent and/or reactivated accordingly. View Original Receipts AShop will save all the sales receipts that have been sent to you customers so that you can view them any time you have access to your AShop Admin Panel. Customers & Sales 247 2. Unpaid orders may also be activated through the Sales Reports menu. Select Unpaid and click Edit. Then click the manual payment icon in the Unpaid Orders Sales Report. Payment Confirmation Message After payment is applied there is an option to send a payment confirmation message to the customer. The Subject and Message body is automatically filled in with predefined text, which may be edited before sending the message. AShop V User Guide Send Payment Reminder Message In Sales Reports, select Unpaid and Edit mode. For each unpaid order, there will be a link to send a payment reminder message. Click on the payment reminder icon/link. The Subject and Message is pre-filled in and may also be edited. A link to pay will be automatically included in the message. Affiliates & Referals 5 Affiliates & Referals 5.1 Affiliate Program 249 From the AShop Administration main menu, click Configuration on the left side menu. This will open the Configure AShop menu. Click on the "Affiliate Program" link. Affiliate Text This text will display on the affiliate sign up page. The most common use for this text is to disclose the terms of the affiliate program and to invite new affiliates to join. HTML and hyperlinks can be included in this text area. AShop V User Guide Upgrade Affiliates After Automatically upgrade your affiliates to a higher commission rate when they have referred a certain number of orders. Share Leads Allow your affiliates to download a list of contact information to customers they have referred, which they can use to follow up with customer or even to sell other products to them, if you allow this, which can be a great incentive to join your program. Affiliates & Referals 251 ashop/catalogue.php). Once the cookie is set, visitors can leave and return at any time to make a purchase. AShop checks the cookie and credits the referring affiliate. The catalog can also be accessed by navigating directly to the script catalogue.php (for instance, http:// www.yourdomain.com/ashop/catalogue.php) or to the AShop folder, where the index.html file will redirect to catalogue.php, but these links will not credit any affiliate. 5.2 AShop V User Guide Multi Tier Affiliate Commissions From the AShop Administration main menu, click Configuration on the left side menu. This will open the Configure AShop menu. Then select "Affiliate Program". Multi Tier Affiliate Commission Tracking Multi tier affiliate commission tracking in AShop Software calculates different types of commissions. Each affiliate tier promotes your online business in a different way. Tier one commissions are earned by affiliates who promote your products. Affiliates & Referals 253 Each affiliate places a sign up form link and a sales link on his or her web site or uses your sales pages, which can be personalized for each affiliate. Each affiliate earns the tier-1 commissions for AShop sales that come through his sales link and also earns a smaller commission for sales by the affiliates that have signed up through his or her sign up form link. 5. AShop V User Guide To e-mail a message to one affiliate 1. Click on the e-mail link for the selected affiliate. This will open your default e-mail program, such as Outlook Express or Eudora. To e-mail a message to selected affiliates 1. Place a check mark in the box next to each affiliate that you wish to send a message to. 2. Enter the Subject and Message text into the corresponding text boxes. 3. Click the "Mail to selected" button to send the message to selected affiliate. Affiliates & Referals 255 mail message. Plain text The Plain text setting does not recognize HTML tags and will render tag text in the e-mail message just as you enter it into the message box. With this setting, carriage returns in the message box generate a line break in the resulting e-mail message as they do in your client e-mail software such as Eudora or Microsoft Outlook 5.5 View Affiliates' Websites From the Administration Panel main menu, select Manage Affiliates. AShop V User Guide The affiliate's contact information will be displayed in text boxes within a form. The Manual Referral Code can be used to track word of mouth and print advertising and discount coupon campaigns. It is automatically generated by AShop when each affiliate signs up. It is generated with 8 characters; generally the first two letters of the first name, the first three letters of the last name, and a three digit number. The referral code is editable by the shop administrator. Affiliates & Referals 257 · Telephone Number · Website URL · PayPal ID (e-mail address to receive PayPal commission payments) Note: All of the Affiliate Contact Information is required in the affiliate sign up form, with the exception of the PayPal ID, which is optionally required. To edit any of the above fields, type new information into each text box that you wish to change. Click the Update button. The information that is displayed in the form will replace the existing information in the database. 5. 5.8 AShop V User Guide Affiliate Commission Payments From the Administration Panel main menu, click on Manage Affiliates, and then click on Statistics and Payment. A Pay Now icon, , will appear next to each affiliate who is owed a commission. Click the Pay Now icon, , to open the Affiliate Payment page for that affiliate. The total balance due for the selected affiliate is listed at the top of the page. Unpaid commissions are listed with the Order ID, Date, and Commission amount. Affiliates & Referals 259 To undo payment records: 1. Click on Manage Affiliates, select Statistics and Payment, then click on the Statistics, , next to the affiliate that you wish to edit. 2. Click on the Delete icon, , next to the commission payment record that is to be deleted. Note: To use the PayPal payments feature, the affiliate must first have a PayPal ID recorded in Affiliate Contact Information. AShop V User Guide affiliates to use in their web sites, ezines, and newsletters. Once the store administrator enters the banners and text ads, the code generator automatically inserts each affiliate's ID into the code for them to copy from their affiliate support panel. You can sort your links/advertising material into an unlimited number of categories. Click "Edit link categories" to add or manage your categories. Add A New Link 1. Select which category the link should be added to. 2. Affiliates & Referals 261 We like to Go here. Customers see "We like to Go here." When the mouse is passed over the link, the complete URL appears in the browser status bar. http://www.yourdomain.com/affiliate.php?id=2 %affiliatecloaklink% inserts the URL to the affiliate.php script on your site and adds each affiliates' ID parameter. It also adds link cloaking code, which prevents the actual URL from being displayed in the browser status bar. AShop V User Guide affiliate link where the "Firstname" text will be replaced with the actual first name of the affiliate. Affiliates & Referals 263 2. Enter the name of the new tag, which is what the affiliate will see on the Change Profile page, into the box "Field name" 3. Enter the tag text of the new tag into the box "HTML tag". AShop will automatically add the text "" to the end of your tag. 4. Enter the number of rows of text that the affiliate should enter for this custom tag. 5. Click "Add" to create the new custom tag. AShop V User Guide All of the registered discount codes will appear for each affiliate. Customers can be sent to a page where they are prompted to enter a referral code. This page can be the affiliate.php script or a form that is placed within an HTML page. affiliate.php (uses the cart.html page template) When a valid referral code is entered, the affiliate is credited for the click and a tracking cookie is set on the visitor's browser. Affiliates & Referals 5.12 265 Referral Form Code There are two ways for customers to enter an affiliate's manual referral code. When affiliate.php is opened without an affiliate ID parameter, the following form opens in the browser. The form page uses the cart.html page template. The manual referral form may also be inserted into an HTML web page. An example of the form is included with distribution of AShop V and is named referralformEXAMPLE.html. Affiliates & Referals 5.14 267 Affiliate Support Panel Affiliate Support Panel The Affiliate Support Panel is where affiliates sign up and login to update their contact information, view stats for clicks and commissions earned, and copy link and banner code to paste into their web sites, ezines, and newsletters. Existing affiliates will login to view/edit their profiles or change their passwords by navigating to the login. php file. For example: http://www.yourdomain.com/ashop/affiliate/login. AShop V User Guide View/Edit Affiliate's Profile The affiliate may view or edit his profile data by clicking on the View/Edit Profile button. The affiliate's contact information will be displayed in text boxes within a form. Sales Office 6 Sales Office 6.1 Introduction 269 See also: Sales Office Configuration , Sales Office Tour The Sales Office operator pages are divided into three main areas. The tool bar on the left side appears in all pages. Messages The Customer Messages page displays new messages, which are fetched from the customer mailbox that is set in Sales Office configuration. If spam blocking is enabled, messages from unknown senders go to the spam bin. AShop V User Guide Vendors Manage Purchase Orders - Create and send purchase orders to vendors. Report purchase orders by status: sent, unshipped, and shipped (but not billed yet). Look up purchase orders in relation to customer order numbers. This area provides a comprehensive way to directly access order and shipment related information from customer or the vendor references. Manage Bills - Report paid and unpaid bills. Sales Office 271 Reminders can be created and deleted by any Sales Office user. Reminders appear for all Sales Office users when logged in. Links can be created and deleted by any Sales Office user. Links open in a new window. They may be to any valid URL. There are two links that cannot be deleted: Product Catalogue opens catalogue.php. Admin Panel only appears when logged in as admin and it opens the AShop admin panel in a new browser. AShop V User Guide Contact Information is the contact information that is set for the shop in the AShop admin panel Configuration > Shop Parameters. This is the same information that appears by default in receipts and in the payment confirmation page. This information is here as reference for Sales Office operators (users). 6.3 Customer Messages The admin user can login through the admin panel or directly to Sales Office. All other users must login to the emerchant directory. Sales Office 273 Open the view message window by clicking on the Subject line. There are also links in the view message window to reply, save or delete the message. When a Reply is sent, the original message and the reply are saved to the customer history. If a customer with that email address already exists, the messages are saved to that customer history. AShop V User Guide To Delete or Save Multiple Messages, click the checkbox to the left of each message to select specific messages or click the checkbox at the top of the column to select all of the messages. Then click on delete or save button at the bottom. Check Mail while logged in by clicking on the Check Mail button in the Messages page. There is also a check mail link on the left in the tool bar, which appears in every Sales Office page. Sales Office 6.4 275 Spam Bin Upon login, mail is fetched from the customer email box, which is set in Sales Office Configuration. If spam blocking is not enabled all customer messages are moved to the customer messages inbox. If the spam blocking is enabled in Sales Office Configuration, then email that is from known senders is moved to the inbox and all other email is moved to the Spam Bin. Click the Save icon/link next to each message in the spam bin to move it to the customer inbox. AShop V User Guide instead of the spam bin. 6.5 Vendor Messages Upon login, mail is fetched from the vendor email box, which is set in Sales Office Configuration. Spam blocking does not apply to the vendor messages. Use the icon/links on the right to process each message or to go directly to the vendor profile or history. Click the From link to open a local email client such as Outlook. Sales Office 277 Create a (Quick) Quote The Quick Quote feature is used to look-up product prices, calculate shipping and taxes, and calculate total amounts. The customer name and address is not necessary for a quick quote. A quick quote can be saved and sent to a valid email address or printed. Quotes can be looked up, related to a customer, and converted into orders or bills through the Unconverted Quotes menu, which is in the Sales Office Tool Bar. AShop V User Guide · Send - the by email, save the quote and create a reference number. · Bill - converts the quote to an unpaid order and sends an invoice with a link to pay online. · Print - the quote, save it and create a reference number. Edit an Existing Quote Previously saved quotes may be looked up by the reference number. A previously saved quick quote can then be edited, processed, and related to a specific customer. Sales Office 279 Find an Existing Customer The alphabetic customer lookup lists customers by last name in ascending order. Find customers by partial or complete spelling of the email address, (first or last) name, or phone number. Find by phone number ignores non-numeric characters and spaces so that the phone number may be entered in any format. AShop V User Guide Merge Customer Profiles Each customer's email address is a unique reference. If a customer has used more than one email address when ordering products or contacting the shop, it is possible for more than one customer profile to exist for the same customer. To merge the customer profiles into one customer profile, find the customer by last name or phone number. Sales Office 281 The billing and shipping addresses in the selected profile are kept and saved. The billing and shipping addresses from the unselected profiles are deleted during the merge. eMail addresses and phone numbers from the unselected profiles are saved in the selected profile under Alternate eMail and Alternate Phone. Add a New Customer Record To add a new customer record, enter the name, email address and billing information. AShop V User Guide must be entered as this is the unique reference for each customer. All of the address text fields must have an entry before the form can be submitted. If some of the information is not known yet, enter "unknown" or a hyphen or any other character and click Save. After the customer contact and billing information is saved, shipping information may be entered and saved with the customer profile. Sales Office 283 The history for each customer includes all messages, notes, quotes, orders, and bills that relate to that customer. Historical listings are linked to the original transaction where applicable. Messages that were received from and sent to the customer appear in the history page with a link to open the message. Message history includes emails that were sent and received through Customer Messages. AShop V User Guide Notes that were saved for the customer appear with the word "Comment" and the subject line of the note, which links to open the note for viewing and editing. When a note is saved, it is datestamped. When it is edited, the datestamp is replaced with the edit datestamp. Sales Office 285 Quotes that were previously sent or saved for the customer appear with the quote number, which links to the original quote to open it for editing or to convert it into an order. See Quotes and Orders. AShop V User Guide Orders that are listed in customer history may have more than one link depending on the type of products that are in each order. · The orderid number links to open the original receipt in a new browser window. Sales Office 287 · A Status link appears when any products in the order are assigned to a vendor. Click the Status link to view the status of related purchase orders. If there is multiple vendor assigned products within one order, the products will be grouped by vendor so that there will be one purchase order for each vendor. AShop V User Guide · An Edit link will appear next to the orderid if the order is unpaid. Unpaid orders are created when payment has not been applied to an order that was paid by a manual payment option. For example when a customer checks out and selects to pay by check and the check has not been received yet. Unpaid orders may also be created in the Sales Office by converting a quote into a payable bill. Click the Edit link to view and edit the bill properties. Sales Office 6.7 289 Quotes and Orders Every customer order begins as a quote, which may then be converted into an order. Quotes may be created, edited, and processed in various ways. Quick Quote The Quick Quote feature is used to look-up product prices, calculate shipping and taxes, and calculate total amounts. The customer name and address is not necessary for a quick quote. A quick quote can be saved and sent to a valid email address or printed. AShop V User Guide Add products and comments to the quote and then process it. Shipping and tax will be automatically calculated and can then be edited manually if desired. Find a Saved Quote Saved quotes may be found in several ways. Sales Office Tool Bar Quotes are listed in chronological order through the Sales Office tool bar Unconverted Quotes. Quotes that are related to a customer are listed with the customer name. Sales Office 291 Search By Quote Number To search for a quote by the quote reference number, click Customers in the top nav bar. Enter the quote number and click Go. Customer History Quotes also appear in each related customer's history. 6.8 Vendors To access the vendor management tools, click on the Vendors link at the top of the page. AShop V User Guide Manage Purchase Orders There are two ways to create purchase orders in the Sales Office. 1. When a customer order is received and the order includes products that are assigned to a vendor or more than one vendor, the products are grouped by vendor and a purchase order is automatically suggested for each vendor. The suggested new purchase orders appear in the Open Orders report. At this point, the POs are not saved yet and they do not have purchase order reference numbers. Sales Office 293 created yet. Open Orders may be reported for all vendors or for a specific vendor. To view open orders for all vendors click Go with All vendors selected (default selection). To view open orders for a specific vendor, first select the vendor, then click Go. How to Void a New Purchase Order New orders that contain vendor products automatically suggest a new purchase order for each vendor in Open Orders. A purchase order cannot be voided until it is sent and saved. AShop V User Guide Set the paid date and click Submit to mark the selected bills as paid. Manage Vendors Select or search for a vendor to view/edit a vendor profile, vendor contacts, vendor history, and related transactions. To add a new vendor, click the Add Vendor button at the bottom of the page. Vendor Contacts may be added for each vendor. Notes and messages from the contact will appear in that contact's history. Sales Office 6.9 295 Bills and Recurring Billing To create a bill and send an invoice, begin by creating a quote and then convert the quote into a bill. When a bill is created an invoice may be emailed to the customer. The invoice will automatically include the order reference number and a link to pay online through the shopping cart checkout/payment pages. AShop V User Guide A bill may be one-time or recurring. If it is recurring, a new bill will be automatically created and emailed to the customer on a schedule, which is set in the edit bill page. Recurring bills may be set to stop after a specific number of billing cycles or they may be set to continue indefinitely. Sales Office 297 The Due Date appears at the bottom of invoices and it is used as a reference for sending reminders, past due messages, and recurring bills. For service from: %startdate% to: %enddate% - These dates are used by the tokens in the Add Comment field (below). The first invoice will use the dates that are set when the bill is first created. If the bill is recurring, the dates will automatically increment for each billing cycle based on the length of the billing cycle. AShop V User Guide automatically sent and also in reminders that are manually sent from Sales Reports (for Unpaid orders in Edit mode). Tokens may be used to include variable content such as dates and order related data. Send Past Due Message (number of days) after due date if not paid - When the box is checked, a past due message will be automatically generated and sent the set number of days after the due date. Past due messages are not sent for bills that have already been paid. Sales Office 299 To run autobill.php automatically on a daily schedule, set up a Cron. Set the Crontab to run every day. If there are other Crons scheduled for the same domain, set this one to run at a different time so that potential conflicts are avoided. Here is an example of a Cron command to run autobill.php. /usr/bin/php -q /home/httpd/vhosts/yourdomain.com/httpdocs/emerchant/autobill. AShop V User Guide Each time autobill.php runs, a report is sent to the Sales Office customer inbox. When the Cron runs, an AutoBill Cron Job Report is sent. When new bills, reminders and past due messages are sent, an AutoBill Activity report is sent to the Sales Office customer inbox. The daily activity reports help to insure that the Cron is running and that the bills are being processed consistently. Shopping Mall 301 ashopadmin. The password for ashopadmin is same as was previously set before the username requirement was activated. Member Shop Directory - Page Template If Individual Member Catalogs is enabled in Shopping Mall Parameters, modify the mall.html page template or create a new one and upload it to the directory where AShop is installed. If Individual Member Catalogs is disabled, skip this step. Administration Panel Images Replace images that appear in the administration panel. AShop V User Guide $adminpanelcolor = "7589e7"; Member Signup Form The member signup form is displayed by navigating to the members directory or to the members/index. php file. For example: http://www.yourdomain.com/ashop/members or http://www.yourdomain/ashop/members/index.php Edit or replace members/application.txt - The content of the members/application.txt file is included at the top of the member signup form page. Shopping Mall 303 selected. Each member may upload a logo image, set fonts, colors, borders and other layout parameters. Each member may add a page header and page footer, which is then included at the top and bottom of catalog, view cart, and check out pages. HTML may be used in the page header and footer to format text, layout tables, and specify page parameters. 7.4 Member Signup New members signup a members/index.php. AShop V User Guide When a member application is submitted, the new applicant sees a confirmation page advising that the application will be reviewed first before the account is activated. The applicant also receives an email confirmation with a similar message and the mall administrator receives an email notice of the application. Activate New Members Each new member account must be activated by the mall administrator. This is done in the admin panel when logged in as ashopadmin. Shopping Mall 305 Click on the exclamation icon to activate the new member. When the member account is activated, a welcome message is emailed to the member with link and password to the member's admin panel. The exclamation icon then becomes a member history icon. Member Login Members login at admin/login.php, same as the mall administrator (ashopadmin). When logged in as a member, the administration panel functionality is limited and the member has only has access to his/her products and information. AShop V User Guide AShop Software © Copyright 2002 - 2010 Index Index -22CheckOut 108 -Aabout AShop Deluxe 8, 163 administration panel 49, 50, 52, 61, 66, 67, 71, 78, 81, 92, 98, 100, 102 advanced options 52 affiliates 249, 252, 253, 255, 257, 258, 259, 263, 265, 267 agreement 35, 169, 204 AShop Deluxe free trial 10 AShop Deluxe license agreement 9 AShop Software affiliate program 69 attributes 222, 226 Authorize.net 109, 111, 112, 173, 174 Authorize. AShop V User Guide Invalid Credit Card - Authorize. Index setup shopping cart 11, 17, 24, 30, 35, 36, 37, 38, 40, 48, 49, 50, 52, 61, 66, 67, 71, 78, 81, 92, 98, 104, 170, 171, 179, 209, 210, 213, 218, 220, 249, 252 shipping 90, 92, 102, 213, 218, 220 Shipping & Taxes menu 90, 92, 100, 102 shop parameters 52, 61, 66, 67 Shop Parameters menu 52, 61, 66, 67, 136 shopping cart mode 61 spam blocker 275 store configuration 49, 50, 52, 61, 66, 67, 71, 78, 81, 92, 98, 100, 102, 249, 252 Store Configuration menu 92, 98, 100 subscription products 48, 153, 154, 209, |