Bagisto Store Pickup Extension — Marketplace Store Locator

Bagisto store pickup extension that lets admins and sellers publish pickup stores, so shoppers find the nearest branch and collect at checkout.

What the Bagisto Store Pickup Extension Does

Marketplace Store Locator is a Bagisto store pickup extension that turns a multi-vendor store into a click-and-collect business.

Admins publish physical pickup stores, sellers publish their own, and shoppers collect their orders in person rather than waiting for a courier.

Every store carries its coordinates, contact details and opening hours. Consequently, the storefront finder can rank branches by real distance and tell a customer which one sits closest to them.

At checkout the Bagisto store pickup extension goes further.

Specifically, each pickup store within range appears as its own shipping method, so choosing a branch is part of the normal checkout flow rather than a separate step.

This release targets Bagisto v2.4.10 and Marketplace v2.4.10. Moreover, it ships in 22 locales, so the admin, seller and storefront screens all translate out of the box.

For a wider view of the platform, see the Bagisto developer documentation.

Installing the Bagisto Store Pickup Extension

Installing the Bagisto store pickup extension follows the standard package flow. First, unzip the extension and merge its packages folder into your project root.

Next, register the service provider. Open bootstrap/providers.php and add the following line to the returned array.

Webkul\MpStoreLocator\Providers\MpStoreLocatorServiceProvider::class,

Then register the namespace so Composer can autoload the package. Add this entry under psr-4 in your root composer.json.

"Webkul\\MpStoreLocator\\": "packages/Webkul/MpStoreLocator/src"

Finally, rebuild the autoloader and run the installer. The install command applies the migrations, seeds the default configuration, publishes the module assets and clears the caches.

composer dump-autoload

php artisan mp-store-locator:install

Step-by-Step: Installing the Module

1. Unzip the extension and merge packages into the project root.
2. Add the service provider line to bootstrap/providers.php.
3. Add the PSR-4 entry to the root composer.json.
4. Run composer dump-autoload.
5. Run php artisan mp-store-locator:install.
6. Sign in to the admin panel and enable the module under Configure → Store Locator.

Two extra commands help during setup. For instance, mp-store-locator:install --reset restores the default configuration, while mp-store-locator:demo-seed creates sample stores and holidays.

Features of the Bagisto Store Pickup Extension

• Unlimited pickup stores: Admins create as many branches as they need, each with coordinates, a contact person, a full postal address and a description.
• Three opening-hour modes: A store opens around the clock, follows one shared timetable across chosen weekdays, or runs a different timetable for every day of the week.
• Holiday calendar: Holidays cover a single date or an inclusive date range. Furthermore, a store observing a holiday today drops out of the customer’s search results automatically.
• Product availability per store: Assign products to the branches that stock them, working from either the store screen or the product edit screen. Variants inherit their parent product’s stores.
• Seller-owned stores: Marketplace sellers manage their own branches and holidays from the seller panel, and each seller sees only its own records.
• Distance-ranked storefront finder: Customers share their location or type coordinates, then receive the nearest branches first within a radius the admin controls.
• Optional Google map: With an API key configured, results plot on a map with markers and an info window per store. Without a key, the module simply omits the map.
• Store Pickup shipping method: Every branch in range becomes its own shipping option at checkout, complete with an optional fixed or percentage handling fee.
• Pickup order tracking: The chosen branch is recorded against the order and shown on both the customer’s order view and the admin order view.
• Multilingual: All 22 Bagisto locales ship with the module, covering admin, seller and storefront screens.

Bagisto Store Pickup Extension Configuration

All settings live in one place. Navigate to Configure → Store Locator → Settings → Store Pickup to reach them.

Core Bagisto Store Pickup Extension Settings

Status switches the whole module on or off. While it stays off, the admin menu, the shipping method and the storefront page all disappear, so this is the master toggle.

Title sets the carrier name shown to customers at checkout. Because it is locale based, each language can carry its own wording.

Method Name offers an alternative label for the individual rates. In addition, Use Method Name Instead of Title decides which of the two the checkout actually displays.

Handling Fee and Search Radius

Calculate Handling Fee chooses between a Fixed amount and a Percentage of the cart subtotal. Correspondingly, Handling Fee holds the number itself, and a value of zero means collection is free.

