osCmax Documentation Wiki

2checkout

Tue, 27 Oct 2009 10:23:14 -0700

Enable this module to accept payments using 2CheckOut. Learn more about this payment method at the 2CheckOut web site. Below are the configuration options for this module: Configuration * Enable 2CheckOut Module :: Set to 'True' to enable. * Login/Store Number :: Login/Store Number used for the 2CheckOut service * Transaction Mode :: Transaction mode used for the 2Checkout service. This can be set to Test or Production. To run in Test mode you must also login to your store configuration,…

account_setup_email

Tue, 10 Nov 2009 10:00:03 -0700

STEP 1: Run this SQL using phpMyAdmin STEP 2: Open catalog/create_account.php Find: Add After it: STEP 3: Open catalog/includes/languages/english/create_account.php Add before the ?> at the end

accounts

Tue, 27 Oct 2009 14:15:46 -0700

* Purchase Without Account :: Set to true if you want customers to be able to check out without setting up an account.

activate_ssl

Tue, 29 Mar 2011 01:25:41 -0700

This describes the fundamentals of how to get SSL working in osCMax and doesn't address the initial setup of SSL on your webserver. Refer to your hosting provider, to install the SSL certificate on your server. Preamble SSL (a.k.a. https:) is an additional protocol that will produce an unnecessary overhead if activated for your whole website. It should be activated only for areas where sensitive information is gathered. Any references that point to non-https pages may result in a partial secu…

adapting_an_ms2_site_template_to_oscmax

Fri, 30 Oct 2009 09:23:26 -0700

Ok, So you have a stock osCommerce ms2 template. You have the header.php and footer.php files and the index.php file in ms2. These make up the site structure. You also have a stlyesheet.css file which handles background graphics and fonts and colors.

adding_a_new_infobox_-_version_2.0.2_onwards

Thu, 11 Feb 2010 17:37:37 -0700

Using a PayPal Accepted box as an example. Create a new file, based on an existing InfoBox, in catalog/include/boxes. Note: In this example, you would need to supply the image file to display in the box. catalog/includes/payment_methods.php Login to Admin.; InfoBox Admin; New Infobox

adding_new_dynamic_content_pages

Fri, 23 Apr 2010 02:38:04 -0700

Adding New Dynamic Content Pages I haven't got round to fully testing this yet but I believe it works! Quite alot of files require modifying, remember to backup your files first!! This guide has been made for use with osCMax V2.0 or higher. Credit to author mhouchin.

adding_new_side_boxes

Fri, 30 Oct 2009 09:55:56 -0700

* We will now look into adding our own custom boxes, as well as adding/changing links, pages and graphics to boxes. * In addition, we will learn how to add items to the columns, outside of the actual boxes. * All of these modifications are fairly easy to perform, but they are not entirely intuitive (understatement!).

adding_new_static_content_pages

Fri, 30 Oct 2009 11:14:25 -0700

Source: oscmax.com - Thanks to michael_s There are four main steps to adding your own custom static content pages to osCMax. Follow the tutorial below to create a static page. Step 1: Copy shipping.php * First, copy the shipping.php file in your main catalog directory.

administration_manual

Sat, 24 Oct 2009 01:22:22 -0700

This section details the osCommerce administration script. Each section and its functions are detailed here. * Configuration :: This section details the main configuration settings of osCommerce * Catalog :: This section covers how to administer the catalog, set up categories, products and attributes * Modules :: This section covers any addon modules, and particularly the standard payment and shipping modules bundled with osCommerce * Customers :: This section is where you view and …

administrator

Tue, 02 Mar 2010 04:12:19 -0700

* Member Groups :: Setup different user groups who can access different parts of admin. * Files Access :: Set which files are available in the admin menu and who can access them.

administrators_manual

Tue, 23 Feb 2010 02:43:30 -0700

This section details the osCMax administration script. Each section and its functions are detailed here. * Administrator :: This is the section for setting up user groups and setting file permissions. * Configuration :: This section details the main configuration settings of osCommerce * Catalog :: This section covers how to administer the catalog, set up categories, products and attributes * Modules :: This section covers any addon modules, and particularly the standard payment an…

affiliate_program

Mon, 09 Jan 2012 04:03:50 -0700

* Email Address :: The email address that the affiliate program will use. * Affiliate Pay Per Sale Payment % Rate :: % rate paid on affiliate sales * Payment Threshold :: The minimum amount at which you will send a payment to an affiliate * Cookie Lifetime :: How long does the click count (seconds) if customer comes back * Billing Time :: Age of affiliate sales before becoming payable * Order Min Status :: Status of an order needed for a sale to deemed payable to affiliate. * Pay Af…

affiliates

Mon, 26 Oct 2009 10:12:11 -0700

Affiliates Control the setup, management, payment of affiliates. * Summary :: Overview of your affiliate network * Affliates :: List of registered affiliates * Payment :: * Affiliate Sales :: * Clicks :: Details of click throughs to your site * Banners :: * News :: * Newsletter Manager :: * Contact :: Send Email to Affiliates

article_manager

Mon, 26 Oct 2009 09:31:24 -0700

* Topics & Articles :: for adding topics and associated articles (like Categories and Products) * Configuration :: a wide range of options for controlling how and when Articles appear * Authors :: Enter your article authors, including a description and maybe a photo (optional) * Reviews :: This is where you approve Article Reviews before they are visible on the site * Cross-Sell Articles :: Select from a list of products and associate them with your articles

articles_configuration

Mon, 26 Oct 2009 08:59:05 -0700

* Display New Articles Link :: default(false) * Number of Days Display New Articles :: default(30) * Maximum New Articles Per Page :: default(10) * Display All Articles Link :: default(true) * Maximum Articles Per Page :: default(10) * Maximum Display Upcoming Articles :: default(5) * Enable Article Reviews :: default(true) * Enable Tell a Friend About Article :: default(true) * Minimum Number Cross-Sell Products :: default(1) * Maximum Number Cross-Sell Prod…

authorize.net

Tue, 27 Oct 2009 10:15:42 -0700

This module allows you to use Authorize.Net as your payment gateway for real-time credit card processing in osCommerce. The following options must be filled out properly in order for this module to work. Configuration * Do you want to accept Authorize.net payments? :: Set this option to 'True' * Login Username :: Your Authorize.net username * Transaction Key :: The transaction key you set in Authorize.net admin. * Transaction Mode :: Set this to 'Test' or 'Production' depending on wh…

