Bazaaroka Marketplace Script v4.2

by MHDscripts

Getting Started

Thank you for purchasing this solution.
If you need help, feel free to contact us via our helpdesk.

Introduction

Bazaaroka is a marketplace script that you can sell physical and digital products. You can use this script as a multi-vendor store through the add-on "Multi-Sellers" or you can use it as a store where you can sell your own products and services. Bazaaroka has a clean, responsive and user-friendly design. You can manage almost everything in your site with its powerful Admin panel. It is secure, SEO-optimized, fast, fully customizable and easy to use. Start your own online eshop marketplace and learn from the giants in the e-commerce industry such as: ebay, amazon, souq, retailo, muqbis, ovko, merxu, breedr, rooser, timberhub, vanilla steel, metaloop, vosbor, change, whop, norban, africa sokoni, baytonia, farmitoo and much more.

• PHP CodeIgniter
• HTML 5
• CSS 3
• Bootstrap 4
• JQUERY
• AJAX

• Clean and Responsive Design
• Built Using Bootstrap 4
• Totally Secure System
• Seo Optimized
• SEO-Friendly URL
• RTL Support
• Progressive Web Apps (PWA) Support
• Selling Physical Products
• Selling Digital Products
• Selling License Keys
• Bidding System
• Classified Ads (Adding a product or service as an ordinary listing)
• Multi-Vendor System (With enable & disable option)
• Multilingual System (Any language can be added easily)
• Accept Payments via Internal Wallet, Cash on Delivery "COD", Stripe, PayPal, CoinPaymnents, PayStack, Razorpay, Flutterwave, PayTabs, Iyzico, and Midtrans Payment Gateways
• Accept Payments via Bank Wire / SEPA / IPA, Western Union / Moneygram and any manual payment
• Cash on Delivery
• Guest Checkout
• Help Center (With Ticket System and Knowledge Base)
• Refund System
• Membership Packages System
• Vendor Dashboard
• Earnings
• Payouts
• PayPal, IBAN and SWIFT Payment Options for Payouts
• Currency Options (With different currency format options)
• Report Abuse Option for Products, Sellers, Comments and Reviews
• Email Notifications
• Commission Rate for Sales
• Bank Transfer Notifications
• Editable & Sortable Navigation (With mega menu)
• Responsive & Sortable Slider (With show & hide Option)
• Bulk Product Upload
• Promoted Products (With enable & disable option and editable Daily and Monthly pricing)
• Pending Products
• Hidden Products
• Drafts
• Product Location Map
• Image, Video, Audio and URL Preview Options
• Add, Edit, Delete Unlimited Product Categories
• Bulk Category Upload
• Custom Fields System (A new field can be added easily)
• Product Variations (Add available options, like color or size that buyers can choose during checkout)
• AWS S3 Integration
• Coupons System
• Cache System
• RSS Feeds
• Social Login (Facebook, Google and VKontakte)
• Payment Settings
• Advance Search (Products and Members)
• Filter & Sort Porducts
• Member Profile Pages
• Last Seen Time
• Update Profile Information & Change Password
• Location Settings & Social Links for Members
• Favorites (Add & Remove from List)
• Follow & Unfollow Members
• Messaging System (With notification)
• Seller Widget
• Related Products
• Pageview Counts
• Social Sharing
• Lazy Image Loading
• Blog Section
• Add, Edit, Delete Unlimited Blog Posts
• Add, Edit, Delete Unlimited Blog Categories
• Dynamic Tag System for Blog Posts
• Comment System for Blog Posts (With enable & disable option)
• Adding Unlimited Fully Editable Pages
• Show & Hide Options for Page and Page Title
• Editable Location Database
• Multi-Countries and One Country Options (You can use only for your country)
• Responsive Ad Spaces for Any Kind of Ad Codes (Including Adsense)
• Create Ad Codes
• Review System (With enable & disable option)
• Comment System (With enable & disable option)
• Comment Approval System (With enable & disable option)
• Facebook Comments
• Newsletter (Send email to subscribers)
• HTML Email Template
• Membership System
• Roles & Permissions System
• Secure Authentication
• Vendor Verification System(With verified icon)
• Email Verification System (With enable & disable option)
• Password Reset
• Add New Administrators
• Manage Registered Users
• Ban User Accounts
• Maintenance Mode
• Seo Tools
• Sitemap.xml Generator with Cron Job Function
• Contact Page (With Google Map and send contact messages to email address option)
• Editable Admin Panel Link
• Editable Product Link Structure
• 12 Layout Colors
• Visual Settings
• Watermark System
• Change Logo, Favicon, Site Title, Site Description, etc. from Admin Panel
• Google reCAPTCHA Integrated
• Rich Text Editor
• Cookie Warning for GDPR
• Social Media Links
• Google Analytics
• Advanced Settings Options
• Form Settings
• Easy Installation Using Installation Wizard
• Detailed Documentation
• Runs on PHP 7.4, 8.0, 8.1, 8.2

• Cross-Site Request Forgery (CSRF) Prevention
• Cross-Site Scripting (XSS) Prevention
• Password Hashing
• Avoiding SQL Injection

• PHP = 7.4 or 8.0 or 8.1 or 8.2
• MySQL
• Extensions : JSON, Mbstring, OpenSSL, EXIF, Fileinfo, Curl PHP extension

Files

