1. Start
  2. Introduction
    1. Web Server
    2. PHP
    3. MySQL Database Server
  3. New Installation
    1. Pre-Installation Steps
    2. File Permissions
    3. Installation Procedure
    4. Installing a New Online Store
    5. Post-Installation Steps
  4. Building the Template Layout
  5. Modules
    1. Modules
    2. First Page (home page)
    3. Categories Nested Page
    4. Product Info Page
  6. Layout Pages
  7. Layout Boxes
  8. Other Setting
    1. Simple Checkout
    2. Order Editor
    3. Slideshow Layout
    4. Banners Layout
    5. Titles
    6. Admin Panel setting
    7. Color Labels
    8. Color Schemes
    9. Building the Template Color Schemes
  9. Catalog
    1. Product Extra Fields
    2. Featured Products
    3. Discount Codes
    4. Related Products
    5. Tags
  10. Boxes
    1. Boxes position
    2. Positions of Boxes available for placement.
  11. Tools
    1. Slideshow Manager
    2. Banner Manager
    3. Extra info Pages Manager
  12. Categories Drop Down Menu
  13. Changelog
  14. Finally

Techno Store

osCommerce with powerful settings


Presented theme found on a standard template engine osCommerce v2.3.x. For your facilities, as well as drawing on the experience and considering the most effective sales promotion devices by e-commerce, our team have added exclusive modules, boxes and extra pages various layout presentation of goods. In this manual, you will see the screenshots, is available explaining how to edit the added features. (These mark as bold fonts in the admin panel). All other standart explanations of the store you can find in the original osCommerse manual.

osCommerce Online Merchant can be installed on any web server that has PHP installed and has access to a database server. This includes shared servers, dedicated servers, cloud instances, and local installations running on Linux, Unix, BSD, Mac OS X, and Microsoft Windows operating systems.

Web Server

The web server must support PHP either as a module or allow execution of CGI scripts. For performance reasons FastCGI is recommended over CGI.


osCommerce Online Merchant is compatible with PHP 4 and PHP 5. For performance and security reasons it is recommended to use the latest PHP 5 version on the web server.

The following PHP options are recommended to be set in the php.ini configuration file:

Php Setting Value
register_globals Off
magic_quotes_gpc Off
file_uploads On
session.auto_start Off
session.use_trans_sid Off
MySQL MySQL database extension.

The following PHP extensions are recommended:

GD Image processing module.
cURL Network communication library.
OpenSSL Encryption library.

MySQL Database Server

The minimum MySQL version required is v3.23. It is recommended to use the latest MySQL 4 or MySQL 5 version on the database server.

The following MySQL storage engines are supported:

Storage Engine
MyISAM Default storage engine.

New Installation

Pre-Installation Steps

osCommerce Online Merchant is a web based solution that needs its relevant files to exist on the web server. The files can be copied to the web server by extracting the download package on your computer and uploading its contents to the web server via FTP, or by copying the download package to the web server directly and extracting its contents there.

Copying the Files to the Web Server

The contents of the download package need to be copied to the public HTML directory the web server is serving from.

Examples of public HTML directories are:

The contents of the download package once extracted is:

File/Directory Description
catalog The directory containing the PHP source code files.
documentation The documentation in HTML format.
Using FTP to Copy the Download Package Contents to the Web Server

Directly Extracting the Download Package on the Web Server

The download package of osCommerce Online Merchant should be saved and extracted on the web server to reveal its contents. The catalog directory must be copied to the public HTML directory. This can be achieved with the following command:

cp -R catalog /public_html/

File Permissions

The following files need to be writable by the web server during the installation procedure:


Please consult with your hosting provider to find out the permission flag to use to allow the web server to have write permissions to files and directories.

The above files must have their web server writable permission removed after the installation procedure has completed successfully. This is described in the Post-Installation Steps page.

In some cases a global write permission flag of 777 can be used but may lead to an insecure installation if not reverted afterwards.

Changing the file and directory permissions can be performed by most FTP clients or directly on the server.

Using FTP to Change File Permissions

Most FTP clients are capable of changing file permissions on the server. This is commonly performed by right-clicking on the file or directory and selecting "Properties" or "Attributes" on the context menu.

The file permissions can be changed by allowing all users to read, write, and execute the file, or by manually entering the global readable and writable flag of 777.