automatic_template_switch

Mon, 15 Nov 2010 09:19:10 -0700

* One of the most powerful features of BTS in osCMax is the ability to switch the template through the URL. * Go to your Admin Panel –> Configuration –> My Store –> Template Switching Allowed and set the to true * You can then simply switch template by appending ?tplDir=aabox to your index page. * Eg. www.yourstore.com/index.php?tplDir=aabox. * (Replace aabox with your template name eg. fallback, CSS-fluid-1 etc.)

backup_your_store

Thu, 30 Sep 2010 10:45:40 -0700

* This is an essential part of the day to day management of any e-commerce site. You should ensure that you make regular backups of your store to prevent accidental data loss or loss from hackers. * Luckily osCMax has a very useful SQL backup tool which will create a copy of your online database and allow you to download this to your local machine.

banners

Fri, 02 Apr 2010 01:58:25 -0700

This will provide you with a set of four banner positions: * top * middle * footer * bottom In Banner Manner, use the above for the Group names. the 'top' banner will appear before your centre column information. The 'middle' banner will float up and down, in relation to your centre column information (appearing at the bottom of it). 'footer' appears on the standard date and number of requests position. 'bottom' appears, guess where..

boxes

Tue, 29 Jan 2008 22:45:04 -0700

This section deals with any modifications, hacks and procedures that apply to the many different side boxes. If you have something you would like to contribute, please do so. Before making a contribution, please read osCDox's Copyright Terms * Boxes General Topics :: General topics that apply to all boxes * Bestsellers Box * Categories Box * Currencies Box * Information Box * Languages Box * Manufactureres Box * Manufacturer Info Box * New Products Box * Notificati…

boxes_general_topics

Tue, 29 Jan 2008 22:46:00 -0700

These changes apply to all boxes in general, and will have an effect on all the boxes in your site. If you have an addition that you would like to make to this section, please do so. Your additions are welcome. * Add an Image to the Heading * Add Search and Manufacturerers to Any Page * Different Colors for Each Box * Change Box Corner Graphics * Change Text and Stlye Links * Remove Info Box Title * Adding Links to Exernal Sites

bts_docs

Tue, 03 Nov 2009 05:56:25 -0700

Part 1 : BTS Structure All template files are located in the /catalog/templates/[templatename] subdirectories. If you are using the aabox template, the files you want are in /catalog/templates/aabox and /catalog/templates/aabox/content. * To change the entire look of your site, edit main_page.tpl.php to your liking in any html or text editor (Dreamweaver is great), making sure to keep the php elements intact (but you can move them wherever you want in the page). Also edit stylesheet.css, lo…

cache

Sun, 25 Oct 2009 10:08:44 -0700

Cache osCommerce has built it page cacheing that can be used to significantly lower server load and increase the speed of the cart when used. If you make changes to your site, you will have to delete the cache in order to see the changes. Settings * Use Cache :: Set this to 'True' to enable cacheing. * Cache Directory :: Set the path to the cache directory. The directory you set must be writable.

canned_comments

Sun, 01 Nov 2009 14:06:13 -0700

What is does * Puts a drop down list under the comments box which allows the admin user to select a pre-written comment so that they do not have to keep typing the same comments each time. * Has admin function to create, edit and delete comments. * Allows addition of multiple comments by select more than once from drop down

cash_on_delivery

Tue, 27 Oct 2009 10:17:24 -0700

This is the basic COD payment module if you want to use this type of payment option. This is also good for testing your store. Configuration options are below: Configuration * Enable Cash On Delivery Module :: Set to 'True' to enable. * Payment Zone :: Allows you to limit the use of this module to a single zone. * Set Order Status :: You can set the default order status to the store default, or set it to one of these: Delivered, Pending, Processing * Sort order of display :: This is wh…

catalog

Tue, 09 Feb 2010 15:55:42 -0700

The Catalog section of the administration is where you control your categories, products and product attributes. This section is very powerful and gives you a great deal of flexibility when creating and managing your inventory. Categories/Products This is where you add your categories and products to the catalog. There are several things you can do, but first, you need to create a category. In the middle window of the page, you will see a folder listing. Each folder is a category. These folder…

changing_default_country_in_signup_page

Fri, 28 Dec 2007 21:51:38 -0700

Change the Default Country on the Signup Form This method allows you to select the country, but changes the default to the United States. This only affects create_account.php and not the address_book_process.php, checkout_payment_address.php, checkout_shipping_address.php and .

changing_main_page_text

Sat, 02 Jan 2010 04:04:01 -0700

Changing the main page center content This is very easy in osCMax. * Login to your osCMax admin panel. * Click on Catalog * Click on Define MainPage * In the editor, create your main page content. * Save it. It is instantly displayed live on your site.

changing_popup_image_titlebar_text

Fri, 28 Dec 2007 22:18:50 -0700

To change the title bar of the popup image, edit /catalog/includes/meta_tags.php. Find the following code and edit to your liking:

changing_product_attributes_sort_order

Fri, 28 Dec 2007 21:54:36 -0700

Sort Product Options (attributes) Option 1 What it does... First - sorts by price Second - if price is same (or 0), it sorts based on the order that the option was entered. File to change ... /catalog/product_info.php Replace this line: With this line:

changing_style_of_date_to_english_formatted

Thu, 10 Apr 2008 20:25:10 -0700

This will change the style of date from DDMMYYYY to MMDDYYYY The date formats are defined in /catalog/includes/languages/english.php Open english.php for editing and search for : DOB_FORMAT_STRING, JS_DOB, ENTRY_DATE_OF_BIRTH_ERROR, DATE_FORMAT_SHORT, DATE_FORMAT_LONG, DATE_FORMAT

changing_the_default_admin_login_and_password

Mon, 26 Oct 2009 02:04:36 -0700

Changing the default admin login and password To change the login credentials for the administrator account in osCMax, do the following: * Login to the osCMax administration panel. * Click the My Account link. * Click the Edit button in the right column. * Enter the password admin in the password box and click Confirm. * Change the First Name and Last Name to your name. * Change the Email address to your real email address. * Change the Password to your new password. Enter it i…

