Simple POS is PHP and jQuery based web application.
Documentation Version 1.2.0
Thank you for purchasing Simple POS - Point of Sale Made Easy
Please read this documentation and if you can't find answer to your question, you can post on item comments page at codecanyon.net Thank you
Requirements: Apache 2.2+, Mysql 5.4+, PHP 5.4+
http://yourdomain.com/pathtoupload/install/index.php
Please make sure you don't have $ sign in your password.
You must check the site url as installer might guess it wrong
http://yourdomain.com/
or http://localhost/
http://subdomain.yourdomain.com/
http://yourdomain.com/subfolder/
or http://localhost/subfolder/
We will provide the service to install the item for $20 To request the installation, please send $20 to support@tecdiary.com by Paypal or Skrill and email us your license file and hosting control panel details with reference of your payment to support@tecdiary.com
Requirements: Apache 2.2+, Mysql 5.4+, PHP 5.4+
index.php
, app/config/config.php
and app/config/database.php
uploads/
and files/
folders to save your uploadshttp://yourdomain.com/yourinstallationdirectory/update/index.php
and follow the instructions to update
We have added the update tool for testing purpose and feedback only. If you are advance user and have good command and experience of backup/restore (files & database) then you can try this update tool.
Please don't try this on your production version. Backup and restore the production version to different location and then try to update that. We are not providing any support for this at least for this version.
spos/config/database.php
) on your computerapp/config/database.php
) form the locally saved copy of database config file in step 2. You need to update the hostname, username, password and database.
http://yourdomain.com/pathtoupload/update/index.php
You must check the base url as update tool can guess it wrong.
This is the same base_url that you have in your old spos/config/config.php file
http://yourdomain.com/
or http://localhost/
http://subdomain.yourdomain.com/
http://yourdomain.com/subfolder/
or http://localhost/subfolder/
We have tested the update V4 with Bixolon SRP-350II (USB) and Xprinter XP-Q200II (LAN Interface).
The package used is known to work with the following OS/interface combinations:
Many thermal receipt printers support ESC/POS to some degree. This driver has been known to work with:
feedForm()
to release paper).
Any of the barcode scanners/readers will work fine with v4 as long as it can read accurately.
Most of the Magnetic Card Readers will work fine. We have tested this with Uniform MSR213 Magnetic Stripe Card Reader (USB - 3 Track Reader).
For tablet/mobile card readers: No such feature and recommendation yet.
You should buy the cash drawers that can be connected to pos printer. To use cash drawers, you printer should have the port to connect cash drawer as Bixolon SRP350II and Xprinter XP-Q200II.
For Browser Print, you might need to set your printer to open cash drawer before printing.
For Localhost/PHP POS Print Server, It will be fine as cash drawer will be opened with printing and can be opened without printing.
In the top bar there is monitor icon (Customer Display) to open customer display window. You need to have dual display setup to show the window to customer. To setup the dual display, please check the FAQ "How can I setup customer display in POS?".
Only Dual Display, No Digital Customer Display is Supported.
Any desktop laser print will work fine for barcode printing. The label print should work with label printer but the design is very simple and we will not offer any support to customize this. You can customize as you like or hire developer.
Role: Username Password
Admin: admin@tecdiary.com 12345678
Sales staff: salesman@tecdiary.com 12345678
Thanks to all the friends for their suggestions, feedback and help.
You can easily enable https by editing the 2 lines in config file (app/config/config.php
) as following:
http://yoursite.com
to https://yoursite.com
$config['cookie_secure']
to TRUEYes, you can modify the script as per your needs and license.
We offer Regular License only that allows you to use the Item to create one single End Product for yourself or for one client (a “single application”). If you have more then once clients, you will need to purchase separate license for each client.
You can visit this link to licensing faqs page of Evnato marketplace.
No, you can only manage 1 store with single installation. If you have more that 1 stores and want to use for all, you will need to purchase separate license for each store.
Yes, you can. Please update the settings with site name and logo.
Yes, Please modify the themes/default/views/pos/view.php as you need.
You can easily add new languages to Simple POS. Please click here to jump to guide.
You can install this item on localhost with any web platform xampp, mamp, lamp, wamp or easyphp. Internet connectivity is required for installation to verify the purchase. Once installed, you can use it without Internet.
Please click here to jump to hardware section.
Yes, you will get 100% source code including php, js, html and css.
Yes, CodeIgniter – PHP Framework created by EllisLab and is now a project of the British Columbia Institute of Technology.
Products quantity will automatically decreased upon sale and increased on adding purchase. You even can edit the product to change the quantity.
Once you add the product to order list, the item color will be red if you don't have quantity for the product. But Simple POS allows you sale items even if you don't have quantity and will set the quantity to negative.
Inclusive tax method means that tax is already included in the price. Exclusive tax method means that tax is not included in the price and should be calculated/added separately.
For example:
Product Price 100 and Tax 10%
Inclusive tax method: Price 90.91 and Tax amount: 9.09 = 100 (total price with tax)
Exclusive tax method: Price 100 and Tax amount: 10 = 110 (total price with tax)
The header and footer files are in themes/default/views/
Please modify the app_lang.php in app/language/english/. If you are not using English then see the file in app/language/yourLanguageFolder/
Please check that ini_set function is not disabled. The ini_set function should be enabled to use barcode feature.
Product level discount will be applied on the product price before any tax calculation.
i.e, Product Price - Product Discount + Product Tax (product tax calculated on Product Price - Product Discount)
Order level discount will be applied on the order total (total + product price) before any order tax calculation.
i.e, Order Total - Order Discount + Order Tax (order tax calculated on Order Total - Order Discount)
Yes, by modifying a line of code, please open themes/default/views/pos/view.php and search for window.print();
remove/comment it to disable print dialog.
Yes, by modifying a line of code, please open app/controllers/pos.php and search for redirect("pos/view/" . $sale['sale_id']);
replace it with redirect("pos");
Now after sale, system will redirect you back to POS instead of view receipt page.
You can click the monitor icon (Customer Display) in topbar at pos screen and then display it to your 2nd monitor. Here is the guide to setup dual display.
There are 3 options for printing
For those who can't manage to install (ppp), they can purchase PHP POS Print Server (Windows Installer).
These are the account type
Please visit list user and edit the user to reset the password.
If you want to delete account for staff member, please visit list users sub menu under people main menu. All the account are listed on this page and you can delete any of them.
Only Stripe payment gateway is available for processing credit cards in their supported countries. You can check https://stripe.com
API calls to server could take few seconds as the payment is processed after submit.
Yes, we will be exploring the new gateways.
If you are not getting any error but blank red alert or CloudFlare Security error mean your request is no reaching to verification server. Please check that you server is not blocking the curl request and secondly there are chances that CloudFlare might be challenging your request due to various reasons. Please check with your host and request them to white list CloudFlare ips https://www.cloudflare.com/ips
Updating your Anti-Virus and Browser might help. You can check with your host too.
You can try different host and/or install it locally with any web platform easyphp/lamp/mamp/wamp/xampp.
Please add the ? 'question sign' after index.php in the .htaccess file, you line will be look as RewriteRule ^(.*)$ /index.php?$1 [L]
code.
For more information, please visit this guide page.
After successfully installation/update, the installer/update tool will be automatically locked.
If you having any issue after installation or like to perform the installation again, please upload the files again.
Please
If you are using godaddy, please visit the codeigniter official guide here. You might need to check and modify you .htaccess files too.
Please
The time with Javascript and PHP could be different as javascript use your computer time but php will use your server time.
Please check your timezone in index.php and make sure that you have set the correct time zone. You can find your timezone at http://php.net/manual/en/timezones.php
We have tested the email function on different hosting servers. Please check with your host about this and if you need to check the code that will be in app/libraries/tec.php and look for send_email()
Timeout feature has been enabled. The user will be timed out after 3 unsuccessful login attempts for 10 minutes. You can disabled this in app/config/ion_auth.php by changing the
$config['track_login_attempts'] = TRUE;
to
$config['track_login_attempts'] = FALSE;
or you can increase the attempts from 3 to any number you like.
This could be due to permission on the /uploads. Please set 777 permission to /uploads and all other folder in the /uploads/
Please check your db configuration in app/config/database.php
Yes but we haven't tested this and don't provide any support for setup.
If URL Rewrite module is not installed, please install it from here http://www.iis.net/downloads/microsoft/url-rewrite. Please check the complete web.config file. Place this in the main installation folder where the index.php is placed.
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="Imported Rule 1" stopProcessing="true">
<match url="^(.*)$" ignoreCase="false" />
<conditions logicalGrouping="MatchAll">
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
</conditions>
<action type="Rewrite" url="index.php?url={R:1}" appendQueryString="true" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>
Yes but we haven't tested this and don't provide any support for setup.
You can follow the guide http://wiki.nginx.org/Codeigniter. Your nginx.conf file will look like this.
server {
server_name domain.tld;
root /var/www/codeignitor;
index index.html index.php;
# set expiration of assets to MAX for caching
location ~* \.(ico|css|js|gif|jpe?g|png)(\?[0-9]+)?$ {
expires max;
log_not_found off;
}
location / {
# Check if a file or directory index file exists, else route it to index.php.
try_files $uri $uri/ /index.php;
}
location ~* \.php$ {
fastcgi_pass 127.0.0.1:9000;
include fastcgi.conf;
}
location ~ /files {
deny all;
return 404;
}
}
There is no restriction in Simple POS on the number of order items. If you are having such issue, please check your php configuration file (php.ini) for max_input_vars
and set it to higher number i.e, 10000.
You can exclude sub-directory from RewriteRule of wordpress by adding the line below to your .htaccess file in main directory of wordpress.
RewriteCond %{REQUEST_URI} !^/(mydir|mydir/.*)$
Guide to add new language.
yourlanguagename
yourlanguagename
/
Please replace the yourlanguagename
with your language For example, spanish, french, chinese etc
To add select option in setting's language
Please open themes/default/views/settings/index.php
and search for ( $available_lang =
) You can replace the default
with your theme if you are using different theme. You can add new array key for your language as following:
$available_lang = array(
'english' => 'English',
'yourlanguagename' => 'Your Language Name',
);
yourlanguagename
must be same folder name that you created in app/language/
If you are getting the error "Unable to load the requested language file: language/yourlanguagename/form_validation_lang.php or calendar_lang.php
" Then you will need to add your language in lib/language/ as you did above for app/language/ and translate the system language files to your language.
Here are the steps to follow
To add a column you will need to
To remove a column you will need to
We have used datatables library for all listing tables. If you need to change any table sorting column, you will need to modify the view file.
The first column of the table will start from index 0 and then increase 1 with each columns. Let say you want to sort the table with 4th column then you will need to use index 3 as "aaSorting": [[3, "asc"]],
You can change the sorting for any table by modifying the files as described here.
For example, if you need to change the sorting for customers, you will need to edit the /theme/default/customers/index.php and search
"aaSorting": [[0, "asc"]],
This is being sorted for first table column, If you want to sort it by id (2nd table column) then you will need to change as
"aaSorting": [[1, "asc"]],
You even can sort the table with multiple columns as
"aaSorting": [[0, "asc"], [1, "asc"]],
Barcode page is designed to be printed with desktop laser printers. Barcode sheet or barcode pages have 2 columns' table (2 product per row and medium barcode image with 60px height). For labels, each label will be printed on different page as most of you will print label with label printers. We don't provide any support for modify the design.
If you need to modify any of the barcode/label page to show/remove any information, you can do so by modify the products controller. The functions are mentioned that handle the pages.
Functions/Methods handling the barcodes and labels pages are
single_barcode()
- Handles barcode printing for single productssingle_label()
- Handles label printing for single productsprint_barcodes()
- Handles barcode printing for multiple products based on categoryprint_lables()
- Handles label printing for multiple products based on categoryFile: app/controllers/products.php
We will provide the service to install the item for $20 To request the installation, please send $20 to support@tecdiary.com by Paypal or Skrill and email us your license file and hosting control panel details with reference of your payment to support@tecdiary.com
We will provide the service to update the item from v3 for $20 To request the update, please send $20 to support@tecdiary.com by Paypal or Skrill and email us your license file, v3 installation path/link with login details and hosting control panel details with reference of your payment to support@tecdiary.com
Yes, we do provide customization services to modify/enhance the item functionality to suit your needs. We charge $50 per hour. Please email to saleem@tecdiary.com to check availability, estimated cost and time.
Yes, we would love to listen your requests/feedback. Please prepare the details with examples before emailing to saleem@tecdiary.com