Changing File Permissions Directly on the Server

Changing file permissions directly on the server can be performed with the following command:

					chmod 777 /public_html/catalog/includes/configure.php
					chmod 777 /public_html/catalog/admin/includes/configure.php

A MySQL database needs to exist for the installation procedure to be able to successfully import the database table structure and required data settings.

Web Server and Database Server Details

The following web server and database server details are required during the installation procedure. Please consult your hosting provider if these details are not known.

Web Server Details
Setting Description Example
Server Address The web address to the online store. http://www.yourdomain.com/catalog/
Root Directory The directory where the online store is installed on the server. /public_html/catalog/
Database Server Details
Setting Description Example
Server Address The address of the database server in the form of a hostname or IP address. localhost
Username The username used to connect to the database server. marinewonders
Password The password that is used together with the username to connect to the database server. securepassword
Database Name The name of the database to hold the data in. oscommerce

Installation Procedure

The web based installation procedure configures the online store and imports the configuration data into the database. This is necessary to create a fully functional online store and to create an administrator that administrates the online store through the Administration Tool.

The configuration values provided by default are safe to use but may need to be changed depending on the environment of the web server.

Please review the Pre-Installation Steps chapter before continuing with the installation procedure.

Installing a New Online Store

The web based installation procedure is automatically started when accessing the online store through a web browser. This can be achieved by entering the WWW address of osCommerce Online Merchant installation in your browser.

For example:


osCommerce Online Merchant automatically detects if the installation has already been completed and redirects to the installation procedure if it has not yet been performed.

Step 1: Welcome Page

The first step is the welcome page shown in Figure 1 which displays the current recommended configuration settings for PHP.

osc-Installation-Welcome Page

It is recommended to update a PHP configuration value, or to install and activate a PHP extension, if it is marked against the recommended setting.

Figure 1. Welcome Page

It is recommended to update a PHP configuration value, or to install and activate a PHP extension, if it is marked against the recommended setting.

When making PHP configuration changes or when installing and activating a PHP extension, the web server service needs to be restarted for the changes to take effect. Once restarted, refreshing the welcome installation page and viewing the _Server Capabilities_ listing can confirm if the PHP configuration changes have taken place and if it meets the recommended settings.

Step 2: Database Server

The second step shown in Figure 2a sets the database connection parameters to successfully connect to the database server, to import the database table structure, and to import required data.

osc-Installation-Database Server

The installation procedure verifies the values entered before proceeding to the next step. If there is a problem connecting to the database server an error message is shown similar to the message shown in Figure 2b.

osc-Installation-Database Server-Error Figure 2b. Database Server Connection Error Message

Check to make sure the correct username, password, and database name are listed.

Step 3: Web Server

The third step shown in Figure 3 sets the web server parameters to successfully serve the online store to users.

osc-Installation-Web Server Figure 3. Web Server Configuration

Step 4: Online Store Settings

The fourth step shown in Figure 4 sets the store owner and administrator settings for the online store.

osc-Installation-Owner-Settings Figure 4. Store Owner Settings

It is important to keep note of the administrator username and password as these are used to login and to access the Administration Tool.

Additional administrators can be created in the Administration Tool after the installation procedure has been successfully completed.

Step 5: Finished!

The last step in the installation procedure stores the database server and web server parameters to the configuration file on the web server. On successfully saving the configuration file, the installation procedure is finalized and the online store is ready to be used as shown on Figure 5.

osc-Installation-Successful Figure 5. Successful Installation Confirmation

Please review the Post-Installation Steps page after the installation procedure has been successfully completed to secure the online store.

Post-Installation Steps

Upon successful installation of osCommerce Online Merchant, the following steps need to be performed to secure the installation of your online store.

Remove Installation Files

The catalog/install directory must be removed from the web server otherwise a user could use the installation procedure and reconfigure the online store to use another database server.

File and Directory Permissions

The file permissions for catalog/includes/configure.php and catalog/admin/includes/configure.php must deny write access by the web server. This is commonly performed by setting the permission flag to a read only value of 644 or 444 depending on your server.

Some directories need to allow write access by the web server for osCommerce Online Merchant to function properly. A list of directories and the current write permission state can be viewed on the Administration Tool -> Tools -> Security Directory Permissions page.

Extra Protection for the Administration Tool

