Webkul
Services
Technologies Bagisto QloApps
iOS Android SAP BigCommerce Wix
Trusted by
Samsung Intel Toyota Walmart Disney Nokia Nestlé Decathlon
See all customers
Back to Top
DOC

Laravel eCommerce Marketplace Hyperlocal Extension

Bagisto Marketplace Hyperlocal connects customers with local stores and greatly transforms their shopping experience.

In addition, customers can enter their location to buy products directly from nearby seller stores.

Moreover, buyers can change or remove addresses at any time, or simply pick a point on the map.

Meanwhile, the admin defines the radius unit and search range used to find sellers around a customer.

Similarly, each seller sets the delivery distance up to which goods can be delivered from its origin.

Consequently, products from sellers outside the customer’s shipping range are automatically hidden.

As a result, shoppers only see items that can actually be delivered to their address.

Features of Laravel eCommerce Marketplace Hyperlocal Extension

  • The customer can enter their location and buy products from the seller’s store.
  • The customer can also change their location at any time.
  • In addition, customers and guests can edit or delete their saved locations.
  • Furthermore, buyers can select their exact location using an interactive map pointer.
  • Customers can easily check real-time product availability in their specified area.
  • The admin can configure a radius unit and range to search for nearby sellers.
  • Similarly, each seller enters the delivery radius allowed from their origin store.
  • Moreover, the admin can enable or disable the single-seller checkout feature.
  • Consequently, seller products outside the delivery range remain hidden from buyers.
  • Shoppers can quickly check seller availability around their current address.
  • Finally, shipping charged by a seller using custom rates is credited to their order payout.

Requirements

  • Bagisto: v2.5.0
  • Bagisto Marketplace: v2.5.0.x
  • Database: MySQL 8.0, MariaDB 10.11, or PostgreSQL 16

How to install the module?

First, unzip the extension and merge its packages folder into the project root directory.

Next, open the root composer.json file and add this line under ‘autoload.psr-4’:

"Webkul\\MarketplaceHyperlocal\\": "packages/Webkul/MarketplaceHyperlocal/src"

After that, refresh the autoloader by executing the following command:

composer dump-autoload

Then, register the service provider in bootstrap/providers.php after the Marketplace provider:

Webkul\MarketplaceHyperlocal\Providers\MarketplaceHyperlocalServiceProvider::class,

Finally, run the installer command below to complete the setup process:

php artisan marketplace-hyperlocal:install

Now, execute the application on your configured domain or entry point.

Admin Management: Hyperlocal Configuration

To configure settings, navigate to Admin → Configuration → Marketplace → Hyperlocal Marketplace → General.

Additionally, the Module Information section clearly displays the installed version.

hyperlocal-cofi

Here, the store admin must configure the following key settings:

FieldControls
StatusEnables or disables the hyperlocal feature
Enable single seller checkoutRestricts a cart to products of one seller
Google API KeyKey used for geolocation, place search, and the map view
Radius UnitDistance unit (kilometre or mile) used to match sellers to a customer (channel-based)

Note: Make sure to enable Maps JavaScript API and Places API for your Google key.

However, if the key is missing or invalid, sample locations will be used instead.

You can easily generate a new API key via Google Maps Documentation.

In addition, the admin must define coordinates and delivery ranges for each inventory source.

Consequently, items appear only when buyers fall within an inventory source’s active range.

To manage locations, navigate to Settings » Inventory Sources in the admin panel:

Inventory Source

Click on Add Inventory to create a new source, or click Edit for an existing one.

Create inventory sources

Specifically, enter all required inventory details, including the hyperlocal parameters:

  • Locality – Search and select the location. Latitude and Longitude auto-fill immediately.
  • Latitude and Longitude – The exact geographical coordinates of the source.
  • Range – The maximum delivery distance allowed, based on the selected Radius Unit.

Seller Dashboard

Sellers can also define inventory locations to ensure items are shown only to nearby buyers.

As a result, location-based relevance and product accessibility improve significantly.

From the seller panel, go to Settings » Inventory Sources and fill in the location fields:

Seller-profile-hyperlocal-marketplace

Customer Management

Enter your Location

When customers open the storefront, a prompt automatically appears asking for their location.

Buyers can either search for an address or drop a marker directly on the interactive map.

In addition, logged-in buyers can save multiple labeled addresses and set a default choice.

Meanwhile, guest customer addresses are conveniently preserved during their browser session.

Add Location

Products Available – Based On Customers’ Location

Once a customer sets their location, only products available in nearby sources will appear.

Available product near customer
    location

Furthermore, buyers can click directly on any item to view its respective seller details.

Seller's name

Location Change

When a buyer updates their address with items in the cart, a confirmation popup appears.

After that, physical items unserviceable at the new address are removed from the cart.

However, downloadable and virtual products remain safely inside the shopping cart.

Single Seller Checkout

With single-seller checkout active, customers can only buy goods from one seller per order.

Therefore, attempting to add products from another seller immediately shows an alert warning.

Hyperlocal Shipping

Marketplace Hyperlocal Shipping allows sellers to deliver products based on proximity.

The carrier is configured under Admin → Configuration → Sales → Shipping Methods → Hyper Local Shipping:

FieldControls
TitleMethod title shown at checkout (channel- and locale-based)
DescriptionMethod description shown at checkout (channel- and locale-based)
RateDefault rate used when a seller has no matching or flat rate (channel-based)
TypePer Unit charges the rate for each unit of a product (rate × quantity); Per Product charges it once for each product line, whatever its quantity
StatusEnables or disables the carrier (channel-based)

In addition, the admin can view and import shipping rates under Marketplace » Hyper Local Shipping.

Meanwhile, sellers can manage their custom rates under HL Shipping in their seller panel:

  • Shipping Rate – Distance and weight rates, added manually or imported via CSV.
  • Default Shipping Rate – A flat shipping rate applied when no custom band matches.

Specifically, each seller configures delivery ranges and distance-based rates individually.

Cart items are priced using matching distance bands, falling back to seller flat rates.

Furthermore, shipping charges collected from custom seller rates are credited to that seller.

Conversely, orders priced using the store default rate stay with the marketplace admin.

Hyper locale shipping

Finally, available hyperlocal delivery options are calculated and shown during checkout.

hyper locale shipping

Support

In summary, this guide explains how the Laravel eCommerce Marketplace Hyperlocal Extension operates.

For any queries or doubts, feel free to reach out to our team at [email protected].

In addition, you can raise an instant support ticket at our HelpDesk System.

Finally, explore our Laravel Development Services and Quality Bagisto Extensions.

Current Product Version - v2.5.0

Supported Framework Version - Bagisto v2.5.0

Blog Version - Bagisto v2.5.0
  • Version Bagisto, 1.4.5
  • Version Bagisto, 1.2.0
  • Version Bagisto, 1.1.1, 1.1.2
  • Version Bagisto v2.5.0
  • Version Bagisto v2.4.10
  • Version 2.4.6
  • Version 2.3.12
. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home
IN THIS ARTICLE

Table of Content

Back to top