changing_the_page_footer

Mon, 26 Oct 2009 06:17:13 -0700

In osCMax, the footer.php file is no longer used for anything. The page that controls the html for the footer is main_page.tpl.php in the directory of the template you are using. For example: * If using the aabox template, the path is /catalog/templates/aabox/main_page.tpl.php.

changing_the_titlebar

Mon, 02 Nov 2009 07:24:38 -0700

The information is in /catalog/includes/languages/english.php file on the default install. You may have to replace “catalog” with whatever directory you have your store installed in. Change : To : See Also: Custom Meta Tags

changing_your_header_logo

Sat, 30 Oct 2010 08:53:34 -0700

Changing the header logo This really depends on the template you are using, but generally, you can change the logo graphic by editing the main_page.tpl.php file in whatever template's directory you are using. For example, in the default osCmax fallback template, depending on the version you want to find the below lines and then change the image name to your custom image name.

check_permissions

Sun, 25 Oct 2009 11:29:14 -0700

Check Permissions What is does * Checks all your files to see if they are set correctly. * Checks you have renamed Admin folder * Checks you have a backup folder * Checks you have removed the install folder Screenshots Download Download here

column_widths

Wed, 28 Jul 2010 02:34:13 -0700

This is for versions of osCMax prior to 2.1 It is assumed that you have done the correct thing and created a new directory structure for your own template. Edit catalog/templates/yourtemplate/mainpage.tpl.php as follows: Just after the tag - adjust widths to suit your template.

configuration

Wed, 10 Feb 2010 04:08:22 -0700

* My Store * Minimum Values * Maximum Values * Images * Customer Details * Shipping & Packing * Product Listing * Product Information * Stock * Logging * Cache - osCMax users should look at Page Cache Settings * Email Options * Download * GZip Compression * Sessions * WYSIWYG Editor * Site Maintenance * Page Cache Settings * Wish List Settings * Printable Catalog * Dynamic Mopics * Affiliate Program * Recover Cart Sales * SEO Urls * Order Edit…

contribute

Tue, 02 Mar 2010 05:27:24 -0700

* This guide uses a Wiki application and is open for you to contribute your ideas easily and quickly. * Anyone registered at osCDox is free to contribute their ideas and improvements by editing any unlocked page or creating new pages and links.

contributions

Fri, 01 Jan 2010 09:35:54 -0700

There are many contributions for MS2 that can be found at osCommerce. Since osCMax uses the BTS template system, small modifications need to be made to most contributions that add changes to the catalog/shopping cart end of osCMax. Once the small changes have been made, almost all contributions will work perfectly in osCMax. This page details how to install various contributions into osCMax, and details the changes in the install instructions.

converting_osc_template

Wed, 20 Oct 2010 10:37:10 -0700

* Converting a Template can be quite a long process to complete but below is a tutorial written by Paul Mathot a key contributor to the BTS system which should help you out. * Be warned this is a long process and unless you desperately want to keep the exact same template I would strongly recommend you start with the aabox template and redesign to fit your needs. These instructions are old and may not work - I really would recommend that you start with a osCMax template rather than converti…

copyright_terms

Fri, 28 Dec 2007 20:38:32 -0700

All submissions made to this site are placed under the copyright of osCDox and become the sole property of osCDox. All documentation contained herein is intended for osCDox and its users and may not be reproduced in any medium, electronic or otherwise, in part or in its entirety, without the express written consent of osCDox .

countries

Wed, 10 Feb 2010 04:03:54 -0700

Inserting New Countries * Allows you to define new countries and to assign the correct two and three digit ISO country codes which are used for the different postage modules. eg. UPS, Fedex, etc. * Click New Country * Enter the Country Name * Enter the two digit ISO code - find a full list here * Enter the three digit ISO code - find a full list here * Click Insert

create_order

Tue, 27 Oct 2009 13:43:36 -0700

* Select the customer from the drop down list or enter the customer id * Click Confirm * Confirm that you have the correct client click confirm * Fill in the order details Seperate Pricing Per CustomerMaster Password

create_your_own_set_of_buttons

Tue, 09 Mar 2010 08:00:05 -0700

There are quite a lot of image buttons used within osCMax both in the catalog and the admin section. If you want to customise the look and feel of your site then this is a good way to start. Luckily, there a few sites out there where most of the hard work has been done for you.

credit_card

Tue, 05 Jul 2011 13:57:44 -0700

This is the basic offline credit card processor included in osCommerce. TESTING ONLY If you are using the Authorize.Net module, disable this module. There are several other options for offline credit card processing that use GPG or PGP encryption that can be found HERE. Those should be used instead.

currencies

Mon, 02 Nov 2009 03:30:34 -0700

* This page allows you to create new currencies to be used in your store. * The image below shows a basic set of US$ currency. Auto update exchange rates * If you click the update currencies button osCMax will contact oanda and then xe.com to try and update the exchange rates used in your store.

custom_http_error

Mon, 02 Nov 2009 09:51:17 -0700

* This module will allow you to receive emails of missing pages and will also store them in a text log. * It will also display the advanced search to allow the user to find what they are looking for on your site. Screen Shots Download Download - Click on download.

custom_meta_tags

Thu, 10 Apr 2008 21:07:08 -0700

How to edit the dynamic meta tags in osCMax The file you edit is: /catalog/includes/meta_tags.php Add Custom Keywords The code you are concerned with is : Enter your custom keywords between the single quotes, comma separated, like this: Add Custom Text Next, to add your own custom text, you can add it to this section:

custom_per_page_style_sheets

Fri, 30 Oct 2009 07:17:35 -0700

but should be This is how you do it: * In whatever template you are using, simply create a new directory called style sheets * In this new directory, add your new stylesheet with a filname in this format: * pagefilename.css * Replace pagefilename with whatever filename you want the new stlyes to load for. * So for example, I want a custom stylesheet to load for create_account.php, I simply need to make a new stylesheet in my /templates//stylesheets directory cal…

custom_per_page_templates

Fri, 30 Oct 2009 10:22:43 -0700

Source: osCMax Docs - Thanks to michael_s * If you wanted to, each page on your site could have its own look, completely different from the others. There are several ways to do this, and I will explore each, but this seems to be the simplest way to do it.

