Installation manual

www.kassanova.org KassaNova version Document name Manual version Written on Edited on Created by Copyright 0.6.8 Installation manual 1 21-02-2011 21-02-2011 Dave Smink KassaNova BV

KassaNova installation manual

Index
1Before you install............................................................................................................................... 3 2Introduction and requirements............................................................................................................3 2.1Introduction.................................................................................................................................3 2.2Requirements.............................................................................................................................. 3 2.3What is a localhost?.................................................................................................................... 3 3Downloading KassaNova................................................................................................................... 5 4Installing KassaNova..........................................................................................................................6 4.1Unzip the download.................................................................................................................... 6 4.2Copy the complete directory.......................................................................................................6 4.3Run the installation..................................................................................................................... 6 4.3.1Language............................................................................................................................. 7 4.3.2Check.................................................................................................................................. 7 4.3.4Database.............................................................................................................................. 8 4.3.5Database creation................................................................................................................ 9 4.3.6Global settings...................................................................................................................11 4.3.7Print settings......................................................................................................................14 4.3.8Write config file................................................................................................................ 15 4.5Addition settings....................................................................................................................... 16 4.5.1Stock..................................................................................................................................16 4.5.1.1Sound.........................................................................................................................16 4.5.1.2Adjust stock............................................................................................................... 16 4.5.2Label printing.................................................................................................................... 16 4.5.3Receipt printing.................................................................................................................16 4.5.4Report printing.................................................................................................................. 16 4.5.5Additional Virtuemart settings.......................................................................................... 17 4.5.6Additional Prestashop settings.......................................................................................... 17 4.5.7Additional OpenCart settings............................................................................................17 4.5.8Additional CubeCart settings............................................................................................ 18

KassaNova installation manual

1 Before you install

Keep in close range: The database credentials of your web-store. You will need the database name, database user, database password and a hostname of your web-store database. Make sure you are connected to the internet.

2 Introduction and requirements

2.1 Introduction
KassaNova is software which can be used as a checkout point. KassaNova is software which can connect to your online web store. More information about KassaNova can be found on http://www.kassanova.org. KassaNova software is created by the dutch company KassaNova B.V. This document helps you to install the software and helps you to understand the installation and options.

2.2 Requirements
You will need to install some other software before you can run KassaNova. You will need: A working webshop! We support Virtuemart, Prestashop, OpenCart and CuberCart. Working Localhost. (See chapter 1.3) Flash player 9 or higher. Firefox browser is preffered. You can download the firefox browser at http://www.mozilla.com/en/firefox/ Optional: you can install notepad++ if you are on windows. With notepad++ you can edit the configuration files. You can download notepad++ from http://notepad-plus-plus.org/

2.3 What is a localhost?

A localhost is a server application running on your own computer. The most popular webserver is Apache which is an open source, free server package. Localhost is in this case the computer you are installing kassanova on. So why use a localhost? KassaNova needs it's own database. You can also run this on you webserver of the webshop. Running KassaNova local has the advantage of direct printing and still working even if internet is down. You don't want you POS system to be down, just because internet is down. How to install localhost on my POS computer? Nowadays there are complete install packages. KassaNova installation manual 3

For windows: You can use easyphp. Please visit http://www.easyphp.org/ for download and installation manual. For mac: You can use MAMP. Please visti http://www.mamp.info/en/index.html for download ans installation manul. For linux: You can run a normal LAMP installation. If you run linux, you will know how to do this. :) NOTE: KassaNova does NOT work without a WORKING localhost!

KassaNova installation manual

3 Downloading KassaNova
You can BUY KassaNova at http://www.kassanova.org. After buying you will receive a download link by email.

KassaNova installation manual

4 Installing KassaNova
4.1 Unzip the download.
It means "extract from a zip file."

4.2 Copy the complete directory

When you where extracting the package, there was a KassaNova directory created. Copy this complete directory to you www of the localhost. In windows is this directory c:\program files\easyphp x \www. In mac is this directory /Applications/MAMP/htdocs/.

4.3 Run the installation

Start you localhost. Easyphp or MAMP. Start your web-browser (firefox / safari / internet explorer/ other). Surf to http://localhost/kassanova Make you you see the installation. If you see a No connection page, make sure your localhost is up and running. If all correct you will see the following website:

KassaNova installation manual

4.3.1 Language
Select the language of your choice in the drop-down box. This is the language of the POS. This is not the language of the installation. After selecting the language press the next button in the right upper corner.

