Others

Graph/Chart not displaying

Graph/Chart doesn’t work as expected when you don’t follow the installation guide properly. To make sure it works you should install it using the installation guide.

NOTE: not following the installation process will have many other additional other problem, so we always recommend to follow it.

If you have followed the installation guide and then also it is giving this problem then follow the below-given solution.

Alternate Solution:

Open the .env file which is present inside the pos codebase. In the .env file, you will find “APP_URL“, set the correct value of the url in here.

For example, if the POS URL is http://pos.ultimatefosters.com then APP_URL=http://pos.ultimatefosters.com

Increasing/Decreasing upload documents & images size limit

Logo or Image not Getting displayed

If you’re using UltimatePOS version 2.11.4 do this: https://ultimatefosters.com/ultimate-pos/update-guide-updating-ultimate-pos/#NOTE_If_you8217re_updating_from_V2113_to_V2114_or_higher_then_do_these_additional_steps

In UltimatePOS version 2.11.2 we implemented an easy way to fix images issue.

  1. Login in UltimatePOS with Administrator account (or superadmin account)
  2. Go to <pos_directory>/public directory via FTP or cPanel and delete “storage” directory if present. This may or may not be present.
    PS: don’t delete <pos_directory>/storage.
  3. Run www.yourwebsite.com/install/fix-image and it will fix the image issue. If it displays some error the check the error information as given below.

If you’re using a lower version then 2.11.2 then follow the below steps or update your version.

  1. This can happen if the “symbolic link” is not created successfully during installation steps.
  2. Go to <pos_directory>/public and delete “storage” directory if present. This may or may not be present.
    PS: don’t delete <pos_directory>/storage.
  3. If you’re using in localhost then open your command prompt (cmd) or if in hosting server then use shell access to login via terminals. Contact your hosting provider if you need details on accessing via terminal.
  4. Go to pos directory:
    cd <pos_directory> 
  5. in the pos directory run the below command:
    php artisan storage:link
  6. If it shows success then check your application, it should show the images now.

If it shows some error like:

White Labeling & Rebranding SenangUrus Business

A white label product is a product or service produced by one company (the producer) that other companies (the marketers) rebrand to make it appear as if they had made it.

Ultimate POS allows you to white label the product with your company name and resell it as per purchase license rules.

To white label the application:

During installation, it asks for Application name & Application title. Simply use your company name or your branded product name as the name of the application. Also, give a meaning title to it.

– Now the name you entered will be displayed in Landing Page & also in the footer of the application.

– You can also change the application name after installation. Simply open .env file present in the root folder of the application and change the APP_NAME & APP_TITLE value.

Tips & Tricks for using SenangUrus Business effectively.

Improving Browser based Print (Receipts or other)

Create Shortcuts for web application

Website to Desktop apps in One-Click

Browser Full-Screen mode or distraction-free mode

Barcode Scanner Trick

Do you have a particular Trick to improve user experience? Share with us here

Bookmark this link, as we will keep updating it.

Decimal Precision for Currency & Quantity

Some countries like Bahrain, Kuwait, Tunisia, Oman, etc has 3 decimal currencies. So with this feature, you can adjust the decimal significant figures for currency & quantity.

The default precision is 2 for currency & quantity if you want to change it follow the below steps:

Go to Settings -> Business Settings. Here you can enter the required decimal precision for quantity and currency.

If you are using version 4.7.7 or below, follow the below steps to change the decimal precision.

  1. Go to config/constants.php
  2. Change currency_precision value to change the precision for currency. The maximum is 4.
  3. Change quantity_precision value to change the precision for quantity. The maximum is 4.

Adding Favicon, Login & Registration page background image

Adding Favicon

To change the Favicon.ico image go to /public  folder and replace the favicon.ico file present there.

Clear cache of your browser and it will start to show the new image you added.

Changing Logo in Login & Registration page

Replace the image pos\public\img\logo-small.png

Keep the new image name as “logo-small.png”

Changing Background Colour in Login Page

How to change the blue background in the login page?

To change the blue background in the login page, check the css file and change the line as mentioned below.

Step 1: Login to your server and open the codebase files for UltimatePOS.

Step 2: Go to pos\resources\views\layouts\partials\extracss_auth.blade.php and edit line no 15. Add the required color code here.

Setting Background Image in Login/Registration and Pricing Page

You can change the default blue background in the Login Page, Registration Page, and Pricing Page by updating the style file.

Step 1: Go to pos\resources\views\layouts\partials\extracss_auth.blade.php

Step 2: Inside this file, you will find the code for both background image and background color.