customer

Wed, 04 Nov 2009 03:08:40 -0700

This page allows you to edit, delete, view orders or email your customers. Edit * This will open a page where you can change the details entered by the client during setup such as email address, name, etc. * You can also change the Customers Groups for the individual customer here.

customer_details

Sun, 25 Oct 2009 09:34:16 -0700

Customer Details This section allows you to enable or disable fields used in the new customer signup page. You can control only the fields below from the admin. Settings * Gender :: * Date of Birth :: * Company :: * Suburb :: * State ::

customers

Wed, 10 Feb 2010 04:05:53 -0700

The Customers section of the administration is where you manage your Customers and Orders. Customers This is where you view your Customers and your Customers' Orders. * Customers * Customers Groups * Create Account * Create Order * Orders :: View your current order queue. * Export Customers Orders :: Optional Install

customers_groups

Wed, 04 Nov 2009 02:53:11 -0700

* This allows you to set up a new customer group who can have a different price to other customers. For example, Wholesale and Retail or Show Prices and Hide Prices. Set up a new group * Click Insert * Enter a Group Name eg. Wholesale

database_backup

Mon, 29 Mar 2010 08:53:48 -0700

* This tool allows you to backup your store database into a SQL file which can then be used to restore your store if you run into any problems. * This is also very useful if you ever need to migrate from one host to another. Backup * Click Backup * Select from the right hand menu if you want to use GZip compression by clicking on the radio button. * Click the tick box Download only if you want to only store the file locally (ie. not on the web server) * Click Backup

discount_coupon_settings

Wed, 29 Jun 2011 18:55:43 -0700

* If you want to edit the setting of the Gift Voucher setup please go to Modules --> Order Total --> Discount Coupon --> Click Edit in the right hand column. Display Total * Always leave set to true. Sort Order * This needs to be set according to how you want tax and your discount to be calculated. You will also need to change the sort order of the other order total modules.

display_customer_tax_id

Tue, 22 Nov 2011 07:00:22 -0700

The intention of this modification is to show the Customer (Company) tax number on invoices. The method used isn't ideal (in that Company name is used instead of ID) but should work fine, unless you happen to get two Companies with identical names. Note that often the same Company uses some means to differentiate themselves. Example: This Company (UK) Ltd and This Company (NZ) Ltd.

download

Fri, 30 Oct 2009 01:22:32 -0700

Download This section controls the 'Product Download' options of osCommerce. If you sell downloadable products, this is where you configure how osCommerce handles the process. Settings * Enable download :: Enable the products download functions. * Download by redirect :: Use browser redirection for download. Disable on non-Unix systems. * Expiry delay (days) :: Set number of days before the download link expires. 0 means no limit. * Maximum number of downloads :: Set the max…

dynamic_mopics

Wed, 24 Aug 2011 14:57:36 -0700

A section that causes some confusion in osCMax although once you get it you will understand its power! Basic Settings * You should see the following if you go to Admin --> Configuration --> Dynamic Mopics (Screenshot is from 2.0.25 and there are now some additional options, images/products for mid-size (main product) images, for example.)

easypopulate

Mon, 23 Aug 2010 02:08:29 -0700

What is EasyPopulate EasyPopulate 2.76g is a very powerful tool for uploading or updating large quantities of data about your products. (It does not have the functionality to look at anything outside of the products tables.) * All the data is imported and exported through Tab-Delimited Text Files which can be easily edited using a spreadsheet. (Try the free Open Office software if you do not have MS Office) * You will need to remember to either preserve the formatting of the download w…

email_options

Wed, 20 Jan 2010 06:33:56 -0700

E-Mail Options This section is where you set how osCommerce handles email. If your email is not working correctly, make sure these settings are correctly configured. * Admin --> Configuration --> Email Options Settings * E-Mail Transport Method :: Defines if your server uses a local connection to sendmail or uses an SMTP connection via TCP/IP. Servers running on Windows and MacOS should change this setting to SMTP. * E-Mail Linefeeds :: The character sequence used to separate mail …

enable_javascript

Mon, 26 Oct 2009 06:11:25 -0700

Not everyone who browses the internet has JavaScript enabled - some because they have their browsers set up incorrectly other because they have actively decided to turn it off to protect themselves from hackers. Quite a lot of extra modules use jQuery, MooTools or plain old JavaScript to power additional functionality within the store. Obviously, it is best to degrade seamlessly from the JavaScript version back to plain old HTML.

ep_column_headers

Tue, 27 Oct 2009 05:11:55 -0700

* v_products_model :: This is the model number of the product. v_products_modelUNIQUEalphanumeric * v_products_name_1 :: This is the name of the product. It must be 64 characters or less. * v_products_description_1 :: This is the description of your product. This field can include basic HTML tags * v_products_url_1 :: The external link url for your product. Note: do include the url prefix. * v_products_image :: This is the filename of the main image. Also, if your images are in a …

error_pages

Mon, 02 Nov 2009 09:24:30 -0700

* You basically have two options here * Create a simple page to apologise to the user and redirect them to your homepage * Install the Custom HTTP Error Module which will email you and store information about the error in a log Simple Apology Page * Edit your .htaccess in the catalog folder and add this right at the top:

faq

Wed, 17 Aug 2011 13:20:49 -0700

Frequently Asked Questions Remember to search the osCMax forums carefully ... it is more than likely that your question has already been answered. However, here are a few of the more regular queries. Q. Why does osCMax keep skipping the shipping page?

faq_manager

Sun, 01 Nov 2009 15:05:12 -0700

What does it do This mod allows you to manage and create answers to the most common questions your shoppers call your / email you about. Open the FAQ Manager * Click Insert * Set the status of the question to on or off * Enter the quesion in the top box * Enter the answer in the bottom box * Click Insert again.

fedex

Tue, 02 Mar 2010 04:59:34 -0700

* If you want to use FedEx then install this module. * Enable Fedex Shipping :: Allows you to enable/disable module without uninstalling * Your Fedex Account Number :: Fedex account number * Your Fedex Meter ID :: Fedex Meter ID * cURL Path :: Path to your cURL * Debug Mode :: Debug Fedex Shipping module if you are having problems. * Weight Units :: Define package weights eg. LBS, KGS * Which server to use :: production or test server use * First line of street address :: * S…