• AdminLTE.min.css and _all-skins.min.css: Contains general css codes for admin panel.
• bootstrap-toggle.min.css: Contains bootstrap toggle css codes.
• custom.css: Contains css fixes for admin panel.
• style.css: Contains main css codes.
• colors css files: Contains color options.
• Style.css file is separated into sections using:
  
  /* ============ 1. General layout CSS styles ============ */
  code
  /* ============ 2. Header ============ */
  code
  /* ============ 3. Slider ============ */
  code
  etc, etc.
  

• jquery-3.3.1.min.js: Javascript library
• adminlte.js: This file contains general dashboard script codes.
• bootstrap-toggle.min.js: Contains bootstrap toggle javascript codes.
• script.js: Contains custom script codes. There are custom functions and ajax post functions
• jquery.cookie.js: JavaScript library for handling cookies
• plugins.js: Contains javascript plugins for front-end.
  
  Js files are separated into sections using:
  //ajax post delete image
  code
  //datatable function
  code
  etc, etc.
  

• jQuery
  jQuery is a Javascript library that greatly reduces the amount of code that you must write.
• jQueryUI
  jQuery UI is a curated set of user interface interactions, effects, widgets, and themes built on top of the jQuery JavaScript Library.
• Ckeditor
  CKEditor is a browser-based WYSIWYG content editor.
• Datatables
  DataTables is a plug-in for the jQuery Javascript library. It is a highly flexible tool, based upon the foundations of progressive enhancement, and will add
  advanced interaction controls to any HTML table.
• ICheck
  Highly customizable checkboxes and radio buttons.
• Tagsinput
  jQuery plugin providing a Twitter Bootstrap user interface for managing tags
• Magnific Popup
  Jquery Gallery plugin
• Owl-Carousel
  Responsive jquery slider plugin
• Sweetalert
  Jquery-confirm plugin

Installation

License Code

You can follow these steps to install the script:

• Go to cPanel and Click MySQL® Databases
  
  



• Create New Database
  
  



• Add New User
  
  



• Add User To Database
  
  



• Set User Permissions
  
  

1. Open your cPanel and go to File Manager section.
   
   
   
   
2. Go to main directory of your site. Most of the time this folder will be "public_html".
   
   
   
   
3. Open this folder and upload script.zip file to this folder.
   
   
   
   
4. Rigth click the .zip file and select Extract option.
   
   
   
   
5. Move all files that in the "script-v.." folder to main directory.
   
   
   
   
6. Delete unnecessary files/folders: "documentation", "script-v.." and "script.zip".
   
   
   
   

   Make sure that the .htaccess file exists in this directory. If you cannot see it, click Settings button at the top right corner and select Show Hidden Files (dotfiles) option. Also, cPanel can automatically change the content of this file. Please open this file and make sure the content of this file is like .htaccess below.

   If you are using NGINX server, .htaccess will not work on your server. In this case, you need to make these settings in your server: NGINX configuration for CodeIgniter
   Also, our script does not start from the "public" folder. So you should not add '/public' to your root variable in the server configuration file.

.env Configuration File

This file contains some general settings for your site.

CI_ENVIRONMENT: Default value of this variable is "production". This option will not display if there is an error on your site. Instead, you will see the "An error occurred!" message. To see the errors, you need to change the value of this variable to "development".

Example:
CI_ENVIRONMENT = development

app.baseURL: This is your site base URL. It is very important to add your correct site URL to this field. If you add a wrong site URL, your site will not work.

Examples:
Installing to Main directory:
app.baseURL = https://domain.com
Installing to subdomain:
app.baseURL = https://demo.domain.com
Installing to folder:
app.baseURL = https://domain.com/new

LICENSE_KEY: You need to enter your license key to this field.

PAYMENT_ICONS: You can delete the payment icons that you don't want to show on your website from this line. These icons will be displayed on the footer section and cart page.

cookie.prefix: This value is used for cookies to avoid collisions. Default value is "mds_", but you can change this value and add a unique value for your site. You must not add a special character to this field.

File Upload Settings

1. Go to your cPanel and click "Select PHP Version"
   
   
   
   
2. Then click "Switch to PHP Options"
   
   
   
   
3. Then set the values "upload_max_filesize", "post_max_size" and "memory_limit" as you see in the picture.
   
   
   
   

Quick Start

✓  Accessing Admin Panel: After installation, you will be redirected to home page. Login with your Admin email and password. After login, you will see your username in the navigation, click your username and click "Admin Panel" link on the dropdown menu.



✓  Updating Profile Information: Go to the main navigation, click your username and click "Settings" link on the dropdown menu. In this page you can edit your Email Address, Username, Slug and you can add some text about yourself.

✓  Changing Admin Password: Go to the main navigation, click your username and click "Settings" link on the dropdown menu. Then click "Change Password" tab. Fill in the form and change you password.

✓  Updating Contact Information: Go to the main navigation, click your username and click "Settings" link on the dropdown menu. Then click "Contact Informations" tab. Fill in the form and update your location information.

✓  Adding Social Links to Your Profile: Go to the main navigation, click your username and click "Settings" link on the dropdown menu. Then click "Social Media" tab. Fill in the form and update your social links.

✓   Adding Slider Item : Open your Admin Panel, go to "Slider" section from navigation and click "Add Slider Item" link, then fill in the form and click Add Slider Item button. Then click "Social Media" tab. Fill in the form and update your social links.

✓   Adding Product : Click "Sell Now" button that in the main navigation, then fill in the form and click Submit button. Then select your Pricing plan and add your product.