4.3.2 Check
This step checks if you did select a language. It also check if the requirements. If all set to a green Yes, you can press the next button in the right upper corner. If NOT: If PHP Version >= 5 is set to No. You have downloaded a wrong localhost package. Go back to step 1, and do not download the same localhost package. If Flash Version >= 9 is set to No, there are 2 options: You don's have the right version or you don't have the flash player at all. Please goto http://get.adobe.com/nl/flashplayer/ and install the flash player. [Linux only] if ../configuration.php writeable: is set to NO. Chmod this this file to 777. if ../settings/host.xml writeable: is set to NO. Chmod this this file to 777. [/Linux only]

KassaNova installation manual

4.3.3 Database
This is the most essential part of the installation. Please take your time for this page. The screen should look like this:

You will need to fill in 8 input fields. Part 1: Fill in the credentials of you web-store database. If you don't know what to fill in, please contact your hosting provider. Explanation of the fields: Host name: The hostname or ip address of you database. No idea? Just fill in the ip address of your web-store. (No idea what you ip address is? visit http://www.wikihow.com/Find-a-Website%27s-IPAddress) Username: This is your database username. Please do NOT fill in an administrator account of your web-store. This must be a database username. Password: This is your database password. Please do NOT fill in a password of an administrator account of your web-store. This must be the database password that belongs to the database username. KassaNova installation manual 8

Database name: This is the database name of your web-store. Optional: If your web-store uses a prefix which is not the default of the web-store you can edit this in /kassanova/connectors/name of you store/configuration.php. So if it is NOT vm_ or ps_ or CubeCart_ change this file. Part 2: Fill in the credentials of the localhost database. If you have installed localhost the normal way, change nothing. And skip this step. If you have set a different username and password please fill in. KassaNova creates the database if it does not exist. So no need to create it yourself. Ready? Press the next button in the right upper corner. Optional: This installation manual thinks you are installing KassaNova on a local pc. If you are setting it up on your web-store hosting provider please fill in 127.0.0.1 as the external database host name, and localhost for the kassanova (local) database host name. If you enter localhost as hostname for the external database and for the local database it will NOT work.

KassaNova installation manual

4.3.4 Database creation

The screen in this step should look like:

If all check are a green Yes, press the next button in the right upper corner. If not, and you have a red No. Please first fix the problem, and do NOT continue the installation. Exception to this rule is that Created database (kassanova) can be a red No.

KassaNova installation manual

10

4.3.5 Global settings

KassaNova installation manual

11

On this page you can set all global settings, for example currency, tax including and what web-store you run. Explaining all fields: Live site: This is live site of the POS. Do not change this if you don't know what you're doing. Tax mode: Default is Incl. Tax. If you would like the POS to show everything (receipt too) set it to Ex. Tax. Currency symbol: The currency symbol for the POS and all prints. Default is . You can set it to your own currency symbol. For example $ or . Currency: This is the written version of the currency symbol. This used for saving the orders to your webstore. So please fill in. Default is EUR. You can change this to your own currency. For example USD or GBP. Show Currency: If you would like to show the currency. Set it to Hide or Show. Login mode This option give you the option to ask every time you start KassaNova, to ask for a username and password. This can be administrators of your web-store. Default is No login needed. You can set it to Login needed if you would like to login every time. The order will be saved with the login name if set to Login needed. Status Code Order Onhold Only change if you know what you are doing. Layout File Only change if you know what you are doing. Layout Hex Only change if you know what you are doing. Check Stock Alert By default KassaNova gives you an alert when the product is not at stock. You can change this if you don't want to be alerted. This means that you can still sell a product, even if it's sold out. Default is Alert, change to No alert if you would like to sell product that are sold out. Connector File This is an important option! Please select name of your web-store option. Selecting the wrong option will result in having no products in the POS. Connector On Only change if you know what you are doing. KassaNova installation manual 12

Auto cash drawer open KassaNova can automatically open your cash drawer. Default is set to Off. You can set this to On if you like this feature. You will need to have a electronic cash drawer connected to the POS or to your receipt printer. Connected to your receipt printer is preferred. Com Port Number of Cash Drawer Only change if you know what you are doing. All field in the section Store information are shown on the receipt. Please fill in what you would like to see on the receipt. If you have more than 1 KassaNova POS in you store. Please consider to change the option Pos Number.

KassaNova installation manual

13

4.3.6 Print settings

