Techno Store - osCommerce with powerfull options

# Techno Store

## osCommerce with powerfull options

- Created: 12/16/2012
- latest Update: 04/05/2013
- By: captNemo
- responsive-shop.com/osc/tstore/
- Email: sinbad.seaman@gmail.com

### Introduction

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.

#### PHP

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

Extension
MySQL | MySQL database extension.

The following PHP extensions are recommended:

Extension
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:

- /home/scott/public_html/
- /srv/www/htdocs/
- /usr/local/htdocs/
- /var/www/vhosts/domain.com/httpdocs/

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:

File
catalog/includes/configure.php
catalog/admin/includes/configure.php

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

##### Database

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:

    http://www.yourdomain.com/catalog/

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.

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.

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.

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.

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.

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.

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.

#### Last step

After your installation, the template may will be look as shown on Figure 6.
If you wan that it looks like on the demo you just need to login the admin panel and choose Modules --> Boxes.
After that reload the template in your browser.

Figure 6.

### 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:

catalog/includes/template_top.php
  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

catalog/includes/template_bottom.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)

### Modules

All visible semantic blocks can be divided into 3 types

- Modules
- Boxes
- Content of Pages

#### Modules

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.

#### Titles

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.

### Catalog

#### Product Extra Fields

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

Figure 29.

#### Featured Products

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.

#### Related Products

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

Figure 31.
Figure 31a.

#### Tags

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

Figure 32.

### Boxes

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.

- Above header
- Header
- Under Header
- Left Column
- Right Column
- Content Top
- Position inside First Page and Categories Nested Page
  - Tab section 1
  - Tab section 2
  - Tab section 3
  - Tab section 4
- Position inside Poduct Info Page, Poduct Reviews Page, Poduct Reviews Info Page and Poduct write Reviews Page.
  - Poduct Info
- Position inside Poduct Info Page.
  - Tab Product Info
- Content Bottom
- Above footer
- Footer

#### 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 |  |  |  |  |  |  |  |  |  |  |
Banner Set |  |  |  |  |  |  |  |  |  |  |
Popular products |  |  |  |  |  |  |  |  |  |  |
Brands Slider |  |  |  |  |  |  |  |  |  |  |
Customer Greeting |  |  |  |  |  |  |  |  |  |  |
Featured Products |  |  |  |  |  |  |  |  |  |  |
Account |  |  |  |  |  |  |  |  |  |  |
Contact Us |  |  |  |  |  |  |  |  |  |  |
Information |  |  |  |  |  |  |  |  |  |  |
Our Offers |  |  |  |  |  |  |  |  |  |  |
Stay Connected |  |  |  |  |  |  |  |  |  |  |
Currencies - drop Down |  |  |  |  |  |  |  |  |  |  |
Languages - drop Down |  |  |  |  |  |  |  |  |  |  |
Main Menu |  |  |  |  |  |  |  |  |  |  |
Store phone |  |  |  |  |  |  |  |  |  |  |
Search |  |  |  |  |  |  |  |  |  |  |
Shopping Cart |  |  |  |  |  |  |  |  |  |  |
User Menu |  |  |  |  |  |  |  |  |  |  |
Reviews Products |  |  |  |  |  |  |  |  |  |  |
Tab Popular Products |  |  |  |  |  |  |  |  |  |  |
Tab Spesial Products |  |  |  |  |  |  |  |  |  |  |
Tab Reviews Products |  |  |  |  |  |  |  |  |  |  |
Tab Featured Products |  |  |  |  |  |  |  |  |  |  |
Slideshow |  |  |  |  |  |  |  |  |  |  |
Specials Products |  |  |  |  |  |  |  |  |  |  |
Tag Cloud |  |  |  |  |  |  |  |  |  |  |
Welcome |  |  |  |  |  |  |  |  |  |  |
Best Sellers |  |  |  |  |  |  |  |  |  |  |
Categories |  |  |  |  |  |  |  |  |  |  |
Currencies |  |  |  |  |  |  |  |  |  |  |
Information |  |  |  |  |  |  |  |  |  |  |
Languages |  |  |  |  |  |  |  |  |  |  |
Manufacturer |  |  |  |  |  |  |  |  |  |  |
Manufacturers Info |  |  |  |  |  |  |  |  |  |  |
Order History |  |  |  |  |  |  |  |  |  |  |
Product Notifications |  |  |  |  |  |  |  |  |  |  |
Product Social Bookmarks |  |  |  |  |  |  |  |  |  |  |
Reviews |  |  |  |  |  |  |  |  |  |  |
Search |  |  |  |  |  |  |  |  |  |  |
Shopping Cart |  |  |  |  |  |  |  |  |  |  |
Specials |  |  |  |  |  |  |  |  |  |  |
What's New |  |  |  |  |  |  |  |  |  |  |

### Tools

#### Slideshow Manager

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

Figure 34.
Figure 34a.

#### 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.
Figure 36.

### Categories Drop Down Menu

The Module Categories displays on the all Pages in Header area

The Module Categories has 2 layout

1. Mega Menu Figure 3b.
2. Simple menu Figure 3b.

Figure 3b.

Figure 3b.

How to change Drop Down categories menu type

Download the 2 types of Categories Drop Down Menu. After extract you will see 2 folders with osCommerce folders structure.

You may change this one ih your site, by upload any from 2 types to you site derectory.

### F.A.Q.

#### How to Set Boxes

### Changelog

##### Update v.1.1 March 27

- 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.

###### INSTALLATION:

1. BACK UP YOUR DATABASE
2. MAKE COPIES OF YOUR ORIGINAL FILES
3. TAKE A BACKUP FIRST..
4. Upload all files from technostore_update.zip/catalog/ to their appropriate folders.technostore_update.zip
5. Upload the sql.php file to your catalog directory. Open the file in your browser. When it says Done!, delete the file.

##### Update v.1.2 April 05

- 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.

###### INSTALLATION:

1. MAKE COPIES OF YOUR ORIGINAL FILES
2. Upload all files from technostore_update_v1.2/catalog/ to their appropriate folders.technostore_update.zip
3. Upload the subcategory_page_show_thumbs.php file to your catalog directory. Open the file in your browser. When it says Done!, delete the file.

### Finally

Thank You For Buying TechnoStore Oscommerce Template.