✓   Approving Product : Open your Admin Panel, go to "Products" section from navigation and click "Pending Products" link, find the product that will be approved. Then click "Select an option" button and click "Approve" option.

✓  Adding Product Category: Open your Admin Panel, go to "Categories" section from navigation and click "Add Category" link, then fill in the form and click Add Category button.

✓  Adding Page: Open your Admin Panel, go to "Pages" section from navigation and click "Add Page" link, then fill in the form and click Add Page button.

✓  Adding Blog Post: Open your Admin Panel, go to "Blog" section from navigation and click "Add Post" link, then fill in the form and click Add Post button.

✓  Adding Blog Category: Open your Admin Panel, go to "Blog" section from navigation and click "Categories" link, then fill in the "Add Category" form and click Add Category button.

✓  Send Email to Subscribers: Open your Admin Panel, go to "Newsletter" section from navigation, then fill in the mail form and click Send Email button.

✓  Social Login Configuration: Open your Admin Panel, go to "Social Login Configuration" section from navigation, then fill in the form and click Save Changes button.

✓  Generating Sitemap: Open your Admin Panel, go to "Seo Tools" section from navigation, then click Download Sitemap button. Also you can generate your sitemap directly in your FTP by clicking Update Sitemap button.

✓  Running Ads: If you want to add your ad codes to your website, this is very easy in the Bazaaroka. Open your Admin Panel, go to "Ad Spaces" section from navigation, add your ad codes then click Save Changes button.

✓  Managing Locations: Bazaaroka has editeble countries and states/cities database. You can manage your locations from Location Settings section. Open your Admin Panel, go to "Location Settings" section from navigation. If you want to edit countries, click Countries link. If you want to edit states/cities, click States link.

✓  Managing Languages: Open your Admin Panel, go to "Language Settings" section from navigation. If you want to add a new language, fill in the "Add Language" form and click Add Language button. If you want to change default language, select the language from "Default Language" form and click Save Changes button. If you want to edit translations, find the language from "Languages" list and click "Select an option" button, then click "Edit Translations" option and edit translations.

✓  Email Settings: Open your Admin Panel, go to "Email Settings" section from navigation, then fill in the "Email Settings" form and click Save Changes button.

✓  Payment Settings: Open your Admin Panel, go to "Payment Settings" section from navigation, then select options in the "Payment Settings" form and click Save Changes button. You can manage daily and mounthly price from "Pricing" form. You can set your payment accounts in Paypal Account and Stripe Account forms.

Admin Panel

1. Products: Shows products count
2. Pending Products: Shows pending products count
3. Blog Posts: Shows blog posts count
4. Members: Shows members count
5. Orders: Shows orders count

1. Latest Orders: Shows last added orders
2. Latest Transactions: Shows last transactions
3. Latest Pending Products: Shows last added pending products
4. Latest Products: Shows last approved products
5. Latest Transactions (Promoted Products): Shows last transactions for promoted products
6. Latest Product Reviews: Shows last added products reviews
7. Latest Members: Shows last registered members

Navigation

You can select your navigation design from this section.
Menu Limit: You can set the number of links to appear in the menu. Other links will appear in the dropdown.

Slider

• Language:Language of the slider item.
• Title: Title that will be displayed on slider image.
• Description: Description that will be displayed on slider image.
• Link: The URL that will be opened when this slider item clicked.
• Order: Order value of the slider item.
• Button Text: The text that will be showed on your button. (Buy now, shop now, etc..)
• Text Color: You can select a color for texts on your slider.
• Button Color: You can select a color for slider button.
• Button Text Color: You can select a color for slider button text.
• Animations: Bazaaroka has different animation options for title, description and button on the slider. You can select different animations for your slider items.
• Image: Your slider image.

• Status:You can enable & disable slider with this option.
• Type: Bazaaroka has full-width and boxed slider options. You can select your slider type with this option.
• Effect: You can select slide or fade affect for your slider. Default will be "fade".

Homepage Manager

You can manage your homepage from this section.

Featured Categories

Products by Category

Homepage Banners

• Banner URL: The URL of the advertisement or discount.
• Order: Banners will be sorted by this value.
• Banner Width: The width of your banner in %. Max width is 100%.
• Location: You can place your banner in different location. Your banner will be placed under the section you selected.
• Banner: Banner image.

Settings

• Featured Categories: Option to hide or show featured categories.
• Featured Products: Option to hide or show featured products.
• Latest Products: Option to hide or show latest products (new arrivals).
• Blog Slider: Option to hide or show blog slider.
• Number of Featured Products to Show: You can set the number of featured products you want to show with this option.
• Number of Latest Products to Show: You can set the number of latest products you want to show with this option.

Orders

• View Details: You can view all order details by select this option.
• Completed/Processing: You can change order status by selecting these options.
• Payment Received/Payment Not Received: You can change order payment status by selecting these options.
• Delete: You can delete an order with this option.

Digital Sales

Earnings

Payouts

Refund Requests

How it works?

Products

• View Details: You can see all details of a product by selecting this option.
• Edit: You can edit a product by selecting this option.
• Delete: You can delete a product by selecting this option.
• Delete Permanently: If you want to delete a product with images and all other connected records, you can select this option.
• Add to Featured: You can add a product to featured products by selecting this option.
• Remove from Featured: You can remove a product from featured products by selecting this option.
• Add to Special Offers: You can add a product to special offers by selecting this option.
• Remove from Special Offers: You can remove a product from special offers by selecting this option.
• Approve: You can approve a product by selecting this option.

