Laravel eCommerce Multi-Tenant SaaS Module

• Admin can easily set up and manage saas based eCommerce solution
• Flexibility and scalability for your business
• Multiple eCommerce merchants can access at a time
• The super admin can view the product list of their merchant’s store
• Super admin will get the email notification whenever a customer orders a product from his merchant’s store
• The super admin can also view the customer data of their merchant’s store
• Manage multiple businesses with custom domains or self-provided domains
• Super admin can also view the orders of their merchant’s store
• The Merchant can Change the domain from channel settings
• The Merchant manages their own store using their own dedicated admin dashboard
• Supported the Bagisto Velocity theme
• Supported all product types of Bagisto Framework including Simple, Downloadable, Grouped, Bundle, Configurable, Virtual, and Booking.
• Every merchant will also receive the mail whenever a customer orders from his store
• High security in a session
• Easy Customisation
• Easy Updates of Laravel Multi-Tenant SaaS.
• ACL system for the Super admin users.
• CMS pages support at super admin.
• Add an option to register a tenant account from the super admin end.
• Theme configuration options are available.
• Implemented Full Page Cache support to improve performance.
• Added support of Laravel Octane to enhance application speed and efficiency.
• Added Dark theme support, providing users with the option to switch to a darker color scheme for improved visibility in low-light environments.

Note:-

• Do not install Bagisto till you configure this extension.
• Do not seed your database at any point using ‘php artisan db: seed‘ (seeding is done automatically when the seller is registered)
• Run the command from the root in the terminal ‘composer create-project’
• Find ‘.env’ file in the root directory then change the APP_URL parameter to your application’s domain name.
• Add your database credentials in.env where params DB_DATABASE, DB_USERNAME, DB_PASSWORD should be added as your own database credentials.
• DB_DATABASE is the name of your database where all the tables will be created.

Customers will get a zip folder after purchasing the extension. After that, Unzip the respective extension zip and then merge the “package” folder into the project root directory.

Goto config/app.php file then add the following line under ‘providers’

Webkul\SAASCustomizer\Providers\SAASCustomizerServiceProvider::class, 

Do the below entry in config/app.php ‘aliases‘

'Company' => Webkul\SAASCustomizer\Facades\Company::class, 

Goto config/concord.php and packages/Webkul/Core/src/Config/concord.php files and add the following line under the ‘modules’ index in both files:

\Webkul\SAASCustomizer\Providers\ModuleServiceProvider::class, 

Goto composer.json file inside the Bagisto root directory and add the following line under ‘psr-4’

"Webkul\\SAASCustomizer\\":"packages/Webkul/SAASCustomizer/src" 

Another entry inside file(‘app/Http/Kernel.php’,):

Remove the code in ‘middleware’ array.

\Webkul\Core\Http\Middleware\CheckForMaintenanceMode::class,

Add the code in ‘middleware’ array.

\Webkul\SAASCustomizer\Http\Middleware\SaasCheckForMaintenanceMode::class,

In this file, you can find an array of’ middleware groups’ inside it there is
a key named ‘web’ inside it do an entry:

\Webkul\SAASCustomizer\Http\Middleware\ValidatesDomain::class, 

Find a file auth.php present inside the config folder from the root and do the following entries:

Insert the below in the ‘guards‘ array

'super-admin' => [
     'driver'=> 'session',
   'provider' => 'superadmins'
],

Then insert the below code in the ‘providers‘ array

'superadmins' => [
     'driver' => 'eloquent',
      'model' => Webkul\SAASCustomizer\Models\Agent::class
 ],

insert the below code in the ‘passwords‘ array

'superadmins' => [
   'provider' => 'superadmins',
      'table' => 'super_admin_password_resets',
     'expire' => 60,
   'throttle' => 60,
],

To publish the assets of the saas extension, add the below entries in the config/bagisto-vite.php file inside the viters array index:

'company'                  => [
'hot_file'                 => 'company-default-vite.hot',
'build_directory'          => 'vendor/webkul/company/build',
'package_assets_directory' => 'src/Resources/assets',
],

Run the below-mentioned commands from the root directory in the terminal:

composer dump-autoload

php artisan saas:install

* Access the super admin panel as an example: http://saas.com/super/login

Once you run the command “php artisan saas:install” then you have to enter your super admin credentials like email id and password

/*
|————————————————————————–
| Company Theme Configuration
|————————————————————————–
|
| All the configurations are related to the Company themes.
|
*/

‘company-default’ => ‘default’,

‘company’ => [
‘default’ => [
‘name’ => ‘Default’,
‘assets_path’ => ‘public/vendor/webkul/company’,
‘views_path’ => ‘resources/company-themes/default/views’,

    'vite'        => [
        'hot_file'                 => 'company-default-vite.hot',
        'build_directory'          => 'vendor/webkul/company/build',
        'package_assets_directory' => 'src/Resources/assets',
    ],
],

],

