Prerequisites

Before you begin, make sure:

• WordPress and WooCommerce are installed and activated
  
• Multi Store Addons for WooCommerce is installed and configured
  
• WePOS plugin is installed
  
• You have administrator access to WordPress

Step-by-Step Guide

Step 1: Enable the “WePOS Integration” Option on Multi Store Addons for WooCommerce

The first thing you will need to do is to enable the “WePOS Integration” option in Multi Store Addons for WooCommerce. To do this, please follow the steps below:

1. From the WordPress dashboard, go to the “A Store Locator” plugin and click on the “WooCommerce” tab
2. Go to the Inventory tab
   
3. Enable the “WePOS integration” option
   

Step 2: Install the WePOS Plugin

1. Log in to your WordPress Admin Dashboard
2. Navigate to Plugins → Add New
3. Search for WePOS
   
   
4. Click Install Now, then Activate
5. Once activated, you will see WePOS in the WordPress menu

WePOS enables point-of-sale functionality directly inside WooCommerce.

Step 3: Add An Outlet on WePOS

1. Go to WePOS → Outlets
2. Click on “Add Outlet”, fill in the information, and click on “Create Outlet”
   

Step 4: Assign a Counter and Cashier to Your Outlet

1. Next to the newly created outlet, click on the three-dot menu button, and click on “Add Counter”
2. Enter the counter name and number, and click on “Add Counter”
3. Next, click on the three-dot menu button, and click on “Add Cashier”
4. Select a Cashier and click on “Assign Cashier”
   
   

Now, a counter and cashier are assigned to the outlet you just created.

Counters represent physical POS terminals, while cashiers are the users operating them.

Step 5: Link a store with WePOS

The next step is to link one of your stores with WePOS. To do this, please follow the steps below:

1. Go to the WordPress dashboard, navigate to the Agile Store Locator plugin, and click on “Manage Stores”
2. Locate the store you want to link to WePOS and click on the “edit” icon
   
3. Go to the WooCommerce tab
4. Assign an outlet to this store using the “WePOS Outlet” field
5. Click on “Update Store”
   

Once this is done, the WePOS outlet will be linked to the store you assigned it to.

Now you can go to the POS interface and manage the products that are assigned to this store.

Step 6: Go to View POS

1. Navigate to WePOS → View POS
   
   
2. Log in using the outlet and counter credentials you created earlier
   
   

This will open the WePOS interface, where sales transactions are processed.

This step ensures that sales, stock, and pricing data sync correctly with the chosen outlet.

Step 7: Change Product Prices and Stock via CentralStock

1. Go to A Store Locator Plugin → Central Stock
   
2. Locate the product you want to change the price and/or inventory for
3. Click on “update” next to the correct store location
   
4. Update:
   
   • Product prices
   • Stock quantities
     
5. Click on “Update Inventory” to save the changes
   
   

Once you make changes to the product price and inventory, all updates will automatically reflect in:

• WePOS
• WooCommerce product listings
• Assigned store/outlet inventory

Result

After completing the above steps:

• WePOS is fully linked with Multi-Store Addons for WooCommerce
  
• Product prices and stock are managed from one central location (Central Stock Section)
  
• POS transactions update inventory in real time across all outlets

Order Summary

Once you complete a transaction using WePOS, you can view the transaction details by following the steps below:

1. Go to the WordPress dashboard
2. Head over to the WooCommerce plugin, and click on “Orders”
3. Open the latest transaction and view the transaction details
   

Video

For a more detailed demo on how to link WePOS with Multi Store addons for WooCommerce, and how to update product prices and stock using the central stock section, please see the video below.

What Are You Renewing?

Yearly License Renewal

With a Yearly License, your license and support are valid for one year. After expiry:

• You lose access to updates and support.
• Renewing restores both.

How to Renew:

1. Log in to your AgileLogix account.
2. Go to the All Downloads section.
3. Locate the expired license.
4. Click Renew and complete checkout.

Support Renewal for Lifetime License

Lifetime Licenses never expire, but support lasts 1 year. After that:

• You still receive plugin updates.
• You lose access to customer support unless renewed.

Renew Support for $30:

1. Log into AgileLogix.
2. Go to All Downloads.
3. Locate the Lifetime license with Support Expired.
4. Click Renew Support.
5. Complete checkout. Your support will extend 1 year.

How to Check Your Plan

From your AgileLogix account dashboard:

• License Type: “Lifetime” or “Yearly”
• Support Expiry: Shown below each license key

Lost Access to Your Account?

If you no longer have access to your AgileLogix account:

• You can purchase a new license directly from AgileLogix.com.
• After purchase, you can register the new license on your existing site using the plugin’s License Activation panel.

Your plugin and settings will remain intact — you’re simply linking it to a new license key.

Need Help?

Email us: support@agilelogix.com

We’re happy to assist with renewals and support questions!

Step 1: Add the Plugin to Cart

1. Visit the product page for Multi-Store Addons for WooCommerce:
   https://agilelogix.com/product/multi-store-addons-for-woocommerce/
2. Click on Add to Cart.
3. Go to the Checkout page.

Step 2: Enter Your Existing License Key

1. On the checkout page, look for the License Renewal field.
2. Paste your existing license key (the one you want to renew) into the field.

This ensures the new purchase will be treated as a renewal and extends your original license rather than generating a new one.

Step 3: Complete the Purchase

1. Fill in the billing information if required.
2. Click Purchase to complete the renewal process.

Step 4: Confirmation

Once the payment is completed:

• Your license will be extended for another year from the current expiration date.
• You will receive a confirmation email with the updated license details.

Need Help?

If you don’t have your license key or face any issues during renewal, feel free to contact us at support@agilelogix.com. We’ll be happy to assist you.

Step 1: Enable Inventory and Store Selector

To get started, you’ll need to enable the Inventory Module and the Store Selector Widget.

1. Navigate to: Agile Store Locator > WooCommerce > Inventory tab
2. Enable the Inventory Module toggle.
3. Under Store Selector Widget Type, choose Header Widget.
4. Click Save Settings.

This enables per-store pricing, stock handling, and the store selector frontend component.

Step 2: Add the Shortcode

Add the following shortcode to your site header (or wherever you want the selector to appear):

[asl_wc_selector]

By default, this renders a sidebar offcanvas selector powered by Bootstrap 5’s offcanvas system (custom-prefixed aslcanvas).

Optional: Show as Popup

You can render the selector as a modal-style popup instead of offcanvas using the popup attribute:

[asl_wc_selector popup="1"]

This adds a asl-selector-popup class, allowing you to style and position it differently.

Controlling Widget Visibility

By default, the selector widget is not shown on the cart or checkout pages. This behavior can be customized using a WordPress filter:

add_filter('asl_wc_skip_render_store_selector', function($default) {
    // Always show the selector (even on checkout/cart)
    return false;
});

This allows advanced users to programmatically control when the widget renders.

Customizing Radius and Result Count

You can control how many nearby stores are shown and within what radius by using filters in your theme’s functions.php file:

Store Radius (in miles or km)

add_filter('asl_wc_store_radius', function($radius) {
    return 100; // Set custom radius (default is 500)
});

Limit Number of Store Results

add_filter('asl_wc_store_result_limit', function($limit) {
    return 5; // Show max 5 nearby stores instead of default 10
});

These filters give developers control over the search behavior without modifying core plugin code.

How It Works

When a customer places an order, the system:

1. Identifies the store associated with the order.
2. Retrieves the store manager’s email address.
3. Sends an email notification containing order details, including:
   • Order ID
   • Customer details (name, email, phone, address)
   • Order total and payment details
   • Selected shipping method
   • Ordered products with quantities and prices
4. Prevents duplicate emails by marking the order as notified in the system.

Customizing the Email Template

If required, you can customize the store manager notification email template to match your business requirements. To do so:

1. Use a WooCommerce-compatible email customizer plugin, such as:
   • Email Customizer for WooCommerce – A powerful tool that allows you to design WooCommerce emails using a drag-and-drop interface.
   • Kadence WooCommerce Email Designer – A free plugin that provides a simple way to customize WooCommerce emails with a live preview.
   • YayMail – WooCommerce Email Customizer – Offers an intuitive builder with various customization options and integration support.
2. Install and activate the email customizer plugin of your choice.
3. Navigate to the WooCommerce > Emails section in your WordPress dashboard.
4. Locate the Store Manager Notification email and click Customize.
5. Modify the email template using the drag-and-drop builder or available settings:
   • Change the layout, fonts, and colors.
   • Modify text content, headers, and footers.
   • Add dynamic elements such as order details, customer information, or store branding.
6. Save your changes, and the system will use your customized email format.