Bulk Product Upload

Featured Products

Quote Requests

Categories

• Category Name: Category name. You should enter according to language.
• Slug: Slug for SEO friendly url. You can add custom slug. If you leave it empty, it will be generated automatically.
• Description: You can add Description (Meta Tag) for category.
• Keywords: You can add Keywords (Meta Tag) for category.
• Order: Your categories will be listed according to this order.
• Homepage Order: Your featured categories will be listed according to this order.
• Parent Category: You can select a top (parent) category.
• Visibility: You can hide and show a cateogory with this option.
• Image: Category image.

Bulk Category Upload

Custom Fields

• Field Name: Field name. You should enter according to language.
• Row Width: Field will be displayed according to this option. If you select "Full Width", it will be displayed in 100% width. If you select "Half Width", it will be displayed in 50% width.
• Required: You can determine whether this field is required or not.
• Where to Display: With this option you can choose where you want to show your custom field on the product details page. If you select the "Product Details" option, your custom field will appear under the product price on the product details page. If you choose the other option, it will appear under the "Additional Information" tab.
• Status: You can enable or disable field.
• Order: Custom fields will be displayed according to this order.
• Type: From this section you can select appropriate input type for the custom field.

Pages

• Title: Page title.
• Slug: Slug for SEO friendly url. You can add custom slug. If you leave it empty, it will be generated automatically.
• Description: You can add Description (Meta Tag) for page.
• Keywords: You can add Keywords (Meta Tag) for page.
• Language: Page will be displayed according to this language
• Order: Pages will order according to this value.
• Location: You can select page link location.
• Visibility: You can hide or show page.
• Content: Page content.

Blog

• Title: Post title
• Slug: Slug for SEO friendly url. You can add custom slug. If you leave it empty, it will be generated automatically.
• Summary & Description: You can add Summary & Description (Meta Tag) for post
• Keywords: You can add Keywords (Meta Tag) for page
• Language: Post will be displayed according to this language
• Category: Post category
• Tags: You can add tags for post
• Image: Post image
• Content: Page content

• Language: Category will be displayed according to this language
• Category Name: Category name
• Slug: Slug for SEO friendly url. You can add custom slug. If you leave it empty, it will be generated automatically.
• Description: You can add Description (Meta Tag) for category.
• Keywords: You can add Keywords (Meta Tag) for category.
• Order: Your categories will be listed according to this order.

Location

Membership Plans

• Title: Name of the membership plan.
• Number of Ads: The ads limit that a seller can add. Sellers cannot add ads more than this value. If a seller's total number of products reaches this limit value, adding products will be disabled.
• Duration: The time limit for the subscription package to be active. If this time expires and the seller does not renews the plan, the products of this seller will be added to the "Expired Products" section and will not be displayed on the site. If the seller renew the plan, the products will continue to be displayed on the site.
• Price: The price of the plan.
• Order: The added plans will be sorted by this value.
• Popular: You can select this option if you want to show a "popular" badge.
• Features: The features of the plan.

How It Works

Shop Opening Requests

Users

• Open User Shop: You can enable a member shop with this option. When you select this option the role of the member will be "vendor".
• Ban User: If you want to ban a member, you can select "Ban User" option by clicking "Select an option" button.
• Edit: You can edit a user by selecting this option.
• Delete: If you want to delete a member, you can select "Delete" option by clicking "Select an option" button.

Roles & Permissions

Default Roles

Changing a User's Role

Help Center

Knowledge Base

Support Tickets

Storage

1. Go to https://aws.amazon.com/s3/ and create your account.
   
   
2. Click AWS Management Console
   

   
   
   

3. Click S3 under the Storage menu
   

   

   
   
   
4. Click the "Create bucket" button.
   
   

   

   
   
   
5. Enter your "bucket name" and select your region. "us-east-1" will be your region code and you need to enter this value from the Admin panel. Your region code can be different according to your location.
   
   

   

   
   Select the "ACLs enabled" option.
   
   

   

   
   
   Unselect the "Block all public" option and select "I acknowledge that the..." option.
   
   

   

   
   
   Disable bucket key.
   
   

   

   
   Click the "Create bucket" button.
   
   

   

   
   
   

6. Click the My Security Credentials option.
   

   

   
   
   
7. Click Access keys tab. Then click Create New Access Key button and create your access keys. You can need to enter these keys from "AWS S3 Storage" section in Admin panel.
   

   

   
   
   

Cache System

• Refresh Cache Files When Database Changes: If you select yes, the cache files will be refreshed, if there is a change in the database.
• Cache Refresh Time (Minute) : Cache files will automatically refresh after this time.

SEO Tools

Google Analytics

Generate Sitemap

You can generate a sitemap.xml file from this section.

Update Sitemap: This option will create a sitemap.xml file on your main directory. You can access this file with "http://domain.com/sitemap.xml" URL.

Download Sitemap: This option will download sitemap.xml file.

You need to create a cron job function to automatically update your sitemap. Read this section to see how you can add a cron job function in your server: Cron Job

This is the URL that you need to run with your cron job function: http://domain.com/cron/update-sitemap
**Do not forget to change "domain.com" with your domain name.

Ad Spaces

AdSense Activation Code

You can add your Google Adsense code from this section. This code will be added to footer of the site and it will be enabled for all pages. After adding this code, you can add your ad codes to ad spaces.