file_manager

Wed, 04 Nov 2009 07:49:34 -0700

files_access

Mon, 06 Sep 2010 03:54:57 -0700

Enable access to the file To add access to a new php file in the administrator menu you need to enable file access * Open your admin panel * Click on the Administrator Menu box * Click File Access in Menu box * Select the relevant Menu Box row in the central box ie. the one you want to add the file to * Click Store Files in right hand column * Select .php from the drop down * Click Save

flat_rate

Tue, 02 Mar 2010 05:00:57 -0700

Use this module if you want to use a flat rate shippng rate per order. The following configuration options must be set: * Enable Flat Shipping :: Set this to true to enable this module. * Shipping Cost :: Set the rate you want to charge per order. * Tax Class :: Set this to the tax class you want to use for this shipping method, or leave it set to none if you do not want to tax the shipping charge. * Shipping Zone :: If you set this to a zone, this method will only be available to orde…

forcessl

Sun, 01 Nov 2009 08:33:06 -0700

Force SSL Logins In order to maintain PCI compliance, your login.php page cannot allow un-encrypted logins. Currently, even if you have SSL installed on your domain, if someone manually enters in a non-ssl url like: They will be allowed to login without encryption, which is a bad thing.

free_shipping

Sat, 14 May 2011 10:31:19 -0700

* Install this module if you do not want to charge for shipping. * Enable Free Shipping :: * Free Shipping Cost :: * Tax Class :: * Shipping Zone :: * Sort Order :: Admin -> Modules -> Order Totals -> Shipping

general_installation_guidelines

Sun, 14 Feb 2010 03:05:24 -0700

These guidelines are not steadfast, but they are a general guideline to installing a contribution into osCMax. This should save you some time in learning where things are located in osCMax, and also give you some hints on the best way to add code. You will need a text editor to edit the files, a FTP program to transfer your files and a basic understanding of SQL. (Have a look at our useful software page). You may also need to edit the database directly using phpMyAdmin (or similar)

getting_started

Mon, 30 Nov 2009 14:47:36 -0700

* Even if you have used osCommerce before there is still a reasonably steep learning curve for osCMax - once you get going things will be clear! * All the code that handles how osCMax looks has been moved out of the core code, and into various files in the /catalog/templates and /catalog/templates/content directories.

gift_voucher_settings

Thu, 17 Jun 2010 06:51:06 -0700

* If you want to edit the setting of the Gift Voucher setup please go to Modules --> Order Total --> Gift Vouchers --> Click Edit in the right hand column. Display Total * Always leave set to true. Sort Order * This needs to be set according to how you want tax to be calculated. You will also need to change the sort order of the other order total modules. Depening on whether or not you want to charge tax on sales of Gift Vouchers:

gift_voucher_setup

Fri, 24 Jun 2011 16:09:59 -0700

* Before you start using Vouchers and Coupons it is important to realise that there are several different areas where you can use this module: * Selling Gift Vouchers through your store * Sending Gift Vouchers or Discount Coupons to your customers to encourage sales * Sending Gift Vouchers or Discount Coupons to your customers when they open an account

google_analytics

Fri, 01 Oct 2010 12:01:15 -0700

* Google Analytics is an amazingly powerful tool for monitoring your website traffic - and best of all it is free! Screen Shots Installation Step 1: Upload your files * create a new directory analytics in catalog/includes/modules/ * copy this file catalog/includes/modules/analytics.php from this zip file into the directory. *

gzip_compression

Sun, 25 Oct 2009 10:13:50 -0700

GZip Compression If the server you are on supports GZip compression, you can enable this option to significantly reduce your bandwidth requirements. GZip compression compresses php output server side, prior to sending to the visitor. Settings * Enable GZip Compression :: This turns GZip compression on or off. * Compression Level :: This sets the level of compression that is used. The higher the number, more compression and slower output. The range is from 0 to 9.

how-to_section

Tue, 02 Mar 2010 05:21:08 -0700

In this section, you will find many individual procedures to modify specific things in osCommerce. This section contains many of the most common modifications, fixes, procedures. If you see something that is missing, please feel free to add it. All additions are live, and will be included in the guide immediately! Share your knowledge.

how_to

Fri, 06 Aug 2010 02:06:18 -0700

In this section you will find help on how to do common changes to osCMax. * Install osCMax on your local machine * Install osCMax on a web server * Backup your store * Move your store to a new host Customising your store * Getting Started :: Start here to get the basics sorted out.

how_to_remove_the_model_number_and_price_from_the_page_title

Fri, 28 Dec 2007 22:02:00 -0700

How to edit the dynamic meta tags in osCMax The file you edit is: /catalog/includes/meta_tags.php The code you are concerned with is : I have emphasized in bold the line to add your specific keywords. Enter them between the single quotes, comma separated, like this:

image_manager

Wed, 28 Oct 2009 19:00:55 -0700

What does it do Image manager is a simple install which allows the admin user to view information about the image file as well as upload, edit, rename and preview images. It allows uploading of up to 10 images at once and should provide an alternative to people having to use FTP software.

images

Fri, 09 Dec 2011 01:02:40 -0700

Images This section is important for setting your image sizes. This is an area that seems to cause many headaches for people. Some things to note about images: If you set only one of the dimensions, either width or height, the other will fall proportionally if you also have calculate image size set to On. These settings do not Resample the images, so no matter what size they are set to, they will consume the full sized image bandwidth.

individual_shipping

Tue, 02 Mar 2010 05:14:34 -0700

* Enable Individual Shipping Prices :: * Tax Class :: * Shipping Zone :: * Sort Order ::

infobox_admin

Mon, 23 Nov 2009 03:52:05 -0700

* This menu function controls which infoboxes will appear within your store's template. * Use the red and green buttons to turn on and off the infobox. * You can easily switch them from left column to right column by click on the blue and yellow arrows. Or select the relevant box and click Edit then type which column you want it to appear in. * Change the sort order in which they appear by clicking Edit and changing the number. The higher the number the lower down the screen the infobo…

install_a_new_template

Fri, 06 Nov 2009 10:40:59 -0700

* Please note that michael_s has released a new template system using an HTML format - if you want to investigate this approach please read the file here. * When designing your store you can either purchase a template or create your own. * The template system in osCMax is designed to as simple as possible - however, it does still cause people quite a lot of problems.