This page shows some of the printer options. Receipt printer name Enter the name of the printer you would like to print to. This is only needed when Printing mode is set to direct. Enter the specific name, just like it has on your computer. Printing mode Set it to direct, when you have KassaNova running n you local pc. You can set printing mode to popup if you are running KassaNova on you web-store hosting or if you would like to choose the printer each time you would like to print a receipt. Layout Print File 80mm-roll is for when using a receipt printer. You can set it to default_layout if you are printing to a A4 printer. Print Receipt Repeat How many copies when receipt is printed. Default is 1.

KassaNova installation manual

14

4.3.7 Write config file

You're all done. The installation was successful. Click on Start KassaNova to start the POS.

KassaNova installation manual

15

4.4 Addition settings 4.4.1 Stock

4.4.1.1 Sound

You can disable the sound that the error makes. This does not disable the alert. Open the file configuration.php and set the value of $config['sound_stock_alert'] to 0.
4.4.1.2 Adjust stock

Selling products using KassaNova. But don't want that the stock is adjusted? Open the file configuration.php and set the value of $config['adjust_stock'] to 0.

4.4.2 Label printing

You can print labels to a label printer. These labels include barcodes. For this, you need to set some options. Open the file configuration.php and set the following options: $config['label_printer_name'] The name of the label printer $config['print_label_margins'] If the label falls of the paper you can set margins. $config['print_label_width'] The width of the label in mm. $config['print_label_height'] The height of the label in mm. $config['auto_create_barcode'] If you don't have barcodes entered in your web-store, KassaNova can create them automatically. Make KassaNova auto create the barcode? Set this option to 1.

4.4.3 Receipt printing

The receipt falls of the paper and does not fit? Open the file configuration.php and change the values of $config['print_receipt_margins']. This is an array and you can set the margins of left, right, top and bottom.

4.4.4 Report printing

You can print all reports to another printer than your label or receipt printer. Don't like your day report or stock report on a receipt? Open the file configuration.php and enter the name of another printer at $config['other_printer_name'].

KassaNova installation manual

16

4.4.5 Additional Virtuemart settings

You can set specific settings if you are connected with a Virtuemart web-store. You can change these settings in the file /connectors/virtuemart/configuration.php. In this file you can change the database prefix of Joomla and the prefix of Virtuemart. You can the default user id. You can the default vendor id. You can change the order status when a order is saved. In you have installed the KassaNova barcode component, you need to set $vm_config['virtuemart_sync_barcode_mode'] to COMPONENT.

4.4.6 Additional Prestashop settings

You can set specific settings if you are connected with a Prestashop web-store. You can change these settings in the file /connectors/prestashop1_2_x/configuration.php. Or You can change these settings in the file /connectors/prestashop1_3_x/configuration.php. Or You can change these settings in the file /connectors/prestashop1_4_x/configuration.php. In this file you can change the database prefix of Prestashop. You can the default user id. You can the default vendor id. You can change the order status when a order is saved. When KassaNova is running but you can't find any products, please set $ps_config['prestashop_id_lang'] to the correct language id. When you don't see the correct prices, make sure $ps_config['prestashop_id_currency'] is set to the correct Prestashop currency id.

4.4.7 Additional OpenCart settings

You can set specific settings if you are connected with a OpenCart web-store. You can change these settings in the file /connectors/opencart/configuration.php. In this file you can change the database prefix of OpenCart. You can the default user id. You can the default vendor id. You can change the order status when a order is saved. When KassaNova is running but you can't find any products, please set $oc_config['opencart_id_lang'] to the correct language id. When you don't see the correct prices, make sure $oc_config['opencart_id_currency'] is set to the correct OpenCart currency id. You can also set KassaNova to another store by changing the value of $oc_config['opencart_default_store']

KassaNova installation manual

17

4.4.8 Additional CubeCart settings

You can set specific settings if you are connected with a CubeCart web-store. You can change these settings in the file /connectors/cubecart_v3/configuration.php. Or You can change these settings in the file /connectors/cubecart_v4/configuration.php. In this file you can change the database prefix of CuberCart. You can the default user id. You can the default vendor id. You can change the order status when a order is saved. When KassaNova is running but you can't find any products, please set $cc_config['cubecart_id_lang'] to the correct language id. When you don't see the correct prices, make sure $cc_config['cubecart_id_currency'] is set to the correct CubeCart currency id. You can also set KassaNova to another store by changing the value of $cc_config['cubecart_default_store']

KassaNova installation manual

18