Contact Messages

Reviews

Comments

Bazaaroka has comment approval system. Only approved comments will be published in the site. If you want to disable this system and publish directly all the comments, you can disable this system from "Preferences" section in the Admin panel.

Pending Comments

You can see and approve the pending comments from this section.

Approved Comments

You can see and delete the approved comments from this section.

Abuse Reports

Newsletter

• Status: You can enable or disable the newsletter system with this option.
• Newsletter Popup: Bazaaroka has a newsletter popup. New visitors will see this popup when they open the site. You can enable or disable this popup with this option.
• Image: You can upload your image for the newsletter popup with this option.

Cron Job

A cron job is a Linux command for scheduling a task to be executed sometime in the future. You can set a cron job to update your sitemap, scheduled posts or RSS feeds periodically.

Follow these steps to set up cron job:

1. Go to your cPanel and click cron jobs.
   
   
   
   
2. Select the time interval that the cron job will run and your command and create the cron job.
   
   
   
   

   Commands

   Update Sitemap:
   

   wget -O /dev/null http://domain.com/cron/update-sitemap

   You need to paste these commads to "Command" field and you need to create a different cron job for each task.
   **Do not forget to change "domain.com" with your domain name.

Password Reset

Preferences

System

• Physical Products: You can enable & disable physical products with this option.
• Digital Products: You can enable & disable digital products with this option.
• Marketplace: You can enable & disable marketplace system with this option. If you disable this option, there won't be buy option in the site.
• Classified Ads: You can enable & disable classified ads system with this option. If you disable this option, seller cannot add their products without buy option.
• Bidding System: You can enable & disable bidding system with this option.
• Selling License Keys: You can enable & disable selling license keys system with this option.
• Multi-Vendor System: If you disable multi-vendor system, only Admin can add products.
• Timezone: You can set your timezone with this field.

General

• Multilingual System: You can enable or disable multilingual system with this option.
• RSS System: You can enable or disable RSS system with this option.
• Vendor Verification System: You can enable or disable Vendor Verification system with this option. You can disable if you want to allow all users to add products.
• Show Vendor Contact Information on the Site: If you don't want to show vendors contact information in your site, you can select "No" for this option.
• Guest Checkout: You can enable or disable Guest Checkout system with this option.
• Search by Location : You can enable or disable the location search section on the header of the site with this option.
• Progressive Web App (PWA): You can enable or disable PWA with this option.

Products

• Approve Products Before Publishing: If you don't want to approve seller products, you can disable it with this option.
• Featured Products: If you don't want featured products in your site, you can select disable option.
• Vendor Bulk Product Upload: Sellers can import their products with a CSV file from the dashboard. You can enable or disable this feature for the sellers with this option.
• Show Sold Products on the Site: Sellers can set their product status to "sold". These products can no longer be purchased by customers. You can show or hide these products on your site with this option.
• Product Link Structure: You can select product URL structure with this option.

Reviews & Comments

• Reviews: You can enable or disable review system with this option.
• Product Comments: You can enable or disable product comment system with this option.
• Blog Comments: You can enable or disable blog comment system with this option.
• Comment Approval System: You can enable or disable comment approval system with this option. If you disable this system, the comments will be directly displayed in your site.

Shop

• Show Customer Email to Seller: If you do not want to show the buyer's e-mail address in the sales details and invoice, you can disable it with this option..
• Show Customer Phone Number to Seller: If you do not want to show the buyer's phone number address in the sales details and invoice, you can disable it with this option..
• Request Documents from Vendors to Open a Store: To sell a product on your site, users must first submit a store request. If you want users to send some documents while sending a store opening request, you can activate this option and write the name of the files you want to be uploaded as a description.

File Upload

• Image File Format: You can choose in which format your image files will be uploaded with this option. If you choose JPG, PNG or WEBP, your image files will be converted to selected file format during upload.
• Product Image Upload: With this option, you can make image upload mandatory or optional.
• Product Image Upload Limit: With this option, you can determine the maximum number of images that can be uploaded for a product.
• Max File Size (Image): With this option, you can specify the maximum size of an image file to be uploaded.
• Max File Size (Video): With this option, you can specify the maximum size of an video file to be uploaded.
• Max File Size (Audio): With this option, you can specify the maximum size of an audio file to be uploaded.

Progressive Web Apps (PWA)

A Progressive Web Application (PWA) is a type of automated mobile apps for android and ios delivered through the mobile browsers, built using common web technologies including HTML, CSS and JavaScript. It is intended to work on any platform that uses a standards-compliant browser. If you enable PWA support for your site, you can add your site to your home screen of your mobile device. You will see your application icon of your site on your mobile devices and it will work like a mobile application when you open it.

Enabling PWA for Your Site

1. Make sure SSL is active on your site.
2. Go to Admin Panel > Preferences and select "Enable" for "Progressive Web App (PWA)" option.
3. Download "bazaaroka-pwa.zip" file
4. Open this .zip file and upload "manifest.json" and "pwa-sw.js" to root directory of your site.
   
   
   
   
5. Open "manifest.json" file and edit this file for your site. Change the texts in this file (name, description, short_name) for your site and replace "https://domain.com" with your domain. Example: https://mhdscripts.com
   Also, you can change "ltr" to "rtl" if your language is "right to left".
   
   

   If you want to change your application icon, you can change the images in the "assets/img/pwa" folder.