The Administration Tool is secured by its own login routine but is still publicly accessible. It is recommended to further protect the Administration Tool by setting a htaccess password on the catalog/admin directory.

Instructions for adding a htaccess password layer is provided on the Administration Tool -> Configuration -> Administrators page.

Building the Template Layout

A basic template layout structure has been introduced in osCommerce Online Merchant v2.3.x to simplify the process of customizing the design of the catalog frontend.

The template design layout is defined in catalog/includes/template_top.php and catalog/includes/template_bottom.php, with the page content existing in the base catalog files.

The final template layout is built with the following procedure:

  1. Base catalog file requested (eg, catalog/index.php)
  2. Application initialization through catalog/includes/application_top.php
  3. Control logic executed for actions performed
  4. Template design layout initialization through catalog/includes/template_top.php
  5. Page content loaded
  6. Template design layout finalized through catalog/includes/template_bottom.php
  7. Application finalized through catalog/includes/application_bottom.php

The default template layout is defined as:

HTML doctype
CSS & jQuery
boxes position Above Header (catalog/includes/template_top.php)
boxes position Header (catalog/includes/header.php)
boxes position Under Header (catalog/includes/template_top.php)
boxes position Content Block Top (catalog/includes/template_top.php)
Base catalog files (eg, catalog/index.php)
boxes position Tab section 1 - 4
  • catalog/index.php
  • catalog/categories_nested.php
boxes position Product Page
  • catalog/product_info.php
  • catalog/product_reviews.php
  • catalog/product_reviews_info.php?
  • catalog/product_reviews_write.php?
boxes position Tab Product Page
  • catalog/product_info.php
boxes position Content Block Bottom (catalog/includes/template_bottom.php)
boxes position Right column (catalog/includes/template_bottom.php)
boxes position Left column (catalog/includes/template_bottom.php)
boxes position Above Footer (catalog/includes/template_bottom.php)
boxes position Footer (catalog/includes/template_top.php)
Copyright line Footer (catalog/includes/footer.php)


All visible semantic blocks can be divided into 3 types


The template has 5 modules
3 - original osCommerce and
2 - exclusive osCommerce

  1. Module New Products (A) - improved
  2. Module Featured Products (B) - exclusive
  3. Module Upcoming Products(C) - improved
  4. Module Related Products (F) - exclusive
  5. Module Also Purchase Products (D) - original

improved - standart modules osCommerce2.3 improved with detailed settings

exclusive - developed modules for the efficient provision of goods

Modules A,B,C display on First Page, Figure 10 and Categories Nested Page Figure 12

Categories Nested Page shown the Sub Categoryes listing and modules below, in case if category hasn't a products, and has the Sub Categoryes

Modules F, D display on Product Info Page, Figure 13.

The Modules will be Hiden if every one Product outside of filter range, and even if this module is 'Show' with Administration Panel.

First Page (home page)

Figure 10.


Categories Nested Page

Figure 12.


Product Info Page

Figure 13.


Layout Pages

Manage the settings in the admin panel is simple and facilities. Choose the desired page and easily change it in the settings on the fly. Figure 21

Figure 21.


Layout Boxes

Management settings the Boxes in the admin panel allows you to easily and freely to promote your products. Select the desired box and change the settings in a few clicks.Figure 22

Also the Position in theme and select pages where this box should be displayed, you may see below

Figure 22.


Other Setting

Simple Checkout

Simplifies the process of buying. Buyer, adding to the shopping car, may create an account, or to make a purchase as a Guest.Figure 23

Figure 23.


Order Editor

Allows you to facilitate the processing of orders.Figure 24

Figure 24.


Slideshow Layout

Allows you to set the right group for slideshows, which will be used to edit the slides.Figure 25

Figure 25.


Banners Layout

Allows you to set the right group for banershows, which will be used to edit the baners.Figure 26

Figure 26.


The creation of additional groups will be created for free by our team, if requested.

Colored Labels

Allows you to set the Colored Labels as stripes on corner Product block (Featured, New, TopSellers).Figure 26

Figure 26.


The creation of additional groups will be created for free by our team, if requested.


Allow the ability to add a picture in the category title.Figure 27

Figure 27.


Admin Panel setting

Allows you to set the size of product images and change the number displayed in the listing of products in admin panel.Figure 28

Figure 28.


Colored Schemes

The template has 8 Color Schemes
4 - Light & 4 - Dark