installation

Sat, 26 Nov 2011 12:52:55 -0700

Upgrading from a previous version of osCMax * Upgrades - See this page to upgrade an existing site Installing osCMax v2.0.4, 2.0.15 and v2.0.25 Installation is no different than installing stock osCommerce MS2. It is a simple matter up uploading, unzipping, or un-taring the osCommerce archive on your server, moving the files where you want them, and running the installation script.

installing_contributions

Fri, 28 Dec 2007 22:25:12 -0700

There are many contributions for MS2 that can be found at . Since osCMax uses the BTS template system, small modifications need to be made to most contributions that add changes to the catalog/shopping cart end of osCMax. Once the small changes have been made, almost all contributions will work perfectly in osCMax. This page details how to install various contributions into osCMax, and details the changes in the install instructions.

installing_via_cpanel

Tue, 03 Aug 2010 11:04:48 -0700

* Download osCMax to your local machine * Zip/Compress the catalog directory (use tar.bz2 for a small file size) * Login to cPanel * Use mySQL Databases (or the Wizard) to setup a database and user for osCMax (keep a note of these values) * Use File Manager to upload the compressed catalog, then right-click, Expand * Begin the install process, using

installing_via_ftp

Wed, 29 Sep 2010 11:23:14 -0700

Upload the /catalog and sub-directories to your server. The files and directory structure must be uploaded to your web server. This can accomplished in several different ways. Use whatever method is most familiar to you, i.e., unzipping the zip archive to your local computer and using your favorite FTP program to upload those files, or using SSH to tar/unzip on your server to avoid the tedium of downloading and re-uploading.

installing_via_ssh

Sat, 13 Feb 2010 06:17:07 -0700

This section details how to install osCommerce using your SSH client. This is an advanced technique and requires that you fully understand what you are doing. If you are comfortable working from the Linux command line, this is a breeze, and you can have a fully functional osCommerce installation in about 15 minutes. This is the fastest method to install osCommerce if you know what you are doing. If you do not know how to use SSH, I recommend using the standard FTP installation method, unless you…

introduction

Thu, 23 Sep 2010 09:13:16 -0700

osCMax v2.0 is a powerful e-commerce/shopping cart web application. There are many advantages to using osCMax as your e-commerce/shopping cart for your web site. It has all the features needed to run a successful internet store and can be customized to whatever configuration you need.

ipayment

Tue, 27 Oct 2009 10:18:32 -0700

This module allows osCommerce to connect to iPayment to process orders. Configuration * Enable iPayment Module :: Set this option to 'True' * Account Number :: Your iPayment account number * User ID :: Your iPayment user ID * User Password :: Your iPayment password. * Transaction Currency :: Set this to the currency you will be using. There are 4 options and you must pick one: * Always EUR * Always USD * Either EUR or USD, else EUR * Either EUR or USD, else USD

linux_local_installation

Thu, 27 Jan 2011 11:48:04 -0700

What do you need In order to install osCmax on to a local machine (ie. the one you are using now, or on the same network) you will need some additional software. Luckily there is lot of free software to do this. * Linux * Apache * MySQL * PHP

local_installation

Sat, 15 Jan 2011 15:46:53 -0700

What do you need In order to install osCMax on to a local machine (ie. the one you are using now!) you will need some additional software. Luckily there is lot of free software to do this. * Windows * Apache * MySQL * PHP Or more succinctly WAMP.

localization

Wed, 21 Apr 2010 08:29:48 -0700

Localization Define Currencies, Languages and Order Status. * Currencies :: Create or edit store currencies * Languages :: Create and manage languages used by your store. * Order Status :: Create or edit the available status for orders during a client's checkout process. Eg. Pending, PayPal Pending, Delivered, etc.

locations_taxes

Fri, 01 Jan 2010 07:39:39 -0700

Locations & Taxes This section allows you to set up zones within countries and the associated tax classes for different products from your store. * Countries :: Defines every countrys ISO-3166 2-letter and 3-letter country code. Also defines the structure of the address for postage. * Zones :: Defines the states/counties of a particular country. * Tax Zones :: Defines a zone for tax purposes. * Tax Classes :: Defines different tax classes for products. Eg. Taxable, Tax-Free, VAT exemp…

logging

Sun, 25 Oct 2009 10:06:44 -0700

Logging This section allows you to set several logging options in oscommerce that are handy for debugging and tracking. Settings * Store Page Parse Time :: Store the time it takes to parse a page. * Log Destination :: Directory and filename of the page parse time log. * Log Date Format :: The date format in the log. * Display The Page Parse Time :: Display the page parse time (store page parse time must be enabled). * Store Database Queries :: Store the database queries …

main_page.tpl.php

Fri, 06 Nov 2009 11:01:10 -0700

* This document is the main control of the entire structure of your site. * It is basically an HTML table wireframe into which all of the content of the site is loaded. * header * left_navigation * content * right_navigation * footer

master_password

Tue, 27 Oct 2009 14:07:31 -0700

Master Password What is does * Allows you to login as a customer * You can then process orders * Update client details * Complete an uncompleted order Download Master Password Install Instructions

maximum_values

Tue, 03 Nov 2009 06:16:01 -0700

Maximum Values This section sets many default maximums used by oscommerce. Each is described in the admin section, but we have also listed the descriptions here. Settings * Max Wish List :: Set how many wish list items to show per page on the main wishlist.php file * Max Wish List Box :: Set how many wish list items to display in the infobox before it changes to a counter * Address Book Entries :: Maximum address book entries a customer is allowed to have * Search Results ::…

member_groups

Tue, 02 Mar 2010 04:28:17 -0700

* Allows you to create and manage the different users of your admin panel Create a New Group * The multi level admin access built into osCMax allows for you to control which parts of the admin panel different levels of user can access. For example, you could restrict access to backup tool to only Top Level Administrators.

minimum_values

Fri, 16 Jul 2010 13:10:15 -0700

Minimum Values This section sets some key values needed to properly configure your store. These options all set the field size or value used by oscommerce in different areas. These options are mainly for customer information and validation on signup. These values come pre-set, but you can change them to customize the function of your store.

modules