Adding Application Icon to the Home Screen of the Mobile Device

Genaral Settings

Genaral Settings

• Application Name: Site name.
• Site Title: Site title.
• Home Title: Homepage title.
• Site Description: Site description
• Keywords: Site keywords
• Footer About Section: About your site. This will be shown in the footer.
• Copyright: You can update copyright section from here.

Contact Settings

• Address: Your address
• Email: Your email address
• Phone: Your phone number
• Contact Text: You can add some text about contact.

Social Media Settings

You can add your social links from this section.

Facebook Comments

If you want to use Facebook comment plugin you have to add your plugin code to this section.

1. Go to https://developers.facebook.com and click Add a new app.
2. Click Settings and then click +Add platform.
3. Select website and enter your site url and click save changes.
4. Then go to https://developers.facebook.com/docs/plugins/comments/ URL. Enter your site URL to "URL to comment on" field. Enter 750 to "Width" field and click Get Code button.
5. Then copy the code in the "STEP 1" and paste to Facebook Comments field.
   
   

Custom Header Codes

You can add custom header codes from this section. These codes will be added in the <head> tags of your site.

Example:

<style>

body {

    background-color: #00a65a;

}

</style>

Custom Footer Codes

You can add custom Footer codes from this section. These codes will be added to footer of your site.

Example:

<script>

alert('Hello!');
</script>

Cookies Warning

You can show a warning for using cookies from this section.

Google reCAPTCHA

Bazaaroka uses Google reCAPTCHA to protect website from spam and abuse. To enable this feature:

1. Go to this link: https://www.google.com/recaptcha/intro/v3beta.html
2. Click Admin Console button.
3. Click "+" button at the top menu.
4. Select "reCAPTCHA s2" and "I'm not a robot Checkbox" options and generate your API keys.

Maintenance Mode

If you want to prepere your site before going live or if you want to close your site to visitors, you can enable this mode. If you enable it, only Admin can access the site. Other visitors will see a "Coming Soon!" text.

Language Settings

Product Settings

Marketplace

• SKU: You can enable / disable SKU number option for marketplace products with this option.
• Variations: You can enable / disable Product Variations option for marketplace products with this option.
• Shipping: You can enable / disable Shipping system for marketplace products with this option.
• Location: You can enable / disable Location system for marketplace products with this option.

Classified Ads

• Price: You can enable / disable price option for classified ads products with this option. If you do not want the product price to be optional, you must select "Required".
• Location: You can enable / disable Location system for classified ads products with this option.
• External Link: This option allows you to add an external link for your product. If you have the same product on another website, you can add your URL to this field.

Digital Products

• Demo URL: You can enable / disable demo URL option for digital products with this option.
• Video Preview: You can enable / disable video preview option for digital products with this option.
• Audio Preview: You can enable / disable audio preview option for digital products with this option.
• External Download Link: If you want to allow vendors to add external download link for their digital products, you can enable this option.
• Allowed File Extensions: With this option, you can define the file types you allow for digital products.

Physical Products

• Demo URL: You can enable / disable demo URL option for physical products with this option.
• Video Preview: You can enable / disable video preview option for physical products with this option.
• Audio Preview: You can enable / disable audio preview option for physical products with this option.

Payment Settings

Bank Transfer

If you want customers to send the order amount to your bank account, you can enable this option and enter your bank account details. This payment option requires you to manually check and approve payments.

Cash on Delivery

Cash on delivery (COD) is a method of collecting payment from customers when their orders arrive. So if you want the customer to pay at the time of receiving the order, you can enable this option. However, since this feature is also of interest to sellers, if the seller does not want to sell with this payment option, they can disable it for their products in the Vendor Dashboard section.

Commission & Tax Settings

Global Taxes

Global Taxes allows you to add additional taxes on different or all countries for product sales on your site. With this option, you may receive additional taxes for sales to the country or countries you specify.

Currency Settings

Currency Settings

Currency Converter

Fixer.io: https://fixer.io/

Currencyapi.net: https://currencyapi.net/

Openexchangerates.org: https://openexchangerates.org/

All these APIs have free plans. Create your account on one of these websites by selecting "FREE" plan and get your API key. After adding this API key from this section, the system will update currency rates automatically every hour.

Email Settings

• Mail Service: Bazaaroka has Swift Mailer and PHP Mailer email libraries. It also has Mailjet API option. You can select one of them to send emails.
• Mail Protocol: SMTP or Mail. Default: SMTP. But some mail servers use Mail protocol. In this case you should use Mail protocol.
• Encryption: TLS or SSL. Default: TLS. If your server does not support sending with SSL, you should choose TLS.
• Mail Host: Your mail server (E.g: mail.example.com)
• Mail Port: Your mail port. Default: 587
• Mail Username: Your username (E.g: mail@example.com)
• Mail Password: Your password
• Mail Title: Your email title
• Reply-To: If recipients reply to your e-mail, the reply will go to this e-mail address.

Mailjet Email Service

• Go to this URL and create your account: https://app.mailjet.com/signup
  
• After creating your account, go to this page and get your API keys: https://app.mailjet.com/account/apikeys
  
• Go to "Email Settings" section in the Admin panel and select the "Mailjet" as the "Mail Service" option. Then add your API Key, Secret Key and Mailjet Email Address.

Mail Protocol

Mail protocol allows you to use the default PHP mail function and allows you to send email without any extra settings. But this function is disabled on most servers for security reasons. If this function is active on your server, you can select the Mail protocol and use it without making any other settings.

