Current File : //home2/selectio/www/mm-tailor-billing/help/index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Simple POS is PHP and jQuery based web application. Simple POS is suitable for small and medium businesses/organization who can't afford expense solutions to manage their businesses.">
<title>Simple POS Documentation</title>
<link href="css/bootstrap.min.css" rel="stylesheet">
<link href="css/custom.css" rel="stylesheet">
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
<script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
<![endif]-->
</head>
<body>
<div id="wrapper">
<div class="navbar navbar-default navbar-fixed-top">
<div class="container-fluid">
<div class="navbar-header">
<a class="navbar-brand">Simple POS Documentation</a>
<button href="#menu-toggle" id="menu-toggle" type="button" class="navbar-toggle">
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<ul class="nav navbar-nav navbar-right hidden-sm hidden-xs">
<li><a target="_blank" href="http://support.tecdiary.com/">Paid Support</a></li>
<li><a target="_blank" href="http://codecanyon.net/item/simple-pos-point-of-sale-made-easy/3947976?ref=Tecdiary">Buy Simple POS</a></li>
</ul>
</div>
</div>
<div id="sidebar-wrapper">
<ul class="sidebar-nav nav">
<li class="sidebar-brand"><a href="#">SimplePOS</a></li>
<li><a class="scroll-to" href="#install">Install Guide</a></li>
<li><a class="scroll-to" href="#update">Update Guide</a></li>
<li><a class="scroll-to" href="#hardware">Hardware</a></li>
<li><a class="scroll-to" href="#demo">Demo</a></li>
<li><a class="scroll-to" href="#credit">Credits</a></li>
<li><a class="scroll-to" href="#faqs">FAQs</a></li>
<li><a class="scroll-to" href="#guide">User Guide</a></li>
<li><a class="scroll-to" href="#others">Others</a></li>
</ul>
</div>
<div id="page-content-wrapper">
<div class="container-fluid">
<div class="row">
<div class="col-lg-12">
<div class="jumbotron">
<h1 class="text-center">Simple POS - Point of Sale Made Easy</h1>
<p class="text-center">Simple POS is PHP and jQuery based web application.</p>
<p class="text-center">Documentation Version 1.2.0</p>
</div>
<div class="well">
<p><strong>Thank you for purchasing Simple POS - Point of Sale Made Easy</strong></p>
<p>
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
</p>
</div>
<div class="set" id="install">
<div class="set-description">
<h3>Installation Instruction</h3>
<p>Requirements: Apache 2.2+, Mysql 5.4+, PHP 5.4+ </p>
<ol>
<li>Copy/Upload the folder and files to your web server using cPanel or FTP</li>
<li>If you are installing in sub folder, please make sure there is no space in folder names</li>
<li>Create mysql database, database user and grant all permission to user for this database.</li>
<li>Open the <strong><code>http://yourdomain.com/pathtoupload/install/index.php</code></strong></li>
<li>Step 1: Pre-install system checklist - If there is any issue with checklist, you will need to fix it first to proceed to next step.</li>
<li>Step2: Provide you Envato Username and Purchase Code to validate the purchase.</li>
<li>Step 3: Provide the database host, database user, database password and database name to proceed to next step. <code>Please make sure you don't have $ sign in your password.</code></li>
<li>Step 4: Site Config: Please Fill in you Simple POS Base URL and select your timezone. <code>You must check the site url as installer might guess it wrong</code>
<ul>
<li>Base URL for public_html or www/htdocs folder will be <code>http://yourdomain.com/</code> or <code>http://localhost/</code></li>
<li>Base URL for sub-domain will be <code>http://subdomain.yourdomain.com/</code> </li>
<li>Base URL for sub-folder will be <code>http://yourdomain.com/subfolder/</code> or <code>http://localhost/subfolder/</code> </li>
<li>Base URL must not have space and it should end with a trailing slash</li>
</ul>
</li>
<li>If everything goes smooth, you will be redirect to final page with login details.</li>
<li>Remove the install folder before start using the Simple POS.</li>
<li>Login using default username and password. You should can add new admin account before deleting/editing default account.</li>
</ol>
<h4>Request Installation</h4>
<p>We will provide the service to install the item for $20 To request the installation, please visit support portal <a href="https://tecdiary.net/support">https://tecdiary.net/support</a></p>
</div>
</div>
<div class="set" id="update">
<div class="set-description">
<h3>Update Instruction (from 4.x to latest)</h3>
<p>Requirements: Apache 2.2+, Mysql 5.4+, PHP 5.4+ </p>
<ol>
</li>
<li><strong>Backup all your files and database.</strong> Save/download the backup. <strong>(MUST)</strong></li>
<li>Download <code>index.php</code>, <code>app/config/config.php</code> and <code>app/config/database.php</code></li>
<li>Delete all files and folders in yourinstallationdirectory/ except <code>uploads/</code> and <code>files/</code> folders to save your uploads</li>
<li>Extract the downloaded file.</li>
<li>Upload all the files and folders from extracted folder to yourinstallationdirectory/</li>
<li>Once all the files have been uploaded. We need replace back the config files downloaded in step 2</li>
<li>Upload the index.php, app/config/config.php and app/config/database.php saved in step 2 (replace the latest file with these)</li>
<li>
Open the <strong><code>http://yourdomain.com/yourinstallationdirectory/update/index.php</code></strong> and follow the instructions to update
<!-- OR<br>
Please import the sql files higher then your previous version from files/db_updates/ <br> You can import the files one by one starting from the next version (higher number to your previous version) using phpmyadmin after selecting your database. -->
</li>
<li>Once update successfully completed, you can login to your site using your admin credentials.</li>
</ol>
<h3>Updating from V3</h3>
<div class="highlight">
<p class="intro">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.</p>
<p>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.</p>
</div>
<h4>Please follow these steps to update from v3.x to beta v4.0</h4>
<ol>
<li><strong>Backup all your files and database.</strong> Save/download the backup. <strong>(MUST)</strong></li>
<li>Save/download database config file (<code>spos/config/database.php</code>) on your computer</li>
<li>Delete all old files/folders except <strong>assets/uploads</strong> as your product images and other upload data is in this <strong>assets/uploads</strong>.</li>
<li>Upload all the new files/folders (from your downloaded file).</li>
<li>Move all the contents of <strong>assets/uploads/</strong> to newly uploaded <strong>uploads/</strong> folder.</li>
<li>Once all the files are uploaded. We need to update the datase configuratiuon to the newly uploaded database configuration file (<code>app/config/database.php</code>) form the locally saved copy of database config file in step 2. <code>You need to update the hostname, username, password and database.</code>
<br>LETS ACCESS UPDATE TOOL FROM BROWSER, UPDATE TOOL WON'T ASK FOR DATABASE CONFIG AS WE HAVE ALREADY UPDATED THE DATABASE SETTINGS.</li>
<li>Open the browser and type <strong><code>http://yourdomain.com/pathtoupload/update/index.php</code></strong></li>
<li>Step 1: Pre-install system checklist - If there is any issue with checklist, you will need to fix it first to proceed to next step.</li>
<li>Step 2: Provide your Envato Username and Purchase Code to validate and update your license.</li>
<li>Step 3: Site Config: Please fill in you <strong>Base URL</strong> and select your timezone. <code>You must check the <strong>base url</strong> as update tool can guess it wrong.</code> This is the same base_url that you have in your old spos/config/config.php file
<ul>
<li>Base URL for public_html or www/htdocs folder will be <code>http://yourdomain.com/</code> or <code>http://localhost/</code></li>
<li>Base URL for sub-domain will be <code>http://subdomain.yourdomain.com/</code> </li>
<li>Base URL for sub-folder will be <code>http://yourdomain.com/subfolder/</code> or <code>http://localhost/subfolder/</code> </li>
<li>Base URL must not have space and it should end with a trailing slash</li>
</ul>
</li>
<li>If everything goes smooth, you will be redirect to final page with update complete message.</li>
<li>Remove the install and update folder before start using the Simple POS. If you find any issue with update, please let us know by posting at support portal <a href="https://tecdiary.net/support">https://tecdiary.net/support</a></li>
</ol>
</div>
</div>
<div class="set" id="hardware">
<div class="set-description">
<h3>Hardware</h3>
<p> </p>
<h4>1. Receipt Printers:</h4>
<p>
We have tested the update V4 with Bixolon SRP-350II (USB) and Xprinter XP-Q200II (LAN Interface).
</p>
<h4>Compatibility</h4>
<strong>Interfaces and operating systems</strong>
<p>The package used is known to work with the following OS/interface combinations:</p>
<div class="row">
<div class="col-md-6">
<table class="table table-stripe table-bordered">
<tbody>
<tr class="active">
<th> </th>
<th>Linux</th>
<th>Mac</th>
<th>Windows</th>
</tr>
<tr>
<th class="active">Ethernet</th>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/ethernet.php">Yes</a></td>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/ethernet.php">Yes</a></td>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/ethernet.php">Yes</a></td>
</tr>
<tr>
<th class="active">USB</th>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/linux-usb.php">Yes</a></td>
<td>Not tested</td>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/windows-usb.php">Yes</a></td>
</tr>
<tr>
<th class="active">USB-serial</th>
<td>Yes</td>
<td>Yes</td>
<td>Yes</td>
</tr>
<tr>
<th class="active">Serial</th>
<td>Yes</td>
<td>Yes</td>
<td>Yes</td>
</tr>
<tr>
<th class="active">Parallel</th>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/windows-lpt.php">Yes</a></td>
<td>Not tested</td>
<td>Yes</td>
</tr>
<tr>
<th class="active">SMB shared</th>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/smb.php">Yes</a></td>
<td>No</td>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/smb.php">Yes</a></td>
</tr>
<tr>
<th class="active">CUPS hosted</th>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/cups.php">Yes</a></td>
<td><a href="https://github.com/mike42/escpos-php/tree/master/example/interface/cups.php">Yes</a></td>
<td>No</td>
</tr>
</tbody>
</table>
</div>
</div>
<h4>List of Printers</h4>
<p>Many thermal receipt printers support ESC/POS to some degree. This driver has been known to work with:
</p>
<ul>
<li>AURES ODP-333</li>
<li>AURES ODP-500</li>
<li>Bixolon SRP-350III</li>
<li>Citizen CBM1000-II</li>
<li>Daruma DR800</li>
<li>EPOS TEP 220M</li>
<li>Epson TM-T88III</li>
<li>Epson TM-T88IV</li>
<li>Epson TM-T88V</li>
<li>Epson TM-T70</li>
<li>Epson TM-T82II</li>
<li>Epson TM-T20</li>
<li>Epson TM-T70II</li>
<li>Epson TM-U220</li>
<li>Epson FX-890 (requires <code>feedForm()</code> to release paper).</li>
<li>Excelvan HOP-E58</li>
<li>Excelvan HOP-E200</li>
<li>Excelvan HOP-E801</li>
<li>Excelvan ZJ-8220</li>
<li>Gainscha GP-5890x (Also marketed as EC Line 5890x)</li>
<li>Gainscha GP-U80300I (Also marketed as gprinter GP-U80300I)</li>
<li>gprinter GP-U80160I</li>
<li>Hasar HTP 250</li>
<li>Metapace T-1</li>
<li>Okipos 80 Plus III</li>
<li>P-822D</li>
<li>P85A-401 (make unknown)</li>
<li>Rongta RP326US</li>
<li>Rongta RP58-U</li>
<li>SEYPOS PRP-300 (Also marketed as TYSSO PRP-300)</li>
<li>Silicon SP-201 / RP80USE</li>
<li>Star TSP100 ECO</li>
<li>Star TSP-650</li>
<li>Star TUP-592</li>
<li>SPRT SP-POS88V</li>
<li>Xprinter F-900</li>
<li>Xprinter XP-Q800</li>
<li>Venus V248T</li>
<li>Zjiang NT-58H</li>
<li>Zjiang ZJ-5870</li>
<li>Zjiang ZJ-5890T (Marketed as POS 5890T)</li>
<li>Zjiang ZJ-5890K</li>
</ul>
<strong>Only ESC/POS compatible printers are supported.</strong>
<p> </p>
<h4>2. Barcode Scanners/Readers:</h4>
<p></p>
<p>
Any of the barcode scanners/readers will work fine with v4 as long as it can read accurately.
</p>
<p> </p>
<h4>3. Magnetic Card Readers:</h4>
<p></p>
<p>
Most of the Magnetic Card Readers will work fine. We have tested this with <strong>Uniform MSR213 Magnetic Stripe Card Reader</strong> (USB - 3 Track Reader).
</p>
<p>
For tablet/mobile card readers: No such feature and recommendation yet.
</p>
<p> </p>
<h4>4. Cash Drawers: </h4>
<p></p>
<p>
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.
</p>
<p><strong>For Browser Print,</strong> you might need to set your printer to open cash drawer before printing.</p>
<p><strong>For Localhost/PHP POS Print Server,</strong> It will be fine as cash drawer will be opened with printing and can be opened without printing.</p>
<p> </p>
<h4>5. Customer Display: </h4>
<p></p>
<p>
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?".
</p>
<p><strong>Only Dual Display, No Digital Customer Display is Supported.</strong></p>
<p> </p>
<h4>6. For barcode and label printing:</h4>
<p></p>
<p>
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.
</p>
</div>
</div>
<div class="set" id="demo">
<div class="set-description">
<h3>Live Demo For Simple POS - Point of Sale Made Easy.</h3>
<h4>Demo Link: <a href="https://spos.tecdiary.my/" target="_blank">https://spos.tecdiary.my/</a></h4>
<h4>Login Details:</h4>
<div class="smallshow">
<p><pre><strong>Role: Username Password</strong><br><strong>Admin:</strong> admin@tecdiary.com 12345678<br><strong>Sales staff:</strong> salesman@tecdiary.com 12345678</pre></p>
</div>
</div>
</div>
<div class="set" id="credit">
<div class="set-description">
<h3>Credits</h3>
<h4>Thanks to all great people who are developing open source software.</h4>
<ul>
<li><strong>CodeIgniter</strong> - PHP-Framework under <a href="http://www.codeigniter.com/userguide3/license.html">MIT License</a></li>
<li><strong>Ion_auth</strong> - A simple, lightweight authentication library by Ben Edmunds under the Apache License v2</li>
<li><strong>Bootstrap</strong> - Most popular HTML, CSS, and JS framework under MIT License</li>
<li><strong>jQuery</strong> - A fast, small, and feature-rich JavaScript library under MIT License</li>
<li><strong>Font Awesome</strong> - The iconic font and CSS toolkit under GPL License.</li>
<li><strong>DataTables</strong> - A plug-in for the jQuery under two licenses: GPL v2 license or a BSD (3-point) License</li>
<li><strong>Zend Framework 1</strong> (barcode library) - under New BSD License</li>
<li><strong>Moment.js</strong> - Moment.js is freely distributable under the terms of the MIT license.</li>
<li><strong>Bootstrap-datetimepicker</strong> - Date and Time picker widget based on bootstrap under Apache License V2</li>
<li><strong>iCheck</strong> - Highly customizable check boxes and radio buttons under MIT License</li>
<li><strong>Accounting.js</strong> - A tiny JavaScript library for number, money and currency formatting under MIT License</li>
<li><strong>jQuery Cookie</strong> - A simple, lightweight jQuery plugin to manage cookies under MIT License</li>
<li><strong>Commercial Licenses</strong>
<ul>
<li>Highcharts</li>
<li>FormValidator</li>
<li>Redactor Text Editor</li>
</ul>
</li>
</ul>
<p></p>
<p><strong>Thanks to all the friends for their suggestions, feedback and help.</strong></p>
</div>
</div>
<div class="set" id="faqs">
<div class="set-description">
<h3>Frequently Asked Questions</h3>
<div class="clear"></div>
<div class="faq">
<div class="faq-items">
<ul id="basics" class="faq-group">
<li class="faq-title"><h4>General</h4></li>
<li>
<a class="default">How to enable HTTPS support?</a>
<div class="faq-content">
<p>You can easily enable https by editing the 2 lines in config file (<code>app/config/config.php</code>) as following:
<ol>
<li>Update base url from <code>http://yoursite.com</code> to <code>https://yoursite.com</code></li>
<li>Set <code>$config['cookie_secure']</code> to TRUE</li>
</ol>
</p>
</div>
</li>
<li>
<a class="default">Can I modify the item?</a>
<div class="faq-content">
<p>Yes, you can modify the script as per your needs and license.</p>
<p>
We offer <a href="http://codecanyon.net/licenses/terms/regular" target="_blank">Regular License</a> 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.
</p>
<p>
You can <a href="http://codecanyon.net/licenses/faq">visit this link to licensing faqs</a> page of Evnato marketplace.
</p>
</div>
</li>
<li>
<a class="default">Can I manage multiple stores?</a>
<div class="faq-content">
<p>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.</p>
</div>
</li>
<li>
<a class="default">Can I white label it to have my company name and logo?</a>
<div class="faq-content">
<p>Yes, you can. Please update the settings with site name and logo.</p>
</div>
</li>
<li>
<a class="default">How can I change the receipt layout?</a>
<div class="faq-content">
<p>Yes, Please modify the themes/default/views/pos/view.php as you need.</p>
</div>
</li>
<li>
<a class="default">How can I translate into other language?</a>
<div class="faq-content">
<p>You can easily add new languages to Simple POS. Please <a class="scroll-to" href="#language">click here</a> to jump to guide.</p>
</div>
</li>
<li>
<a class="default">Can I install this item on localhost with wamp/xampp/easyphp?</a>
<div class="faq-content">
<p>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.</p>
</div>
</li>
<li>
<a class="default">Does it supports my barcode scanner/receipt printer/magnetic card reader?</a>
<div class="faq-content">
<p>Please <a href="#hardware">click here</a> to jump to hardware section.</p>
</div>
</li>
<li>
<a class="default">Will I get the full source code?</a>
<div class="faq-content">
<p>Yes, you will get 100% source code including php, js, html and css.</p>
</div>
</li>
<li>
<a class="default">Are you using a PHP Framework for this item?</a>
<div class="faq-content">
<p>Yes, <strong>CodeIgniter</strong> – PHP Framework created by EllisLab and is now a project of the British Columbia Institute of Technology.</p>
</div>
</li>
<li>
<a class="default">How do Simple POS track inventory?</a>
<div class="faq-content">
<p>
Products quantity will automatically decreased upon sale and increased on adding purchase. You even can edit the product to change the quantity.
</p>
</div>
</li>
<li>
<a class="default">Why I can sell the products even if I don't have quantity?</a>
<div class="faq-content">
<p>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.
</p>
</div>
</li>
<li>
<a class="default">What is the difference between inclusive and exclusive tax on add product page?</a>
<div class="faq-content">
<p>
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.
</p>
<p>For example:<br>
<code>Product Price 100 and Tax 10%<br>
Inclusive tax method: Price 90.91 and Tax amount: 9.09 = 100 (total price with tax)<br>
Exclusive tax method: Price 100 and Tax amount: 10 = 110 (total price with tax)</code>
</p>
</div>
</li>
<li>
<a class="default">Where are the header and footer view files?</a>
<div class="faq-content">
<p>
The header and footer files are in <code>themes/default/views/</code>
</p>
</div>
</li>
<li>
<a class="default">How can I change Quick Cash buttons?</a>
<div class="faq-content">
<p>
Please modify the app_lang.php in app/language/english/. If you are not using English then see the file in app/language/yourLanguageFolder/
</p>
</div>
</li>
<li>
<a class="default">Why barcode images are not showing on print barcode and label page?</a>
<div class="faq-content">
<p>Please check that ini_set function is not disabled. The ini_set function should be enabled to use barcode feature.
</p>
</div>
</li>
<li>
<a class="default">How does discount applied to the products and order?</a>
<div class="faq-content">
<p>
<strong>Product level discount</strong> will be applied on the product price before any tax calculation.<br>
<code>i.e, Product Price - Product Discount + Product Tax (product tax calculated on Product Price - Product Discount)</code>
</p>
<p>
<strong>Order level discount </strong>will be applied on the order total (total + product price) before any order tax calculation.<br>
<code>i.e, Order Total - Order Discount + Order Tax (order tax calculated on Order Total - Order Discount)</code>
</p>
</div>
</li>
<li>
<a class="default" href="#">Can I disable print dialog after submitting the sale on POS?</a>
<div class="cd-faq-content">
<p>
<strong>Yes, by modifying a line of code</strong>, please open themes/default/views/pos/view.php and search for <code>window.print();</code> remove/comment it to disable print dialog.
</p>
</div>
</li>
<li>
<a class="default" href="#">Can I auto redirect back to POS after submitting the sale on POS?</a>
<div class="cd-faq-content">
<p>
<strong>Yes, by modifying a line of code</strong>, please open app/controllers/pos.php and search for <code>redirect("pos/view/" . $sale['sale_id']);</code> replace it with <code>redirect("pos");</code> Now after sale, system will redirect you back to POS instead of view receipt page.
</p>
</div>
</li>
<li>
<a class="default" href="#">How can I setup customer display in POS?</a>
<div class="cd-faq-content">
<p>
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.
</p>
<p>
<ul>
<li><a href="https://youtu.be/-A56CaOO3v8" target="_blank">Setting Up Dual Monitors on Windows</a></li>
<li><a href="https://youtu.be/VOI-wVhV338" target="_blank">Set up Dual monitors on Windows laptop</a></li>
<li><a href="https://youtu.be/-MIKLP6bRnc" target="_blank">Set up Dual Displays on Mac</a></li>
<li><a href="https://youtu.be/OH5Ot6ObBls" target="_blank">Connect Multiple Monitors to MacBook Pro / Air </a></li>
</ul>
</p>
</div>
</li>
<li>
<a class="default" href="#">What are the printing options?</a>
<div class="cd-faq-content">
<p>
<strong>There are 3 options for printing</strong>
<ol>
<li><strong>PHP Server (only for LAN/localhost/Desktop)</strong><br>
If you have install the Simple POS locally, you can choose this option on the installed machine.</li>
<li><strong>Web Browser</strong><br>
To use the web browser's default printing.</li>
<li><strong>PHP POS Print Server</strong><br>
If you have installed the Simple POS on live/local server and want to access it from different machines, you will need to install PHP POS Print Server (ppp: <a href="https://github.com/Tecdiary/ppp">https://github.com/Tecdiary/ppp</a>). We recommend you to install it. Please set the local printers to yes to use the local ppp printers so that each machine could have separate printers. Then you will need to open ppp app to add local printers and set defaults.
</li>
</ol>
</p>
<p>For those who can't manage to install (ppp), they can purchase <a href="http://tecdiary.com/products/php-pos-print-server-windows-installer">PHP POS Print Server (Windows Installer)</a>.</p>
</div>
</li>
</ul>
<ul id="account" class="faq-group">
<li class="faq-title"><h4>Account and Users</h4></li>
<li>
<a class="default">What type of account are available?</a>
<div class="faq-content">
<p>
These are the account type
<ol>
<li>Admin</li>
<li>Sales Staff</li>
</ol>
</p>
</div>
</li>
<li>
<a class="default">I am Admin and how do I reset the password for sales staff user?</a>
<div class="faq-content">
<p>
Please visit list user and edit the user to reset the password.
</p>
</div>
</li>
<li>
<a class="default">How do I delete account?</a>
<div class="faq-content">
<p>
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.
</p>
</div>
</li>
</ul>
<ul id="payments" class="faq-group">
<li class="faq-title"><h4>Payments</h4></li>
<li>
<a class="default">What payment gateways are available in Simple POS?</a>
<div class="faq-content">
<p>
Only Stripe payment gateway is available for processing credit cards in their supported countries. You can check <a href="https://stripe.com" target="_blank">https://stripe.com</a>
</p>
</div>
</li>
<li>
<a class="default">Why Stripe payment take long time?</a>
<div class="faq-content">
<p>
API calls to server could take few seconds as the payment is processed after submit.
</p>
</div>
</li>
<li>
<a class="default">Will you be adding more payment gateways?</a>
<div class="faq-content">
<p>
Yes, we will be exploring the new gateways.
</p>
</div>
</li>
</ul>
<ul id="errors" class="faq-group">
<li class="faq-title"><h4>Error</h4></li>
<li>
<a class="default">Why am I getting CloudFlare Security or Blank error on verification while installing the item?</a>
<div class="faq-content">
<p>
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 <a href="https://www.cloudflare.com/ips" target="_blank">https://www.cloudflare.com/ips</a>
</p>
<p>
Updating your Anti-Virus and Browser might help. You can check with your host too.
</p>
<p>
You can try different host and/or install it locally with any web platform <strong>easyphp/lamp/mamp/wamp/xampp</strong>.
</p>
</div>
</li>
<li>
<a class="default">Why I am getting "no input specified" error after install/update?</a>
<div class="faq-content">
<p>
Please add the ? 'question sign' after index.php in the .htaccess file, you line will be look as <code>RewriteRule ^(.*)$ /index.php?$1 [L]</code>code.
</p>
<p>
For more information, please visit <a href="https://github.com/bcit-ci/CodeIgniter/wiki/Godaddy-Installation-Tips" target="_blank">this guide page</a>.
</p>
</div>
</li>
<li>
<a class="default">Why the installer/update tool is locked?</a>
<div class="faq-content">
<p>
After successfully installation/update, the installer/update tool will be automatically locked.
</p>
<p>
If you having any issue after installation or like to perform the installation again, please upload the files again.
</p>
</div>
</li>
<li>
<a class="default">Why am I getting 404 Not Found error page after installation?</a>
<div class="faq-content">
<p>
Please
<ol>
<li>make sure that your apache mod_rewite is enabled and configured to use .htaccess from site directory</li>
<li>check that .htaccess file is successfully uploaded and exists in the main directory of installation</li>
<li>base_url in app/config/config.php</li>
</ol>
</p>
<p>
If you are using godaddy, please visit the codeigniter official guide <a href="https://github.com/bcit-ci/CodeIgniter/wiki/Godaddy-Installation-Tips" target="_blank">here</a>. You might need to check and modify you .htaccess files too.
</p>
</div>
</li>
<li>
<a class="default">Why am I getting 500 Internal Server Error page after installation?</a>
<div class="faq-content">
<p>
Please
<ol>
<li>check your database settings in app/config/database.php</li>
<li>check your folders/files permissions (folders should have 755 and files should have 644 permissions).</li>
<li>check your server error log for more info or request your host to provide error log before posting comment as you should post with error details.</li>
</ol>
</p>
</div>
</li>
<li>
<a class="default">Why sale time is different from my computer time?</a>
<div class="faq-content">
<p>
The time with Javascript and PHP could be different as javascript use your computer time but php will use your server time.
</p>
<p>
Please check your timezone in index.php and make sure that you have set the correct time zone. You can find your timezone at <a href="http://php.net/manual/en/timezones.php" target="_blank">http://php.net/manual/en/timezones.php</a>
</p>
</div>
</li>
<li>
<a class="default">Why I can't send emails?</a>
<div class="faq-content">
<p>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 <code>send_email()</code></p>
</div>
</li>
<li>
<a class="default">Why I can't login and getting time out error?</a>
<div class="faq-content">
<p>
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
<code>$config['track_login_attempts'] = TRUE;</code>
to
<code>$config['track_login_attempts'] = FALSE;</code>
or you can increase the attempts from 3 to any number you like.
</p>
</div>
</li>
<li>
<a class="default">Why I can't upload any file?</a>
<div class="faq-content">
<p>
This could be due to permission on the /uploads. Please set 777 permission to /uploads and all other folder in the /uploads/
</p>
</div>
</li>
<li>
<a class="default">Why I getting db error and can't login?</a>
<div class="faq-content">
<p>
Please check your db configuration in app/config/database.php
</p>
</div>
</li>
<li>
<a class="default">Can I use this on Windows server with IIS?</a>
<div class="faq-content">
<p>
Yes but we haven't tested this and don't provide any support for setup.
</p>
<p>
If URL Rewrite module is not installed, please install it from here <a href="http://www.iis.net/downloads/microsoft/url-rewrite" target="_blank">http://www.iis.net/downloads/microsoft/url-rewrite</a>. Please check the complete web.config file. Place this in the main installation folder where the index.php is placed.
<pre><code><?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></code></pre>
</p>
</div>
</li>
<li>
<a class="default">Can I use this with NGINX?</a>
<div class="faq-content">
<p>
Yes but we haven't tested this and don't provide any support for setup.
</p>
<p>
You can follow the guide <a href="http://wiki.nginx.org/Codeigniter" target="_blank">http://wiki.nginx.org/Codeigniter</a>. Your nginx.conf file will look like this.
<pre><code>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;
}
}</code></pre>
</p>
</div>
</li>
<li>
<a class="default">Why some products are missing from order when I add 100+ products?</a>
<div class="faq-content">
<p>
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 <code>max_input_vars</code> and set it to higher number i.e, 10000.
</p>
</div>
</li>
<li>
<a class="default">Why Wordpress showing 404 page when I access the Simple POS?</a>
<div class="faq-content">
<p>
You can exclude sub-directory from RewriteRule of wordpress by adding the line below to your .htaccess file in main directory of wordpress.
<pre><code>RewriteCond %{REQUEST_URI} !^/(mydir|mydir/.*)$</code></pre>
</p>
</div>
</li>
</ul>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="set" id="guide">
<div class="set-description">
<h3>User Guide</h3>
<img src="images/pos.png" alt="SimplePOS" class="img-responsive img-thumbnail"><br><br>
<img src="images/db.png" alt="SimplePOS" class="img-responsive img-thumbnail"><br><br>
<img src="images/add_product.png" alt="SimplePOS" class="img-responsive img-thumbnail"><br><br>
<img src="images/sales.png" alt="SimplePOS" class="img-responsive img-thumbnail"><br><br>
<img src="images/report.png" alt="SimplePOS" class="img-responsive img-thumbnail"><br><br>
<img src="images/settings.png" alt="SimplePOS" class="img-responsive img-thumbnail">
</div>
</div>
<div class="set" id="others">
<div class="inner-set" id="language">
<div class="set-description">
<h3>Adding Language</h3>
<p>Guide to add new language.
<ul>
<li>Please create new folder in app/language/ and name it <code>yourlanguagename</code></li>
<li>Folder name should be without space and all lower letters.</li>
<li>Copy all the files from app/language/english/ and paste then to app/language/<code>yourlanguagename</code>/</li>
<li>Now you can translate these all file to your language</li>
<li>Download flag image (format: png, width: 16px, height: 11px) and paste it in themes/default/assets/images/</li>
<li>You can add new key to language array. (See Code Section)</li>
</ul>
</p>
<p>
Please replace the <code>yourlanguagename</code> with your language For example, spanish, french, chinese etc
</p>
</div>
<div class="set-dev">
<p>To add select option in setting's language</p>
<p>Please open <code>themes/<strong>default</strong>/views/settings/index.php</code> and search for ( <code>$available_lang =</code> ) You can replace the <code><strong>default</strong></code> with your theme if you are using different theme. You can add new array key for your language as following:<br><br></p>
<pre><code>$available_lang = array(<br> 'english' => 'English', <br> 'yourlanguagename' => 'Your Language Name', <br> );</code></pre>
<p><code>yourlanguagename</code> must be same folder name that you created in app/language/</p>
<p><strong>If you are getting the error "<code>Unable to load the requested language file: language/yourlanguagename/form_validation_lang.php or calendar_lang.php</code>" 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.</strong></p>
</div>
</div>
</div>
<div class="set">
<div class="inner-set" id="add_column">
<div class="set-description">
<h3>Add/Remove column to table</h3>
<p>Here are the steps to follow</p>
<p><strong>To add a column you will need to</strong></p>
<ol>
<li>Modify the select statement and select the desired column, in the controller.</li>
<li>Add new element to datatables columns (should be in sequence) in the relative view file.</li>
<li>Lastly add the th tag with column heading to table head (should be in sequence).</li>
</ol>
<p><strong>To remove a column you will need to</strong></p>
<ol>
<li>Modify the select statement and remove the desired column, in the controller.</li>
<li>Remove the element form columns of datatables in the relative view file.</li>
<li>Lastly Remove the th tag with column heading to table head.</li>
</ol>
</div>
</div>
</div>
<div class="set">
<div class="inner-set" id="datatable">
<div class="set-description">
<h3>Sorting Tables</h3>
<p>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.</p>
<p>
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 <code>"aaSorting": [[3, "asc"]],</code>
</p>
<p>
You can change the sorting for any table by modifying the files as described here.
</p>
</div>
<div class="set-dev">
<p>
For example, if you need to change the sorting for customers, you will need to edit the /theme/default/customers/index.php and search
</p>
<pre><code>"aaSorting": [[0, "asc"]],</code></pre>
<p>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 </p>
<pre><code>"aaSorting": [[1, "asc"]],</code></pre>
<p>You even can sort the table with multiple columns as </p>
<pre><code>"aaSorting": [[0, "asc"], [1, "asc"]],</code></pre>
</div>
</div>
</div>
<div class="set">
<div class="inner-set" id="barcode">
<div class="set-description">
<h3>Barcodes and Labels</h3>
<p>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.</p>
<p>
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.
</p>
</div>
<div class="set-dev">
<p>
Functions/Methods handling the barcodes and labels pages are
<ul class="s-ul">
<li><code class="white">single_barcode()</code> - Handles barcode printing for single products</li>
<li><code class="white">single_label()</code> - Handles label printing for single products</li>
<li><code class="white">print_barcodes()</code> - Handles barcode printing for multiple products based on category</li>
<li><code class="white">print_lables()</code> - Handles label printing for multiple products based on category</li>
</ul>
</p>
<p>File: <code>app/controllers/products.php</code></p>
</div>
</div>
</div>
<div class="set">
<div class="inner-set" id="support">
<div class="set-description">
<h3>Request Installation</h3>
<p>
We will provide the service to install the item for $20 To request the installation, please visit support portal <a href="https://tecdiary.net/support">https://tecdiary.net/support</a>
</p>
</div>
<div class="set-description">
<h3>Request Update</h3>
<p>
We will provide the service to update the item from v3 for $20 To request the update, please visit support portal <a href="https://tecdiary.net/support">https://tecdiary.net/support</a>
</p>
</div>
<div class="set-description">
<h3>Custom Modifications</h3>
<p>
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.
</p>
</div>
<div class="set-description">
<h3>Feature Request</h3>
<p>Yes, we would love to listen your requests/feedback. Please prepare the details with examples before emailing to saleem@tecdiary.com</p>
</div>
</div>
</div>
<div class="clear"></div>
</div>
</div>
</div>
</div>
</div>
<script src="js/jquery.js"></script>
<script src="js/bootstrap.min.js"></script>
<script>
$("#menu-toggle").click(function(e) {
e.preventDefault();
$("#wrapper").toggleClass("toggled");
});
$('body').scrollspy({ target: '#sidebar-wrapper', offset: 80 })
$(".scroll-to").click(function(e) {
e.preventDefault();
var did = $(this).attr('href');
console.log(did);
$('html,body').animate({
scrollTop: (($(did).offset().top)-50)},
'slow');
});
</script>
</body>
</html>
Mini Shell