Advanced Customization (For Developers)

For more advanced modifications, developers can manually edit the template files:

1. Locate the template files under:
   • asl-wc/includes/modules/email-notification/templates/emails/store-manager-email.php (HTML template)
   • asl-wc/includes/modules/email-notification/templates/emails/plain/store-manager-email.php (Plain text template)
2. Copy the template file to your theme folder to prevent overwrites during updates:
   • yourtheme/woocommerce/emails/store-manager-email.php
3. Edit the copied file and modify the email content as needed.
4. Save the changes, and WooCommerce will now use your customized email template.

Content of the Store Owner Email Template

The content of the email can be copied from here as well, instead of locating that in that modules directory.

<?php
/**
 * Store Manager Order Notification Email Template
 *
 * This template will be injected into the default WooCommerce email template.
 */

if (!defined('ABSPATH')) {
    exit;
}


/*
 * @hooked WC_Emails::email_header() Output the email header
 */
do_action( 'woocommerce_email_header', $email_heading, $email ); 

// Decode the JSON-encoded products array from placeholders
$products = isset($products) ? json_decode($products, true) : [];

?>

<p><?php printf(__('Dear %s,', 'asl-wc'), esc_html($store_title)); ?></p>

<p><?php _e('You have received a new order:', 'asl-wc'); ?></p>

<p><strong><?php _e('Order ID:', 'asl-wc'); ?></strong> #<?php echo esc_html($order_id); ?></p>
<p><strong><?php _e('Total Amount:', 'asl-wc'); ?></strong> <?php echo wp_kses_post($order_total); ?></p>

<!-- Customer Details -->
<h3><?php _e('Customer Details:', 'asl-wc'); ?></h3>
<p><strong><?php _e('Name:', 'asl-wc'); ?></strong> <?php echo esc_html($customer_name); ?></p>
<p><strong><?php _e('Email:', 'asl-wc'); ?></strong> <?php echo esc_html($customer_email); ?></p>
<p><strong><?php _e('Phone:', 'asl-wc'); ?></strong> <?php echo esc_html($customer_phone); ?></p>
<p><strong><?php _e('Address:', 'asl-wc'); ?></strong> <?php echo esc_html($customer_address); ?></p>

<!-- Shipping Details -->
<h3><?php _e('Shipping Details:', 'asl-wc'); ?></h3>
<p><strong><?php _e('Shipping Method:', 'asl-wc'); ?></strong> <?php echo esc_html($shipping_method); ?></p>
<p><strong><?php _e('Shipping Cost:', 'asl-wc'); ?></strong> <?php echo wp_kses_post($shipping_cost); ?></p>

<!-- Order Date -->
<h3><?php _e('Order Date:', 'asl-wc'); ?></h3>
<p><?php echo esc_html($order_date); ?></p>

<!-- Customer Notes -->
<?php if (!empty($customer_note)) : ?>
    <h3><?php _e('Customer Notes:', 'asl-wc'); ?></h3>
    <p><?php echo wp_kses_post($customer_note); ?></p>
<?php endif; ?>

<!-- Delivery Time for Local Pickup -->
<?php if ($shipping_method_id == 'local_pickup' && !empty($delivery_time)) : ?>
    <h3><?php _e('Delivery Time:', 'asl-wc'); ?></h3>
    <p><?php echo esc_html($delivery_time); ?></p>
<?php endif; ?>

<!-- Ordered Products Table -->
<h3><?php _e('Ordered Products:', 'asl-wc'); ?></h3>
<table style="width: 100%; border-collapse: collapse; border: 1px solid #ddd;">
    <thead>
        <tr>
            <th style="border: 1px solid #ddd; padding: 8px;"><?php _e('Product', 'asl-wc'); ?></th>
            <th style="border: 1px solid #ddd; padding: 8px;"><?php _e('Quantity', 'asl-wc'); ?></th>
            <th style="border: 1px solid #ddd; padding: 8px;"><?php _e('Price', 'asl-wc'); ?></th>
            <th style="border: 1px solid #ddd; padding: 8px;"><?php _e('Subtotal', 'asl-wc'); ?></th>
        </tr>
    </thead>
    <tbody>
        <?php foreach ($products as $product) : ?>
            <tr>
                <td style="border: 1px solid #ddd; padding: 8px;">
                    <a href="<?php echo esc_url($product['url']); ?>">
                        <?php echo esc_html($product['name']); ?>
                    </a>
                </td>
                <td style="border: 1px solid #ddd; padding: 8px;"> <?php echo esc_html($product['qty']); ?> </td>
                <td style="border: 1px solid #ddd; padding: 8px;"> <?php echo wp_kses_post($product['price']); ?> </td>
                <td style="border: 1px solid #ddd; padding: 8px;"> <?php echo wp_kses_post($product['subtotal']); ?> </td>
            </tr>
        <?php endforeach; ?>
    </tbody>