For Setting Color Schemes via Admin Panel.
Admin Panel --> Other Setting --> Color Schemes --> Choose main colors --> Edit Figure 17 osc-color-17

Figure 17.

If you coose "Custom", Another new accordion header "Colors" with the more details setting will appear in the Left Column. Figure 18

Figure 18.

In this case, you can set up, creating a personalized color scheme via admin panel.


Product Extra Fields

With Products extra fields it's possible to add extra fields to your products.Figure 28

Figure 28.


You can select any item as Featured Product.Figure 29


Figure 29.

Discount Codes

Discount code module allows you to assign a discount code to a product, category (for each product of this category) and total order. You can specify a fixed discount rate or a percentage of the total order, set expiration date and minimum order amount for a discount code.

Customer gets a discount by clicking a link or inserting the discount code while checkout. The link containing the discount code (http://www.yourshop.com/?discount_code=12345678) is especially convenient for newsletters sending out and promo campaigns conducting. Figure 30, Figure 30a

Figure 30.


Figure 30a.


Allows to add to the product related products. Figure 31 - 31a

Figure 31.


Figure 31a.



Allows to add a Tags to each product on existing language for sales promotion. Figure 32

Figure 32.



The Boxes of different modules that has a position in the theme.

Boxes position

Theme has:
9 positions for all pages.
4 positions for First Page and Categories Nested Page.
1 position for 1 page - Poduct Info.
1 position for 4 pages - Poduct Info, Poduct Reviews Page, Poduct Reviews Info Page.

Positions of Boxes available for placement.

Above Header Block Header Block Under Header Block Left Column Right Column Content Top Set Block Content Bottom Set Block Above Footer Block Footer Block Product Page Tab Section 1-4
Banner Set                      
Popular products                      
Brands Slider                      
Customer Greeting                      
Featured Products                      
Contact Us                      
Our Offers                      
Stay Connected                      
Currencies - drop Down                      
Languages - drop Down                      
Main Menu                      
Store phone                      
Shopping Cart                      
User Menu                      
Reviews Products                      
Tab Popular Products                      
Tab Spesial Products                      
Tab Reviews Products                      
Tab Featured Products                      
Specials Products                      
Tag Cloud                      
Best Sellers                      
Manufacturers Info                      
Order History                      
Product Notifications                      
Product Social Bookmarks                      
Shopping Cart                      
What's New                      


Slideshow Manager

Allows you to edit slides and view statistics of slides. Figure 34

Figure 34. osc-slideshow_manager-1
Figure 34a. osc-slideshow_manager-2

Banner Manager

Allows you to edit banner and view statistics of banners.

Similar setting with Slideshow Manager.

Extra info Pages Manager

Allows you to manage the CMS pages (Information box in footer) on the fly.

Figure 35. osc-cms-2
Figure 36. osc-cms-2

Categories Drop Down Menu

The Module Categories displays on the all Pages in Header area

The Module Categories has 2 layout

  1. Simple menu Figure 37.
  2. Mega Menu Figure 38.


Figure 37.


Figure 38.

You may change Drop Down categories menu via admin Panel --> Other Setting --> Categories menu


Update v.2.05 March 10

1.) Fix bug in adminPanel
Show/Hide Price on Search Results and Category Listing pages
adminPanel --> Layout Pages --> Search Results and Category Listing --> Show Price
2.) Fix bug in frontEnd
Display Module Also Purchased on Product Details page if
adminPanel --> Configuration --> Cache --> Use Cache --> true
3.) Improvements
Add 2 Layout Types:
- Full Width
- Boxed Width
adminPanel --> Other Setting --> Layout Type

Update v.2.04 Avgust 18, 2015

1.) Improvement of the admin panel - possibility to adjust the number of products per row from 1 to 6
for all the pages:
it doesn't depend on:
- how many columns are on the page (1, 2 or 3);
adminPanel --> Layout Pages --> New,
adminPanel --> Layout Pages --> Featured,
adminPanel --> Layout Pages --> Top sellers,
adminPanel --> Layout Pages --> Specials,
adminPanel --> Layout Pages --> Search Results and Category Listing,
adminPanel --> Layout Pages --> Brands,
adminPanel --> Layout Pages --> Reviews,
adminPanel --> Layout Pages --> Tag Products