/*
|————————————————————————–
| Super Theme Configuration
|————————————————————————–
|
| All the configurations are related to the Super themes.
|
*/

‘super-default’ => ‘default’,

‘super’ => [
‘default’ => [
‘name’ => ‘Default’,
‘assets_path’ => ‘public/themes/admin/default’,
‘views_path’ => ‘resources/admin-themes/default/views’,

    'vite'        => [
        'hot_file'                 => 'admin-default-vite.hot',
        'build_directory'          => 'themes/admin/default/build',
        'package_assets_directory' => 'src/Resources/assets',
    ],
],

],

Let’s discuss the few DNS Record

CNAME:- Cname is standing for Canonical Name. Every website has an IP address to connect to the world wide web. Where we need more than one domain on a single IP address, their Cname will be useful to map the multiple domains on a single IP address.

For example, If you have your domain shop.mydomain.com and you want this domain point on your main domain(shop.com). Then you have to just replace the IP address of mydomain.com with shop.com so that your CNAME record will be created.

Wildcard:- With the help of the Wildcard DNS record, we can match the request for the non-existence domain name. A Wildcard DNS record is identified by an “*” asterisk. For example *.example.com.

Once the SaaS module is successfully installed, you can open your super admin panel (enter the example.com/super/login). Then the next page will be open like below then you have to enter your credentials then click on Sign in.

After successfully signing in, the super admin dashboard will be open like below. Super-admin can view all the company which is registered on their SaaS Panel.

Now as you can see in the below image super admin can export the tenant list from the respective Export Button into two forms CSV/XLS.

Download the tenant list by selecting the format such as CSV/XLS

Tenant data exported in XLS file format example:

In addition to this, the super admin can also register the tenant from the super admin panel itself by tapping the Register Tenant button on the top right-hand corner.

Here the super admin has to enter the below details :

First Name: Enter the first name
Last Name: Enter the last name
Phone: Provide the phone number
User Name: Enter the user name
Organization Name: Mention the organization name
Email Address: Provide the email
Password: Provide the password
Confirm Password: Confirm the password

Lastly, tap the Save Tenant button to save the new tenant.

Once you click on the eye-icon on any particular company then you can view company/tenant insights

Tenant’s Insights

Under the tenant’s insights super admin can see all the information about their tenant store as shown in the below image :

Domain Information – Details of the tenant.

Attribute Information:- No of attributes of the tenant.

Attribute Family Information – Number of attribute families of the company.

Product Information:- Number of products available on that company.

Category Information: Number of categories available to that company

Customer Information: Number of customers available

Customer Group Information:- Number of customer groups of the tenant

Edit Tenant Detail

The super admin can also edit their tenant details as per the below image.

However, the super admin can also delete the tenant as well, as per their requirement by tapping the delete button for the respective tenant.

Tenant’s Customer

The super admin can see all the customer lists of their tenants as shown in the below image

Tenant’s Products

The super admin can also see all the product lists of their tenants as shown in the below image

Tenant’s Order

By navigating to Tenants>Tenant’s Order super admin can see all the orders of their tenants as shown in the below image.

There are three steps to register on the SaaS module.

1: The merchant has to enter the Authentication Credentials like email, the password, confirm the password then click on Continue.

2: The merchant has to enter the Personal details like First Name, Last Name, Phone number.

3: The merchant has to enter the Organization details like user name and Organization name.

Now successfully tenant’s front end was created like below.

The merchant can enter their admin panel with a URL like abc.test.com/admin/login such as below. You will get the backend likewise Bagisto.

Merchants can manage their orders.

They can generate invoices by tapping the Invoice and then create Invoice button.

Similarly, they can create the shipments for their orders as well.

Merchants can also create, edit, and delete the products for their store.

Apart from that, they can create – categories, attributes, attribute families as required.

Under the Tenant side menu option, the merchants can manage their details.

Apart from that, there are many other menu options as well to manage the store.

In the Laravel multi tenant saas module, Merchant can run their website on their own domain and they will get all benefits of the Custom domain. They will get benefits like –

• Website will more flexible using own domain
• Merchant can host their website where they want
• No more hosting provider restrictions on your website
• URLs and email addresses are entirely your own

Domain Mapping is the most important so that customers can access their portal through their custom domain. So let’s discuss a few technical components which are used for domain mapping.

DNS:- DNS stands for Domain name system. DNS is used to translate the IP address into a domain name, for example, if any can run “example.com” on their browser then the browser will perform a DNS query against the DNS server.

So that the DNS server can take the hostname and resolve it to a numeric address so that the web browser can connect with the related IP address.

There is a component DNS Resolver which is used to checking the hostname is available or not in the local cache. Then return to the browser or application.