Sun, 25 Oct 2009 08:53:01 -0700

Modules osCommerce comes standard with several payment and shipping modules. This section of the administration tool allows you to enable, disable, and configure your modules. This is where you select what payment methods you will have at your store, and what shipping options are available.

move_your_store

Mon, 01 Mar 2010 03:52:40 -0700

* If you are running a live store and want to move your site to a new host then you will need to be careful that you test your move before taking down your existing site to avoid disruption to your customers. * Make sure that you pick a time when your store is quiet and that you have a backup of your current site before doing anything ... so that you can put everything back if something goes wrong - You have been warned!

my_store

Mon, 25 Jan 2010 06:19:20 -0700

My Store This section is where you enter in custom store information that osCommerce uses. These options need to be set to your custom information in order for the store to display your correct information, send emails to the correct destinations, and to set how you want osCommerce to function.

new_products_this_month

Sat, 11 Sep 2010 04:00:54 -0700

Change New Products to remove this month functionality Source: JohnW post on osCMax forum & pgmarshall post on osCMax forum In order to change the New Products for month which appears on the homepage so that it does not only show products from the current month, change the following code:

nochex

Tue, 27 Oct 2009 10:20:12 -0700

Enable this module to accept payment through NOCHEX. This module requires the GBP currency. Learn more about this at the NOCHEX website. Below are the configuration options for this module: Configuration * Enable NOCHEX module :: Set to 'True' to enable. * E-Mail Address :: The e-mail address to use for the NOCHEX service * Payment Zone :: Allows you to limit the use of this module to a single zone. * Set Order Status :: You can set the default order status to the store default, or set…

order_status

Mon, 26 Apr 2010 05:08:17 -0700

* Order Status show you and the customer the current status of their order. * Depending on the payment processor you use you will have different status messages showing. * Within osCMax you can send messages to clients when you change their order status with the admin panel.

order_total

Wed, 20 Jan 2010 17:15:13 -0700

Order Total Simply arrange the order in which you wish your order total to be calculated. * Discount Coupons :: * Gift Vouchers (-) :: See below for important message * Low Order Fee :: * Customer Loyalty Discount :: * Shipping :: * Sub-Total :: * Tax :: * Total ::

oscmax_docs

Mon, 05 Dec 2011 03:54:11 -0700

[] osCmax v2.0 Users Guide This is the home of the osCMax users guide. All current versions of osCmax are covered here. Contents: * Introduction :: What is osCmax? ---------- * Installation :: How to Install osCmax ---------- * Setting up security :: Tips and Hints on how to make you site secure from hackers.

other_useful_stuff

Tue, 02 Mar 2010 05:44:47 -0700

Buttons for your store * Find premade buttons for your store here Icons * An excellent set of icons from FamFam - hundreds of them! Neat 16×16 icon set. Flags * Looking for your country's flag? Try here * You should also find these in the install package of v2.0.15 onwards - catalog/images/flags

page_cache_settings

Tue, 27 Oct 2009 14:22:50 -0700

* Enable Page Cache :: * Cache Lifetime :: * Turn on Debug Mode? :: * Disable URL Parameters? :: * Delete Cache Files? :: * Config Cache Update File? ::

payment

Tue, 27 Oct 2009 10:25:28 -0700

This is the main payment module section. On this page, you will see a list of all currently installed payment modules in your store. Next to the module name, you will see a green icon and a red icon. To activate a module, click the green icon next to it. To deactivate a module, click the red icon next to it.

paypal

Tue, 27 Oct 2009 10:29:16 -0700

The setup of PayPal for osCMax store is a common area for questions within the forums. The first question you need to ask yourself is Standard or Pro? Standard or Pro? There are two types of service that they provide. Below is an extract from their website.

paypal_express

Tue, 27 Oct 2009 07:52:43 -0700

PayPalstand alone mode PHP“” Configuration * Enable PayPal Express Checkout (UK) :: Set this to true if you want this payment method to be enabled during checkout. A Check Out with PayPal image button is also shown on the shopping cart page. Which looks like this:

paypal_ipn

Tue, 27 Oct 2009 12:00:24 -0700

What is IPN and why do you need it? * IPN stands for Instant Payment Notification * The traditional PayPal Website Payments Standard (Version 1.0) requires the shopper to return to the store in order for order details to be recorded, order emails to be generated and stock quantities to be updated.

paypal_payments_pro

Tue, 27 Oct 2009 08:24:48 -0700

* PayPal Website Payments Pro (US) Direct Payments allows Debit/Credit cards to be accepted directly on a merchant's website during the checkout process. PayPal PayPal PHP“” Configuration * Enable PayPal Direct :: Set this to True if you want to make this payment method available to customers during checkout. The credit and debit card information is entered on the checkout confirmation page. Which looks like this:

paypal_standard

Tue, 27 Oct 2009 12:04:29 -0700

This is the Official osCommerce paypal WPS standard paypal module. Several tutorials to help with setting up this module, as it can be tricky for some: Step by Step Guide to Setup Paypal WPS Tutorial Forum discussing setup How to set up WPS

paypal_uk

Tue, 27 Oct 2009 07:47:56 -0700

UKPayPal PayPalPayPal Website Payments Pro (UK) Direct Paymentsmust be enabled PHP“” Configuration * Enable PayPal Express Checkout (UK) :: Set this to true if you want this payment method to be enabled during checkout. A Check Out with PayPal image button is also shown on the shopping cart page. Which looks like this:

paypal_uk_direct

Tue, 27 Oct 2009 08:09:38 -0700

* PayPal Website Payments Pro (UK) Direct Payments allows Debit/Credit cards to be accepted directly on a merchant's website during the checkout process. PayPal PayPal PHP“” Configuration * Enable PayPal Direct (UK) :: Set this to True if you want to make this payment method available to customers during checkout. The credit and debit card information is entered on the checkout confirmation page. Which looks like this:

per_item

Tue, 02 Mar 2010 05:02:50 -0700

* Use this module to set a 'Per Item' shipping charge. Set a base shipping rate, and that rate will be mutiplied by the number of items that the customer has in their shopping cart. The following options must be set: * Enable Item Shipping :: Set this to true to enable this module. * Shipping Cost :: Set the rate you want to charge per item purchased. * Handling Fee :: Set the amount you want to charge for handling. This can be set to zero to deactivate the handling fee. * Tax Class ::…