for all the modules:
it doesn't depend on:
- how many columns are on the page (1, 2 or 3); adminPanel --> First Page --> Module New Products,
adminPanel --> First Page --> Module Featured Products,
adminPanel --> Categories Nested Page --> Module New Products,
adminPanel --> Categories Nested Page --> Module Featured Products,
adminPanel --> Product Info Page --> Module Also Purchased,
adminPanel --> Product Info Page --> Module Related Products

for all the widgets:
it doesn't depend on:
- how many columns are on the page (1, 2 or 3);
- in which of 6 possible position the widget will be shown.
adminPanel --> Modules --> Boxes
2.) Changes in the admin panel
replace TinyMCE editor to CKEditor:
adminPanel --> Catalog --> Categories/Products,
adminPanel --> Tools --> Slideshow Manager
3.) Improvement of the admin panel
add CKEditor to:
adminPanel --> Tools --> Testimonials Manager,
adminPanel --> Tools --> Send Email To Customers

Update v.2.03 May 02, 2015

- fix bug in Colored Labels;
- reduce time of theme installation.

Update v.2.02 April 22

Fixed bugs in adminPanel:
- Unnamed constant BOX_HEADING_ORDERS
- Spanish Localization

Fixed frontEnd:
- Background Color in Dark schems

Added and Improved:
- Colored Labels as stripes on corner Product block (Featured, New, TopSellers).

Update v.2.01 November 3, 2014

- New version of Simple/Mega menu with integrated and powerful settings to admin panel
- fix bug about upload product pictures admin panel
- Just css correction of font family - prepare for settings via admin panel, It will be finished at the next update.

Update v.2.0 September 30, 2014

- Update Techno Store osCommerce to version osCommerce 2.3.4

Add to theme:
- Responsive Layout
- Slider for banner set

Fixed bugs:
- Charset for spanish language;
- Create Account in header
- Show video on Product Page
- Extra Page in admin panel

Update v.1.9 November 17, 2013

- A bug after installation (concerning the colors table)
- Page Product info, tab Related Products;
- Page Manufacturers, images in carousel, as link;
- First level - ability to set custom menu items;
- Dropdown shape - ability to display Category image and Description or Custom HTML block or Hide it all.;

- Add 10 colors schemes, all settings via admin panel:

Update v.1.8 September 28, 2013

- Update Techno Store osCommerce to version osCommerce

Update v.1.7 September 22, 2013

- Update Techno Store osCommerce to version osCommerce

Update v.1.6 September 16, 2013

- Fixed Scrolling Customer Testimonials v1.11;
- Fixed products slider on Manufacturers page;
- A new option added: it's possible to display products as random, last modified, data added, status_change, products ordered for all the boxes in tabs and Featured Products, Popular Products, Specials Product.
- Update Techno Store osCommere to version osCommerce;
- Minor CSS, HTML fixes.

Update v.1.5 August 19, 2013

- Fixed Checkout pages;
- Fixed Discount Codes;
- Fixed Boxes Install/Uninstall;
- Remove addon Simple Checkout_v3.02 ;
- Added addon Consolidated Login with Guest Checkout v1.0;
- Added addon Scrolling Customer Testimonials_v1.11;
- Added addon Unit of Weight v1.1;
- Improve Manufacturers page;
- Minor CSS, HTML fixes.

Update v.1.4 April 22, 2013

- Added addon QTpro v4.6.1 Various attributes, and control stock on attribute level;
- Added addon Easy Populate v2.8.231; Data Store Import/Export
- Improved Product Info Page
- Fixed drop down Categories menu;
- Minor CSS, HTML fixes.

Update v.1.3 April 07, 2013

- Fixed languages files packaging.php

Update v.1.2 April 05, 2013

- On Categories Nested Page:
    1) Added Show or Hide Sub Category Image;
    2) Fixed Equal heights for product name in modules New products tab and Features products tab;
- Page of Brands:
    1) Fixed manufactures description from admin panel;
- Change link in documentation;
- Minor CSS, HTML fixes.

Update v.1.1 March 27, 2013

- Added addon Free Product Checkout v1.1;
- Added addon Products Extra Fields v 2.1;
- Fixed SlideShow and BanerShow;
- CSS, HTML for original osCommerce checkout;
- Minor CSS, HTML fixes.


Thank You For Buying TechnoStore Oscommerce Template.