Step 3:

To apply your choice:

Changing Application Name in Landing page

To change the application name in the landing page, follow the steps given below

Step 1: Open .env file present in your codebase.
Step 2: Search for APP_NAME.
Step 3: Change the value for the APP_NAME =”examplePOS” as required.

How can I display the login page instead of the landing page? (Making login page as the landing page)

If you want to redirect the landing page of your POS system to login page page, you can modify the route in the pos/routes/web.php file to call the login blade instead of the welcome blade.

This will display the login page instead of the default welcome page when the POS system is accessed.

To change the route and call the login blade, follow these steps:

  1. Open the routes/web.php file in your code editor.
  2. Search for the route that specifies the view for the welcome blade file.
  3. Replace the view name with the name of the login blade file.
  4. Save the changes to the routes/web.php file.

For more information on using blade templates in Laravel, refer to the Laravel documentation at https://laravel.com/docs/10.x/blade.

If you need to pass data to the view, you can refer to this guide at https://www.geeksforgeeks.org/different-ways-for-passing-data-to-view-in-laravel/.

For more information on file paths in UltimatePOS, refer to this documentation at https://ultimatefosters.com/docs/ultimatepos/technical/different-files-path/.

Export Feature

Export Feature in UltimatePOS

Ultimate POS allows you to export your data into either Excel, CSV, or pdf files. You can export your sale, purchase, products, categories, all your reports, etc.

On the top of every data table, you can find export buttons as shown in the image below.

Removing columns from the data table

If you want to remove the action column or any other column while exporting the data, use the column visibility feature. Select the columns that are to be removed and then click export.

Login Session Time

Increasing the login session time:

Follow the file path below to increase the login session time of your SenangUrus Business.

config/session.php

Issue: Product not shown on view

Sometimes, you may encounter an issue where the “List Products > View” function does not work.
This problem may arise from the permission restrictions for the uploads folder in the code base.

  1. Log in to your server and find the pos/public/uploads folder. Then, change the permission to ‘777’.
  2. Save the file and try to view the product again.

If you still have the issue, open a ticket in support and post the issue.

Solution for Sell Delete Not Working Issue

Error: Deleting Sale Not Working, shows “Something Went Wrong Please Try again Later”

Issue:

Sometimes, when attempting to delete a sale, the system may display the following error: “Something went wrong. Please try again later.”
This usually occurs due to a database configuration issue.

Solution:

Follow the steps below to diagnose and fix the issue:

Step 1: Check the Error Log

Navigate to your application’s log file located at: pos/storage/logs/laravel.log

Step 2: Identify the Error

If the log shows the following error: General error: Prepared statement needs to be re-prepared

Step 3: Update Database Configuration

Open the database configuration file located at:

pos/config/database.php

Find the MySQL configuration block and ensure it includes the following option:

‘mysql’ => [
‘driver’ => ‘mysql’,
‘url’ => env(‘DATABASE_URL’),
‘host’ => env(‘DB_HOST’, ‘127.0.0.1’),
‘port’ => env(‘DB_PORT’, ‘3306’),
‘database’ => env(‘DB_DATABASE’, ‘forge’),
‘username’ => env(‘DB_USERNAME’, ‘forge’),
‘password’ => env(‘DB_PASSWORD’, ”),
‘unix_socket’ => env(‘DB_SOCKET’, ”),
‘charset’ => ‘utf8mb4’,
‘collation’ => ‘utf8mb4_unicode_ci’,
‘prefix’ => ”,
‘prefix_indexes’ => true,
‘strict’ => false,
‘engine’ => null,
‘options’ => extension_loaded(‘pdo_mysql’) ? array_filter([
PDO::MYSQL_ATTR_SSL_CA => env(‘MYSQL_ATTR_SSL_CA’),
\PDO::ATTR_EMULATE_PREPARES => true, // Add this line
]) : [],
],
Important: Make sure the line \PDO::ATTR_EMULATE_PREPARES => true is included under the options array. This setting helps prevent the “re-prepared” error by enabling emulation of prepared statements.

Step 4: Save Changes

After updating the configuration save the file.

Adding/Modifying Currency in ultimatepos

With UltimatePOS we have tried to include many currencies inbuilt in the system. But we have missed some of them, sorry for that!!

No worries, still you can add any new currency into the system.

  1. To add new currency open the database table which is used for UltimatePOS. Go to table currency
  2. Click on “Insert” new row option.
  3. Fill your currency details as below and save it.
    • country
    • currency
    • code
    • symbol
    • thousand_seperator
    • decimal_seperator

Great, Your currency is added now.