</table>
<?php

/*
 * @hooked WC_Emails::email_footer() Output the email footer
 */
do_action( 'woocommerce_email_footer', $email );

?>

How to Enable Billing Fields for Local Pickup

To enable the Billing Fields for Local Pickup, follow these steps:

1. Navigate to Store Locator > WooCommerce in your WordPress dashboard.
2. Click on the Local Pickup tab.
3. Locate the setting “Show Billing Fields”.
4. Toggle the switch to Enable.
5. Save the settings.

Once enabled, the checkout process will display the standard Billing Fields, even for Local Pickup orders.

Placing a product on backorder will allow your customers to order that product even though it is out of stock.

To label products as “on backorder” please follow the below steps.

Prerequisites

Before we begin, please be sure to have the following prerequisite options enabled on Multi store Addons for WooCommerce:

1. On the “Global” tab, make sure the “Store Visibility” option is set to “Product Stores”
   
2. On the “Products” tab, make sure the “Stock Management” option is set to “Location”
   

These two prerequisites are required to mark out-of-stock products as “on backorder”.

Step 1 – Place a product on Backorder

1. Log in to your WordPress account
2. Go to the “products” tab on WooCommerce, and click on “All Products”
3. Select a product and click on the “Edit” button
   
4. On the “Edit Product” page, scroll down to the inventory tab, and click on the “track stock quantity for this product”
5. On the “Allow Backorders” option, select the “Allow, but notify customer” option
   

Step 2 – Set the Product Stock to Zero for a Location

1. Next, go to the “Locations” tab
2. Activate a location by clicking on the “Edit” button
   
3. Set the stock as “0” and click on “Save”
   
4. Now the product in the above location will be labeled as “on backorder” on the product page of your online store
5. Note: only locations that are marked “Active”, have a stock of “0” and stock status as “In” will be labeled as “on backorder”
6. Click on the “Update” button to save your changes

Step 3 – Activate Backorder on Multi Store Addons for WooCommerce

1. Go to the Agile Store Locator plugin (A store locator) on your WordPress dashboard, and select the “WooCommerce” tab to access the Multi Store Addons for WooCommerce plugin
2. On the “Global” tab, activate the “Enable Stores with Zero Stock” option
   
3. Click on “Save Settings”

Now, go to your website and go to a product page.

The location(s) with “0” stock will now be labeled as “on backorder”. Furthermore, any products that are ordered while on backorder will be marked as “on backorder”.

When the store selection widget is added to the checkout page, your customers will be able to select a store from where they want their items to be delivered. 

How to Enable the Store Selection Widget on the Checkout Page

To add a store selection widget to your checkout page, please follow the below steps:

1. Log into your WordPress account
2. Go to the “A Store Locator” plugin, and select the “WooCommerce” sub-tab
   
3. Head over to the “Products” tab and disable the “Product Page Widget” option, this will remove the store selection widget from product pages and place it on the checkout page
   
4. Click on “Save Settings”
5. Go back to the “Global” tab, and make a selection on the “Checkout Widget” option

Depending on your selection on the “Checkout Widget” option, the store selection widget can be in one of two forms:

1. Store locator –  The store is selected via a store locator widget that shows all your stores on a map, and it also shows a list of all your stores
2. Select Dropdown – The store is selected through a dropdown menu that appears on the checkout page

Let’s go over both these options

“Store Locator” Store Selection Widget

Choosing the “Store Locator” on the “Checkout Widget” option will add a fully functioning store locator widget to the checkout page.

The store locator widget will show all your stores on a map, and it will also display a list of all your store.

Your customers will be able to choose a store by either clicking on a location on the map or by using the store list.

Having a store locator at the checkout page is an excellent way to provide your customers with a visual display of which of your stores are closest to their current location.

“Select Dropdown Store” Selection Widget

Choosing the “Store Dropdown” option on the “Checkout Widget” option will add a dropdown menu on the checkout page.

