Documentation

Shopperzz - PWA eCommerce CMS with POS & WhatsApp Ordering | Inventory Management

Thank you so much for purchasing our item from codecanyon.


  • Created: 27 July, 2024
  • Updated: 19 November, 2024

If you have any questions that are beyond the scope of this help file, Please feel free to email via Item Support Page.


Basic

To install, set up, and customize Shopperzz with your branding, it is essential to have a basic understanding of server-side operations. The system includes a comprehensive suite of features for web applications.

  • IDE for Web development, we preferred VSCode.
  • Real Server related knowledge like apache or local machine server, we preferred to use a real server.
  • Server related knowledge and we preferred cPanel in your server for quick installation
  • Basic knowledge in PHP, NPM, Vue, Node, Laravel if you want to do some customization yourself (Not compulsory).

Note: Remember! Envato's pricing does not cover installation. It is your responsibility to follow the installation instructions outlined in the documentation, as well as any necessary steps for setup and branding-related changes. We are not liable for any errors you may make during the process. Additionally, any customizations you make are entirely your responsibility.


Server

Before install, please make sure you have the components bellow enable on your server

  • PHP 8.2 or Greater
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • BCMath PHP Extension
  • GD PHP Extension (or Imagick PHP Extension)
  • PHP Zip Archive
  • PHP JSON
  • PHP cURL
  • PHP Exif
  • PHP fileinfo
  • PHP Zip Archive
  • Rewrite Module (Apache or Nginx)
  • open_basedir must be disabled

Typically, these extensions are enabled by default on most servers, but it is recommended that you confirm with your hosting provider.

Please proceed with caution and take great care in completing this task. Any errors made will not be the responsibility of our team.


Active Purchase Key:

Before install, please active your envato purchase key from our system and install project by our license key

  1. Goto inilabs official site inilabs.net
  2. Now create an account in our site

  3. Click the below link and verify your email

  4. Now click Active Purchase Key from home page and fill you information
    1. Select your product
    2. Enter your domain, Which domain you would be using this product
    3. Enter your envato purchase key and click submit

  5. Now copy your Active License and install the product by this license

Tips Check the video tutorial!



Installation

Tips Check the video tutorial!

Note: Remember! The script doesn't have any "install" folder or directory. The installation is controlled by a Controller.

Now Follow the steps below to setup the script:

  1. Unzip the downloaded package from here and open the /Source Code folder to find all the Script zip. You will need to upload the Script.zip file to your hosting web server using FTP or localhost, then you need to unzip this file, you will find "shopperzz" folder. You need to move all files and folders in your domain's document root directory.
  2. Your will have these files and folders in your document root:
  3. Make sure /bootstrap and /storage folder have permission as 755 recursively. If you don't have 755 permission in this two folder, you have to give permission manually. To give permission right click on the folder and click "Change permission" button, you will see the prompt to change permission like the second image below. Select the checkboxes you can see in the second image.
  4. Before starting the installation, database must be configured for the application.For creating the database, the following ways must be maintained
    • From cPanel Go to MySQL Databases
    • Create a new database
    • Create a user for the database
    • Add a user to the database
    • Give privileges to the user
  5. Run the install script path from any web browser (http://yourdomain.com/install) and click on “Check Requirements” button.
  6. Now you can see your php extension list if it is already installed in all extension then you can see "Check Permissions" button. Now click on this button and go to next step
  7. Now you will see the folders permission list if everything is ok then click “Site Setup”
  8. Provide your App name and Domain name as App Url, then click “Database Setup”
  9. Provide your database information like Database Host, Database Port, Database Name, Database Username, and Database Password, then click “Final Setup”
  10. Now you will see the login information (Email : admin@example.com , Password : 123456) then click “Finish” to exit
  11. Good Luck!!!

Firebase Push Notification Setup

Tips Check the video tutorial!

To use firebase follow the procedure which are mentioned below
  1. Go to this URL to create a project https://console.firebase.google.com/u/0/. If you already have a project, continue with that.
  2. Then go to Project Settings and create an app.
  3. In Project Settings > General > "your created app", you will find apiKey, authDomain, projectId, storageBucket, messagingSenderId, appId, measurementId.
  4. Click on "Cloud Messaging". There you will find a button named "Generate key pair". Click it to get the KEY PAIR.
  5. Now in Project Settings, click "Service Account". There you will find a "Generate new private key" button. Click this button to get a JSON file.
  6. Then go to your "shopperz" admin Dashboard > Settings > Notification. Enter your credentials and save them.
  7. Now it's done.

Business Setup

Within the administrative panel, we provide a designated section known as "Settings" This particular area empowers you to configure various essential aspects of your business, such as your Company, Site, Mail, Shipping Setup, OTP, Notification, Notification Alert, Social Media, Cookies, Analytics, Theme, Sliders, Currencies, Product Categories, Product Attributes, Product Brands, Return Reasons, Suppliers, Outlets, Benefits, Units, Taxes, Pages, Role & Permissions, Languages, Sms Gateway, Payment Gateway settings.

Tips Check the video tutorial!


Payment Gateway Configuration

In our initial version we are giving 14+ integrated Payment Gateways for use. Admin can setup these payment gateways from the admin panel payment settings.


SMS Gateway Configuration

We have 8 sms gateway integrated in the system which admin can setup that from admin panel -> sms settings.


How to change or customize a language?

Translate your admin and website, follow these steps:

  1. Login into the admin panel.
  2. Goto settings -> Languages.
  3. Click On Add Language.
  4. Fill all field and add new language.
  5. Click on the view icon of the new language low in from the list.
  6. Select file from the dropdown option under Files tab and click get file content.
  7. All the lebels and language objectives will appear in the bottom of the field.
  8. Now update the value of all the input fields and click save.
  9. You do not change any word under the curly bracket text {}, example {name}.
  10. When all language is changed then run some command in your terminal or ssh panel.
npm install npm run prod


Addon Installation

Right Now We do not have any addons with the script:


Support

If this documentation doesn't answer your questions, So, Please send us Email via Item Support Page

We are located in GMT +6:30 time zone and we answer all questions within 12-24 hours in weekdays. In some rare cases the waiting time can be to 48 hours. (except holiday seasons which might take longer).

Note: While we aim to provide the best support possible, please keep in mind that it only extends to verified buyers and only to issues related to our script's like bugs and errors. Custom modifications or third party module implementations are not included.

Don’t forget to Rate this script

Please Add your Review (Opinion) for Our script. It would be a great support for us.
Go to your Codecanyon Profile > Downloads Tab > & then You can Rate & Review for our script.
Thank You.

Changelog

Version 1.3 (19 November, 2024)

  • Added midtrans payment gateway
  • Summary of sales and Product report
  • PDF download feature in reports
  • Payment options in POS order
  • POS discount minor bug fix
  • Stripe minor bug fix

Version 1.2 (03 October, 2024)

  • Product import feature added
  • Product category export & import feature added
  • Price filter responsive minor bug fix
  • Return product minor bug fix
  • Responsive minor bug fix
  • Coupon remove minor bug fix

Version 1.1 (21 August, 2024)

  • Added Iyzico payment gateway
  • Added Pesapal payment gateway
  • Added Telr payment gateway
  • Notification minor bug fix
  • Responsive minor bug fix
  • Cart minor bug fix
  • Coupon minor bug fix

Version 1.0 (27 July, 2024)

  • Initial Release

How to get latest version and How to update Your Current Version to New Version?

Download latest version from here or if you want us to upgrade your current system then you can take one of our premium support plan from here