Recipe: Storefront and vendor screens

Shopper-facing screens

Assign these content classes where shoppers browse the marketplace:

Content type Class key Notes
WC PV – Storefront mam_wc_pv_storefront One vendor’s storefront, menu-lane layout; per-vendor colors are cloned from the Master Vendor at approval
WC PV – Storefront Home mam_wc_pv_storefront_home Home-screen storefront button
WC PV – All Sellers for Storefront pv_offdirectory_all_sellers Seller browser (off-directory layout)
WP PV – All Stores List mam_pv_all_stores Store list
WC PV – Product Vendors List WooCommerceProductVendors Vendor directory
WC PV – All Products for Product Vendors WooCommerceProductVendorsAll Cross-vendor product list
WC PV – All Products for a Single Product Vendor WooCommerceProductVendorProducts One vendor’s catalog
WC PV – Peer to Peer marketplace mam_wc_peer_to_peer_marketplace P2P listing layout

Relevant settings (Mobile App Manager → Product Vendors → Settings):

  • Master Vendor (mam_wc_pv_master_vendor) — the vendor whose storefront colors are cloned to newly approved vendors.
  • Sort store locations by Distance? (mam_pv_sort_by_distance) — distance-sort store lists using the device location.
  • Show seller profile on receipt / order detail (mam_pv_show_seller_profile_on_receipt, mam_pv_show_seller_profile_on_order_detail).
  • Vendor Shop URL Base (mam_wc_pv_vendor_url_base) — path segment for vendor shop links on the admin approval forms (site.com/<base>/<slug>, blank = vendor).

Seller-facing screens

Content type Class key Notes
WC PV – Vendor Products mam_wc_pv_vendor_products The acting vendor’s catalog with edit actions
WP PV – Open Orders mam_pv_open_orders Open orders for the acting vendor
WC PV – All Orders mam_pv_all_orders Full order history
WC PV – Earnings wc_pv_earnings Earnings report (colors/blocks via earnings_report_* settings)
WP PV – Profile mam_pv_profile Vendor profile editor
WC PV – Staff Manager mam_pv_staff_manager See Recipe: Staff manager configuration
WC PV – Admin Open Orders / Admin PV Manager mam_pv_admin_pv_open_orders / mam_pv_admin_pv_manager Store-manager-only screens

Seller screens resolve the acting user from the app token and check vendor membership (mam_pv_check_user); a user on multiple vendors switches stores via their current-vendor selection.

  • Show Standard Home Screen View for Vendor Admin? (pv_home_screen_option) — show vendor admins the standard home screen instead of the seller dashboard.
  • Has time picker with groups? (mam_pv_has_time_picker_with_groups) — grouped time-picker layout on order forms.
  • Enable QR Codes? (mam_pv_enable_qr_codes) — gives each vendor a Store QR Code page in wp-admin that deep-links to their store.

Product forms

Map the Add / Edit Product Form (mam_wc_pv_edit_listing) and, optionally, the availability form (mam_pv_mam_pv_availability_form) in the form settings. Product category/tag fields auto-populate from product_cat / product_tag. Add extra product fields (mapped to post meta) on the Product Fields tab (mam-wc-pv-add-edit-product-fields) — they appear in the app form automatically via the mam_wc_pv_edit_listing_fields filter. Product writes are ownership-checked (mam_wc_pv_user_can_manage_product).

Locations, hours, and geofilters

Vendors maintain locations (pv-location posts: street/city/state/zip, open days and hours, tax rates, order rules) through the add-location form (mam_pv_mam_pv_add_location_form). Locations are geocoded with the suite Google API key (tsl-google-api-key).

  • Locations drive pickup/delivery choices at checkout (with mam-woocommerce-delivery, which pulls them through the mam_wc_pv_locations_for_vendor filter) and the day-of-week date filters in the app.
  • Checkout Has Pickup Delivery Options (checkout_has_pickup_delivery_options) enables the location/date/time selector at checkout.
  • Calendar invites attached to order emails use each location’s timezone when available; otherwise the Fallback Timezone for Order Calendar Invites setting applies (blank = America/Los_Angeles).

  • Plugin: mam-woocommerce-product-vendors
  • Recipe: Vendor onboarding and registration
  • Recipe: Commissions, settlement, and payouts
  • Hook: mam_wc_pv_locations_for_vendor

Metadata

Field Value
Article type Recipe
Plugin slug mam-woocommerce-product-vendors
Applies to plugin version 26.19.1+
Category Building Your App
Audience Site admin, app builder
Last verified 2026-06-10
Contents

    Need Support?

    Can't find the answer you're looking for? Don't worry we're here to help!