SMTP Protocol

If the Mail protocol is not working on your server, you need to use the SMTP protocol. You need a mail server for using SMTP protocol. You can use your own server or Amazon SES as your mail server.

1. Using Your Own Server

If you want to use the mail service of your own server, you can create a mail account on your server and make the necessary settings with this account. To do this, you need to create a mail account on your server and know which protocol and port values your server uses. If you can't see these values from your server's management panel, you can ask help from your server provider.

2. Using Amazon Simple E-mail Service (SES)

Amazon SES is a cloud-based email sending service. You can create your Amazon SES account and send emails with this service. This is not a free service, check this page for pricing: https://aws.amazon.com/ses/pricing/

If you want to use this service, follow these steps to make your email settings:

• Go to https://aws.amazon.com/ses/ and create your account.
  
  
• Click AWS Management Console
  
  
  
  
  
• Click the "Simple Email Service" link under the Services menu
  
  
  
  
  
• Click the "SMTP Settings" link from left menu.
  
  
  
  
  
• Click the "Create My SMTP Credentials" button.
  
  
  
  
  
• Click the "Create" button.
  
  
  
  
  
• Your credentials will be created after these steps.
  
  
  
  
• After creating your credentials, you can add these credentials from Email Settings in the Admin panel.
  
  Example:

  Mail Protocol: SMTP
  Mail Library: Swift Mailer or PHP Mailer
  Encryption: TLS
  Mail Host: email-smtp.us-east-1.amazonaws.com
  Mail Port: 587
  Mail Username: AKIAVIAANDJBBXXXXXXX
  Mail Password: BPj7ailKjbITgyGF6brROnVIflfdfdydbdklsdsds
  Reply-To: noreply@domain.com

  
  
  

Social Login Settings

Visual Settings

Visual Settings

Font Settings

If you want to add new fonts to your site, you can add them from this section. Follow these steps to add a new font:

1. Go to Google Fonts: https://fonts.google.com
2. Click the red plus icon for the font that you want to add.
3. You will see "Family Selected" box at the right bottom of the page. Click on this box.
4. Copy the font URL and enter it to "URL" field.
   E.g: <link href="https://fonts.googleapis.com/css?family=Open+Sans&display=swap" rel="stylesheet">
5. Copy the CSS rule and enter it to "Font Family" field.
   E.g: font-family: 'Open Sans', sans-serif;

Route Settings

You can change static routes in your site from this section.

Shipping System

Shipping Options

Shipping Methods

• Flat Rate: With this option, you can add a fixed shipping fee for your products. Total shipping cost is calculated according to the following three options: 
  
  1. Charge shipping for each product in the cart: With this option, the shipping cost will be calculated with the number of products in the cart. This option will charge one shipping cost for the same products.
     Example: If you select this option and set the cost to $3, the system will calculate the total cost as follows.
     Products in the cart: Book, Book, Pencil => $3 + 0 + $3 => $6 (The same products will not affect the shipping cost)
     
     
  2. Charge shipping for each different product in the cart: With this option, the same products are also included in the calculation.
     Example: If you select this option and set the cost to $3, the system will calculate the total cost as follows.
     Products in the cart: Book, Book, Pencil => $3 + $3 + $3 => $9 (The same products will be included to the calculation)
     
     
  3. Fixed shipping cost for cart total: With this option, calculation is not made according to the products in the basket. Regardless of the items in the basket, the cost you set will be the total cost.
     Example: If you select this option and set the cost to $8, the total shipping cost will be $8.
     
     
• Local Pickup: Local pickup is a method that allows the customers to pick up the order themselves. You can add a cost for this also.
• Free Shipping: If you want to add a free shipping option for your products, you can add this option as well. By entering your minimum order amount value, you can offer free shipping method after a certain basket total.
  Example: If you set the minimum order amount to $100 and if the total value of the products the buyer will buy from you is $101, the free shipping option will be displayed. If the total value is below $100, this option will not be displayed.
  
  

Shipping Classes

1. Add a shipping class
2. To set a different cost for this shipping class, edit the flat rate methods you added before and enter a different cost for this class.
3. Select this shipping class during adding or editing a product

Shipping Delivery Times

Product Variations

If you have variations (color, shoe size etc.) for the product you're going to sell, you can add these options from the "Variations" section in the second page of the product adding section. This way, potential buyers interested in the product you're selling can choose from the options you provide and purchase the specific variant they desire. 

Add Variation: By clicking here, you can add new variations to your product. When you click on "Add Variation", you will first set up the general settings for that variation. After configuring these settings and saving the variation, you can proceed to add options for that variation.

Select an Existing Variation: You can use a previously created variation for your product. For instance, if you previously created a variation for a shoe that you are selling, you can select and modify that variation for the new shoes you want to sell, saving you time on adjustments. 

Add Variation

Label: Enter the name of the variation you're adding here. For example, color, size, etc. (It's recommended to be careful while typing the variation name, as it will appear on the product page.) 

Variation Type: In this section, you can determine how the added variation will appear on the product page. There are five variation types you can choose based on the display method: 

• Radio Button (Single Selection): When you choose this variation type, customers can click on the specified variation options in adjacent boxes on the product page to view the corresponding variation of the product. For example, if you've added different color options for a dress, customers can see images of the dress in those colors when they click the options. In this type, customers can only select one option at a time. 
  