Search Radius (kilo-metres) limits how far the finder looks. Values run from 1 to 50, and the module falls back to 25 when the field is empty.

Storefront and Map Settings

Google Maps API Key enables the map on the finder. Notably, the key needs the Maps JavaScript API enabled with billing active; otherwise the module omits the map and keeps the store list working.

Show Pickup Stores Page exposes the /pickup-stores page together with its storefront header link.

Meanwhile, Displayed Error Message controls the wording customers read when no branch falls within range.

Enable Address Search adds address-based lookup to the finder.

Similarly, Ship to Allowed Countries and Ship to Applicable Countries restrict the carrier either to every allowed country or to a specific list you pick.

Finally, Enable Scheduling Emails and Order Scheduling Template govern the notification sent when a pickup order is scheduled.

Step-by-Step: Configuring Store Pickup

1. Open Configure from the admin sidebar.
2. Select Store Locator → Settings → Store Pickup.
3. Turn Status on.
4. Enter a Title, for example “Collect In Store”.
5. Pick a Calculate Handling Fee mode and type the Handling Fee.
6. Set the Search Radius (kilo-metres) between 1 and 50.
7. Paste a Google Maps API Key if you want the map.
8. Set Show Pickup Stores Page to Yes.
9. Click Save Configuration.

Bagisto Store Pickup Extension Admin View

Once enabled, the Bagisto store pickup extension adds a Store Pickup section inside the Marketplace menu. Three screens live there: Manage Store, Pickup Store Orders and Manage Holidays.

Manage Store in the Bagisto Store Pickup Extension

The store grid lists every branch on the marketplace, whether the admin created it or a seller did.

Columns cover the id, name, status, coordinates, contact person, owning seller and creation date, and each one supports searching, filtering and sorting.

Mass actions speed up bulk work. Therefore, an admin can delete several branches at once or flip a batch of them between Enabled and Disabled without opening each record.

Step-by-Step: Creating a Pickup Store

1. Go to Marketplace → Store Pickup → Manage Store.
2. Click Create New Stores.
3. Enter the Store Name and set Status to Enabled.
4. Fill in Latitude and Longitude, because the finder ranks branches from these values.
5. Choose how the branch opens: around the clock, one shared timetable, or a different timetable per day.
6. Add the contact person, phone, email and postal address.
7. Tick any Holidays the branch observes.
8. Click Save Store.

Editing works the same way. However, the edit screen adds a Manage Products button that jumps straight to the branch’s catalogue.

Assigning Products to a Store

Not every branch stocks every product. Accordingly, the module keeps a product list per store, reachable from the grid’s product icon or the edit screen’s Manage Products button.

The assignment screen shows only products the branch does not already carry. In addition, variants never appear on their own, since they inherit whichever stores their parent product belongs to.

Step-by-Step: Assigning Products

1. Open Marketplace → Store Pickup → Manage Store.
2. Click the product icon on the branch you want, or open it and press Manage Products.
3. Press Assign Products.
4. Tick every product the branch stocks.
5. Run the Assign mass action.
6. Return to the product list to confirm the new rows, and use the delete icon to detach anything added by mistake.

Pickup Stores on the Product Screen

The same relationship works from the other direction.

Consequently, the product edit screen carries a Pickup Stores panel listing every branch that stocks the product, with links to edit or detach each one.

Step-by-Step: Adding Stores From a Product

1. Open Catalog → Products and edit any product.
2. Scroll to the Pickup Stores panel.
3. Click Assign Stores.
4. Select the branches that stock this product and confirm.
5. Use the delete icon beside a branch to remove the product from it.

Manage Holidays

Holidays close branches on dates when nobody can hand an order over. Each record carries a name, a status, a date type and its dates.

Two date types exist. A Single holiday closes a branch for one day, whereas a Range holiday covers an inclusive span such as a week-long refit.

Step-by-Step: Creating a Holiday

1. Go to Marketplace → Store Pickup → Manage Holidays.
2. Click Create Holiday.
3. Enter a Holiday Name and set Status to Enabled.
4. Choose Date Type: Single for one day, Range for a span.
5. Pick Date From, then Date To when the type is Range.
6. Click Save Holiday.
7. Open any store and tick the new holiday to apply it.

The effect reaches the storefront immediately. As a result, a branch observing an enabled holiday today never appears in a customer’s search, so nobody travels to a closed shop.