phpmyadmin

Wed, 17 Feb 2010 03:42:24 -0700

phpMyAdmin is a tool usually supplied by your hosting provider for editing your database using SQL commands. You should be able to access it by logging into your control panel. It is a very powerful tool and when using it you will need to be careful to ensure you do not damage your database.

plus_and_minus_buttons

Thu, 03 Dec 2009 12:37:54 -0700

A fairly simple mod which will add a plus and minus button with a quanitity box to your product info page. Javascript * Cut and paste the following code into a text editor and save as plusminus.js and put it in a folder called javascript in your catalog folder.

product_information

Tue, 27 Oct 2009 12:09:50 -0700

* Product Info Attribute Display Plugin :: * Show Out of Stock Attributes :: * Mark Out of Stock Attributes :: * Display Out of Stock Message Line :: * Prevent Adding Out of Stock to Cart ::

product_listing

Sun, 25 Oct 2009 10:03:56 -0700

Product Listing All the settings here control how the product listings display, and what information is displayed. You control the order they are displayed by adding numbers in sequence. The option with '1' will display first, '2' second, '3' third, and so on. To disable any option from displaying, set it to '0'

psigate

Tue, 27 Oct 2009 10:24:16 -0700

Enable this module to accept payments using PSiGate merchant account. Learn more about this method of accepting payments at the PSiGate web site. Below are the configuration options for this module: Configuration * Enable PSiGate Module :: Set to 'True' to enable. * Merchant ID :: Merchant ID used for the PSiGate service * Transaction Mode :: Transaction mode to use for the PSiGate service. You have the following options when setting this: * Production :: Use this setting when your sit…

rcs_guide

Sat, 24 Oct 2009 11:23:03 -0700

Recovered Cart Sales Guide Taken from the module found at osCommerce - all credit to original author Lane Roathe - Description This contribution consists of three parts: * The tool to locate, select and send out customers for sending emails to. The ideas is to select customers who abandoned carts and just need to be reminded to complete the cart and/or to find out why the customer didn't complete the order. (ie, problem with credit card acceptance…

recover_cart_sales

Thu, 01 Jul 2010 03:45:11 -0700

Recover Cart Sales A very useful tool which can help recover potentially lost sales. For more detailed information read the complete RCS Guide Settings * Look back days :: Number of days to look back from today for abndoned carts. (Default: 30) * Skip Days :: Number of days to skip when looking for abandoned carts. Combined with above determines the date range, ie: look for abaonded carts older than 5 days ago but before 30 days ago. (Default: 5) * Sales Results Report days :: * Use…

remove_let_s_see_what_we_have_here

Fri, 28 Dec 2007 22:19:32 -0700

In order to activate category descriptions, make sure that in Admin >> Configuration, that Allow Category Descriptions is set to True. Next, simply create your categories as you normally would by going to Admin >> Catalog >> Products/Categories. You can add a new category or edit an existing one.

removing_product_price_and_manufacturer_info_from_new_products_page

Fri, 28 Dec 2007 22:22:06 -0700

To remove pricing and manufacturer info from the New Products page : Go to templates/fallback/content/products_new.tpl.php Comment out the following codes at around line 111:

removing_product_price_from_cross_sell_product_list

Fri, 28 Dec 2007 22:21:08 -0700

To remove pricing from your Cross Sell products : 1. Open catalog/includes/modules/xsell_products.php 2. Comment out line 30 - 39 :

reports

Wed, 10 Feb 2010 03:48:35 -0700

Reports * Products Viewed :: Shows the most view products * Products Purchased :: Shows the most purchased products * Monthly Sales & Tax :: Details of sales and tax by month * Recovered Sales Results :: Shows the results of the Recover Cart Sales * FedEx Shipping Manifest :: Produce your FedEx shipping manifests * Customer Orders-Total :: Shows a list of your best customers * Stock Report :: Shows a consolidated list of your stock including highlighting low stock. * Customer Cr…

reset_password

Tue, 19 Jan 2010 15:16:29 -0700

* Okay so you have forgotten your login or password or both! You should be able to get osCMax to email you a new password. * Click on the forgotten password link on the login page and then enter your username and email address. You should recieve a new password by email.

restrict_ip_access

Fri, 01 Jan 2010 09:01:50 -0700

Editting your .htaccess * You should find a .htaccess file in your root folder (or catalog depending on where you installed your store) * Edit this file using Notepad or similar * Add the following to the top of this file * Replace the 888.888.888.888 with your own IP address. Find out your IP address here * Save the document

results_switcher

Sat, 02 Jan 2010 12:22:46 -0700

What it does Allows the user to change: * the number of items to display on one page * the sort order * the display from grid to list or visa versa Screen Shots Demo Demo Link Instructions Thread with instructions

sec_pay

Tue, 27 Oct 2009 10:25:08 -0700

Enable this module to accept payments using SECPay. To learn more about this payment option, go to the SECPay Website. Below are the configuration options for this module: Configuration * Enable SECPay Module :: Set to 'True' to enable. * Merchant ID :: Merchant ID to use for the SECPay service. * Transaction Currency :: The currency to use for credit card transactions. You can set this to Any Currency or Default Currency. * Transaction Mode :: Transaction mode to use for the SECPay se…

seo_urls

Wed, 10 Feb 2010 04:15:21 -0700

Configuration enable SEO URLsedit your .htaccess file * Enable SEO URLs? :: This setting enables/disables the SEO URLs contribution globally. (Default Setting: true) * Add cPath to product URLs? :: This setting enables/disables the option of adding the cPath parameter to the end of product pages. Eg. some-product-p-1.html?cPath=xx (Default Setting: false) * Add category parent to begining of URLs? :: This setting enables/disables the option of adding the category parent to the beginnin…

sessions

Sun, 25 Oct 2009 10:14:48 -0700

Sessions This section controls how the store controls your sessions. Setting * Session Directory :: If you are using file based session this sets the directory on the server to store them. Default /tmp. * Force Cookie Use :: Force the use of sessions only when cookies are enabled. Default: False. * Check SSL Session ID :: Validates the session ID for every secure page request. * Check User Agent :: Checks the users browser agent on every page request. * Check IP Address…