Your customers will be able to make a store selection using this dropdown menu before placing their order.

This option is very useful if you want your customers to actively define a store from where they want their order to be delivered from.

Store Selection Widget on The Product Page

If you place the store selection widget on individual product pages, then the “Mandatory Store Selection” option will prevent customers from adding a product to the cart until they select a store from the store selector widget.

To enable the above scenario, please follow the below steps:

1. Log into your WordPress account
2. Go to the “A Store Locator” plugin tab and select the “WooCommerce” sub-tab
   
3. Go to the “Products” tab, enable the “Product Page Widget” option, and click on “Save Settings”
4. The store selection widget will now be enabled on individual product pages
   
5. Go to the “Global” tab, and enable the “Mandatory Store Selection” option
   

Now your customers will only be able to add a product to their cart after they select a store from the store selector widget.

Feature Overview

When using both WooCommerce Print Address Labels and Multi-Store Addons for WooCommerce, you may want to include store details (such as store name, address, phone, etc.) in the printed address labels. This can be achieved by using dynamic placeholders like [asl_title], [asl_city], [asl_phone], which automatically pull information from the Multi-Store Addons for WooCommerce plugin and insert it into the printed label.

How It Works

• The placeholders in the address label template (e.g., [asl_title], [asl_city]) are dynamically replaced with the corresponding data from the store assigned to the order.
• If the store associated with the order contains a particular piece of information (like the store’s title or phone number), the placeholders are replaced with the actual data.
• This process is fully dynamic, allowing you to add custom store information to any WooCommerce address label.

Usage Instructions

To add store-specific information to your address labels, follow these steps:

Add the following code to your theme’s functions.php file:

add_filter('wpo_wclabel_address_format', 'custom_wpo_wclabel_address_format', 10, 2);

/**
 * Customize the address format for WooCommerce address labels.
 *
 * @param string $custom_address_format The original address format.
 * @param object $order The WooCommerce order object.
 * @return string The modified address format.
 */
function custom_wpo_wclabel_address_format($custom_address_format, $order) {
   
    // Get the store ID from the order meta (assigned by Multi-Store Addons for WooCommerce)
    $asl_wc_store_id = $order->get_meta('asl-wc_store_id');

    // When the store ID exists
    if ($asl_wc_store_id) {

        // Check if the Agile Store Locator helper method exists
        if (method_exists("\AgileStoreLocator\Helper", 'get_store')) {

            // Get the store object based on the store ID
            $a_store = \AgileStoreLocator\Helper::get_store($asl_wc_store_id);	
                
            // If the store exists
            if ($a_store) {

                // Match all placeholders that start with [asl_ and end with ]
                preg_match_all('/\[asl_(.*?)\]/', $custom_address_format, $matches);

                // Loop through the matches and replace the placeholders with store data
                foreach ($matches[0] as $key => $placeholder) {
                    // Extract the property name (e.g., 'title', 'city', etc.)
                    $property = $matches[1][$key];

                    // Check if the property exists in the store object
                    if (isset($a_store->$property)) {
                        // Replace the placeholder with the corresponding store property value
                        $custom_address_format = str_replace($placeholder, $a_store->$property, $custom_address_format);
                    } else {
                        // Optionally, remove the placeholder if the property doesn't exist
                        $custom_address_format = str_replace($placeholder, '', $custom_address_format);
                    }
                }
            }
        }
    }

    // Return the modified address format with replaced placeholders
    return $custom_address_format;
}

Customize the Address Format in Your Print Labels:

Now that the code is in place, you can use placeholders like the following in the address format of your WooCommerce Print Address Labels plugin:

• [asl_title]: Displays the title of the store.
• [asl_street]: Displays the street address of the store.
• [asl_city]: Displays the city of the store.
• [asl_state]: Displays the state of the store.
• [asl_phone]: Displays the store’s phone number.
• [asl_email]: Displays the store’s email address.

Result: When printing the address labels, the placeholders such as [asl_title] and [asl_city] will automatically be replaced with the actual store details related to the order.

Example:

If the store information for a particular order is as follows:

• Store Name: “Downtown Store”
• Street: “123 Main St.”
• City: “New York”
• State: “NY”
• Phone: “(555) 123-4567”
• Email: “store@example.com“

Then the address label might look like this:

Order #12345
John Doe
Downtown Store
123 Main St.
New York, NY
(555) 123-4567
store@example.com