=== Stak Multivendor ===
Contributors: esiritoneh, stakng
Tags: woocommerce, multivendor, marketplace, auctions, buy now
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build a WooCommerce marketplace where vendors can list products, run auctions, and manage listings from the frontend.

== Description ==

Stak Multivendor adds multivendor marketplace and auction capabilities to WooCommerce.
Requires WooCommerce to be installed and active.

Stak Multivendor turns WooCommerce into a vendor-friendly marketplace with built-in auction capability.
Vendors can apply, get approved, create listings from the frontend, manage inventory, and sell using auction or buy-now flows.

Designed for real stores, Stak Multivendor includes vendor operations, buyer-facing browsing tools, escrow baseline controls, and optional live shipping integrations.

== Features ==

- Vendor applications and approval workflow
- Vendor access control and vendor role tools
- Frontend vendor dashboard with profile, listings, and stats
- Frontend listing creation and editing (no wp-admin required for vendors)
- Auction listing support with bidding flow and buy-now modes
- Buy now only, auction only, and auction + buy now listing modes
- Public browse listings page with filters, pagination, and AJAX updates
- Public vendor profile pages
- Buyer-to-vendor rating system
- Escrow baseline workflow with admin approval/refund actions
- Shipping modes: calculated, flat, free, and pickup-only
- Optional live shipping quotes via EasyPost or Shippo
- Admin settings for general, form fields, bidding, integrations, API, and appearance
- REST API endpoints for headless/mobile integrations
- Sample data import tools for faster setup

== Why Store Owners Use Stak Multivendor ==

- Launch a multivendor marketplace without stitching together many plugins
- Give vendors a cleaner frontend workflow for daily operations
- Support auction-style commerce and fixed-price selling in one system
- Keep operational control with admin management tabs and workflow settings

== Pro Features Add-on (Optional) ==

Stak Multivendor is fully usable as a free plugin. If you need advanced marketplace automation and vendor finance workflows, you can add the Pro Features extension.

= What Pro Features adds =

- Advanced bidding automation: Auto-Bid, Anti-Sniping, Reserve Price, Offers
- Buyer retention tools: Saved Search Alerts
- Vendor operations: Wallet Ledger, Withdrawals, Messaging, Watchlist, Tickets
- Marketplace controls: Vendor Analytics, Escrow Automation, Auto-Approval, Role Manager
- Extended integrations: Pro REST API endpoints for advanced app flows

= Get Pro Features =

https://stak.ng/multivendor

== External Services ==

This plugin can optionally connect to third-party shipping services when an admin enables live shipping and provides API credentials:

* EasyPost API (`https://api.easypost.com/v2/shipments`)
* Shippo API (`https://api.goshippo.com/shipments/`)

When enabled, shipping quote requests send destination/shipping address fields and parcel dimensions/weight required to calculate rates at checkout.
No shipping API requests are made unless the feature is enabled by the site administrator.

Service terms and privacy policies:

* EasyPost Terms: https://www.easypost.com/terms
* EasyPost Privacy: https://www.easypost.com/privacy
* Shippo Terms: https://goshippo.com/terms/
* Shippo Privacy: https://goshippo.com/privacy/

== Privacy ==

Stak Multivendor does not include built-in telemetry or usage tracking.
Plugin data is stored on your WordPress/WooCommerce site database.
If live shipping is enabled, shipping quote data is sent to the selected shipping provider as described above.

== Third-Party Libraries ==

This plugin bundles MIT-licensed libraries:

- SortableJS (1.15.7)
- Cropper.js (2.1.1)

License attributions and upstream references are provided in `THIRD-PARTY-LICENSES.txt`.
Full license texts are included in the `licenses/` directory.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin through the WordPress admin.
3. Make sure WooCommerce is installed and active.
4. Configure pages and settings in the plugin admin tabs.
5. Start onboarding vendors and publishing listings.

== Frequently Asked Questions ==

= Is WooCommerce required? =

Yes. Stak Multivendor extends WooCommerce and requires it to be installed and active.

= Can vendors create listings from the frontend? =

Yes. Vendors can manage listings and profile details without needing wp-admin access.

= Does this plugin support auctions and buy-now listings? =

Yes. You can run auction-only, buy-now-only, or combined listing modes.

= Is live shipping required? =

No. Live shipping is optional and only used if enabled by the site administrator.

= Is the free plugin usable without Pro Features? =

Yes. The free plugin is fully functional on its own. Pro Features is optional.

= Where can I get Pro Features? =

Get Pro Features: https://stak.ng/multivendor

== Changelog ==

= 0.1.0 =
* Initial release.