• Dropdown (Single Selection): In this variation type, options are shown with a drop-down selection box. This option allows you to link two options (parent-sub). For example, if you want to add color options for your product and if you want to add size options according to the selected color option, you need to use this variation type.
• Checkbox (Multiple Selection): In this variation type, the added variations appear similarly to radio button variations, whether as text, images, or color boxes. However, customers can select multiple options from the offered variations. 
  
• Text: When you select the Text variation type, a text input box will appear on the product page for that variation. Customers can add a text to this fied during buying the product.
• Number: It works the same as the text input. Customers can add a numeric values to this field during buying the product.
  

Option Display Type: You can choose whether the variation options will be displayed as text boxes, image boxes, or color boxes. For instance, if you're adding color options like blue and red for a dress, selecting "text" will display boxes with "blue" and "red" labels. Choosing "image" will show the images you'll set for those colors. If you select "color," color boxes for blue and red will be displayed. If you're adding options like shoe sizes, where there are numerical values, you'll need to choose "text" here. This way, the numbers you write will be displayed as text. 

Show Option Images on Slider When an Option is Selected: When you select 'yes', customers will see additional images you've added specifically for that variation when they click on a product variation option. For example, if you're selling a dress in black and blue colors, apart from the main product images, you might want to add different images for each color. With this option enabled, customers can see and examine these additional images when they click to black or blue.

Use Different Price for Options: If you select 'yes,' you can set different prices for the various options of your product. 

Visible:  You can determine whether the added variations will be visible on the product page. 

Parent Variation: If you want to add your variations with parent-sub relationship, you can select a parent variation for your variation during adding it. This feature can only be used with dropdown variation type.

**Note: Currently, you can only use the "Use Different Price for Options" option for a single variation of each product. If you've enabled this option for one variation, you won't see it for other variations you add for the same product. Therefore, if you plan to add multiple variations for a product, you should decide which variation will affect the base price of the product. For instance, if you want to add both different colors and sizes for a dress, you'll create two separate variations. You can enable the "Use Different Price for Options" option for the variation where you want to set different prices. 

Edit Variation

After adding a variation for your product, you can edit it at any time by going to the variations section on the product editing page. Clicking the "Edit" option will open the same window you used when adding the variation, allowing you to modify its settings.

Delete Variation

You can delete your variations using the "Delete" option next to the "Edit" option.

Add Options

After adding your variation, you can add options for that variation. Options can be added for "Radio Button", "Dropdown" and "Checkbox" variation types. If you don't add variation options, customers will see the label you've set, but they won't have selectable options. Click "Add Option" next to the newly added variation to start defining the options. Some options you'll see here, like setting different prices for options or color selection field, are part of the choices you made during the add variation phase. You can review those choices by editing the variation. 

• Default Option: If you select "Yes," you only need to provide a name for this option. Selecting "Yes" means this option will display the main product's price and images. If you select "No," you can continue to add separate images and set different prices for this option.
• Option Name: Here, you need to enter the name for the option you're adding.
• Stock: This is where you indicate how many of the currently added variations are available in stock for the product you're selling. For example, if you have 50 pieces of the same dress, with 20 being red and 30 being blue, when you're adding the blue dress as an option, you should enter "30" in the stock field.
• Color: If you're aiming to show color options with color boxes on your product page, and you can't find the color selection field in the "Add Option" window, you need to select "Color" as the option display type in the variation settings. This way, you'll be able to see the color selection field. You can either choose colors from a color chart or input the color code.
• Price: If you want to set a different price for a specific variation option, you can enter that price here. If you don't want to set a different price, you can leave this field empty. Alternatively, you can choose "Use default price" to make the price of this option the same as the product's base price. If you don't see this price setting in the "Add Option" window, you might have disabled it when adding the variation. You can go back to the variation's edit section and enable "Use Different Price for Options".
• Discount Rate: Here, you can apply a discount for a specific variation option. If you don't want to offer a discount, you can leave this field empty or choose "No Discount". If you don't see this discount setting in the "Add Option" window, you might have disabled it when adding the variation. You can go back to the variation's edit section and enable "Use Different Price for Options". 
• Images: In the Images section, you can add specific images for the current variation option. For example, if you're adding a color variation for a dress, and you're adding individual colors as options, you can use the Images section to add images for each color. If you've enabled "Show Option Images on Slider When an Option is Selected" in the general settings of the color variation, customers will see these specific images when they select different colors. The images you add here are different from the images you previously added for your main product. Earlier, you added the general images of the product. In this section, you can add images for the different variations of the product. 

View Options

Once you've finished adding options for a variation, you can click "View Options" at any time to review the options. You can also delete options you no longer need.

Editing Script Codes

Editing codes is not included in item support. If you want to edit the script codes, you need to edit the codes by yourself or you need to ask help from a PHP developer.

Editing HTML Codes

If you want to edit the HTML codes, you can edit the files in the "app/Views" folder.

Header: You can edit header of the site in the "app/Views/partials/_header.php" file. <head></head> tags are located in this file. If you want to add something between these tags, you need to edit this file.

Index: You can edit homepage of the site in the "app/Views/index.php" file.

Footer: You can edit footer of the site in the "app/Views/partials/_footer.php" file.

Editing CSS Codes

If you want to edit the CSS codes, you can edit "assets/css/style.min.css" file. If you are using the Chrome browser, you need to reset the browser cache to see the changes.

Update Guide

Free Bonuses