Pickup Store Orders

Every order placed for collection lands in a dedicated grid. Columns show the order id, customer, branch, subtotal, grand total, status, channel and date.

Opening an order reveals the collection details.

Specifically, a pickup panel names the branch and shows its address, contact details and opening hours, so staff know exactly where the customer is heading.

Step-by-Step: Reviewing a Pickup Order

1. Open Marketplace → Store Pickup → Pickup Store Orders.
2. Filter by Status or Stores to narrow the list.
3. Click the view icon on the order you need.
4. Find the pickup panel beside the shipping method.
5. Open the information icon to read the branch address, contact and opening hours.

Order history survives store deletion. If a branch is removed later, the panel falls back to the description frozen onto the order at checkout instead of showing nothing.

Bagisto Store Pickup Extension Seller View

Sellers get their own copy of the same tools. A Store Pickup section appears in the seller panel with two entries, Manage Store and Manage Holidays.

Seller Manage Store

Each seller sees only the branches it owns. Moreover, opening a record belonging to another seller returns a 404, so the panel keeps vendors properly separated.

The create and edit forms mirror the admin versions. Meanwhile, ownership is stamped automatically, so a seller never picks who a branch belongs to.

Step-by-Step: A Seller Adds a Branch

1. Sign in to the seller panel.
2. Open Store Pickup → Manage Store.
3. Click Create New Stores.
4. Enter the name, status, coordinates and opening hours.
5. Add the contact person and address.
6. Tick any of your own holidays that the branch observes.
7. Click Save Store.

Seller Manage Holidays

Sellers keep a private holiday calendar too. Notably, a seller can attach only its own holidays to its own branches, which stops one vendor’s closure from touching another’s.

Step-by-Step: A Seller Adds a Holiday

1. Open Store Pickup → Manage Holidays in the seller panel.
2. Click Create Holiday.
3. Name the holiday and choose Single or Range.
4. Pick the dates and save.
5. Edit one of your branches and tick the holiday to apply it.

Bagisto Store Pickup Extension Customer View

Customers meet the module in two places: the finder and the checkout. Both work without an account.

Finding a Pickup Store with the Bagisto Store Pickup Extension

A Pickup Stores link sits in the storefront header once the page is switched on.

The finder then offers two ways to search: automatic detection through the browser, or manual latitude and longitude entry.

Results arrive ranked by real distance. Each card names the branch, prints its full address, states how many kilometres away it sits and links out to driving directions.

Admin-owned and seller-owned branches appear side by side. Therefore, a shopper simply sees the nearest options and never needs to think about who runs each one.

Step-by-Step: Finding the Nearest Store

1. Click Pickup Stores in the storefront header.
2. Press Automatically Find & Set Your Location and allow the browser prompt.
3. Alternatively, type a Latitude and Longitude and press Find Stores.
4. Read the results, which arrive nearest first.
5. Follow Get directions to open the route in Google Maps.
6. Press Clear to forget the saved location.

Choosing Store Pickup at Checkout

Collection appears as a normal shipping choice.

After a customer searches once, every branch within the configured radius shows up as its own shipping method, each labelled with the branch name, address and distance.

Handling fees follow the configuration. For example, a fixed fee applies once per order, while a percentage fee is taken from the cart subtotal.

After the order is placed, the chosen branch is recorded against it.

Subsequently, the customer sees the collection point on their own order view, and the admin sees the same details in the panel described earlier.

Step-by-Step: Ordering for Collection

1. Add products to the cart and start checkout.
2. Enter the billing and shipping address as usual.
3. At the shipping step, look for the pickup rates, one per nearby branch.
4. Select the branch you want to collect from.
5. Choose a payment method and place the order.
6. Open My Account → Orders to see the collection point on the order.

Conclusion

The Bagisto store pickup extension adds a complete click-and-collect workflow to a multi-vendor store.

Admins and sellers publish branches, holidays keep closed shops out of search results, and product assignment tells shoppers which branch actually stocks what they want.

Customers get the part that matters most: a finder that ranks branches by real distance, and a checkout where picking one takes a single click.

Consequently, the store saves on shipping while shoppers save on waiting.

For technical details on extending the module, browse the Bagisto developer documentation. For help with your installation, meanwhile, raise a thread on the Bagisto forums.